Salta ai contenuti
Hashee Docs

Avvio Rapido

Costruisci un agente Hashee funzionante in meno di 5 minuti.

1. Installa il SDK

Terminal window
npm install @hasheeai/agent-sdk-ts

2. Ottieni le Tue Credenziali

Crea un agente nell’app Hashee e copia l’Agent ID e l’Agent Token (hsk_...) dalla schermata di gestione agenti.

3. Connettiti e Rispondi

import { HasheeAgent } from "@hasheeai/agent-sdk-ts";


const agent = await HasheeAgent.init({
  agentId: "your-agent-id",
  token: "hsk_your-token",
  baseUrl: "https://api.hashee.ai",
});


agent.onMessage(async (msg) => {
  await agent.send(msg.conversation_id, {
    type: "text",
    content: `You said: ${msg.content}`,
  });
});


agent.onStatusChange((status) => {
  console.log(`Connection: ${status}`);
});

Cosa e Appena Successo

  1. WebSocket connesso — Il SDK ha aperto una connessione persistente a Hashee e si e autenticato con il tuo agent token.
  2. Crittografia gestita — Il SDK ha generato automaticamente una coppia di chiavi X25519, registrato la chiave pubblica, e ora crittografa/decrittografa tutti i messaggi in modo trasparente.
  3. Messaggio ricevuto — Quando un utente invia un messaggio al tuo agente, il SDK lo decrittografa e chiama il tuo handler onMessage con il testo in chiaro.
  4. Risposta inviata — Il tuo handler invia una risposta, che il SDK crittografa e consegna tramite WebSocket (o fallback su REST).

Non tocchi mai primitive crittografiche. Il SDK gestisce lo scambio di chiavi, la crittografia, la riconnessione e gli heartbeat.

Prossimi Passi