用途:通过 @polpo-ai/sdk 在任意 TypeScript/JavaScript 应用中集成 Polpo AI 智能体,实现智能体聊天、补全 API 等能力。
安装:npm install @polpo-ai/sdk
客户端初始化:使用 PolpoClient,baseUrl 为根 URL,SDK 内部会追加 /v1/,不要自行添加 /v1/ 或 /api/v1/。示例:new PolpoClient({ baseUrl: "https://api.polpo.sh", apiKey: process.env.POLPO_API_KEY }),本地开发可用 http://localhost:3890。
主要能力:
- 聊天补全:chatCompletion 非流式,chatCompletionStream 流式(SSE),可读取 chunk.choices[0]?.delta?.content。
- 会话:服务端自动创建会话,可用 sessionId 继续对话;支持 listChatSessions、getChatSessionMessages。
- 智能体:getAgents 列出,addAgent 创建(可设 name、role、model、allowedTools、systemPrompt),updateAgent 更新。
- 记忆:项目级记忆 getMemory/saveMemory(所有智能体共享),智能体级记忆 getAgentMemory/saveAgentMemory(单个智能体私有)。
- Webhook:registerWebhook 注册,支持事件如 task:*、mission:completed。
- SSE 实时事件:EventSourceManager 连接并监听,如 sse.connect({ filter: "task:*" })、sse.on("task:transition", ...)。
类型与端点参考:完整类型见 references/types.md,完整 API 端点列表见 references/api.md。
限制:资料未提供收费、价格、平台支持范围、速率限制及错误处理等细节,暂未提供。