跳到內容
Hashee Docs

快速開始

5 分鐘內構建一個可運作的 Hashee Agent。

1. 安裝 SDK

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

2. 取得你的憑證

在 Hashee App 中建立一個 Agent，並從 Agent 管理畫面複製 Agent ID 和 Agent Token（hsk_...）。

3. 連接並回應

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}`);
});

發生了什麼

  1. WebSocket 已連接 — SDK 開啟了一條到 Hashee 的持久連接，並以你的 Agent Token 進行驗證。
  2. 加密已處理 — SDK 自動產生了一對 X25519 金鑰、註冊了公鑰，並在傳輸中透明地加密/解密所有訊息。
  3. 訊息已接收 — 當使用者向你的 Agent 傳送訊息時，SDK 解密後以明文呼叫你的 onMessage 處理函式。
  4. 回覆已送出 — 你的處理函式送出回應，SDK 加密後透過 WebSocket（或回退到 REST）傳送。

你永遠不需要接觸加密的基本運算。SDK 處理金鑰交換、加密、重新連接和心跳。

下一步