跳转到内容
Hashee Docs

快速入门

5 分钟内构建一个可运行的 Hashee Agent。

1. 安装 SDK

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

2. 获取凭据

在 Hashee 应用中创建一个 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 处理密钥交换、加密、重连和心跳。

下一步