官方 TypeScript SDK 是"爆破特工"的客户端 /v1 API 这个
您的后端用于管理代理, 并为用户运行 。 这需要
节点.js 24或更新.
特征
- 输入方法
/v1操作 API 密钥可调用: Agents, 技能、会话、回忆、提示、任务、工作空间、艺术、, 供应商、MCP连接、聊天连接、使用、支出限额、租户 设置和商家货币化. - 以 AI SDK UI 消息流格式聊天流, 有方向盘、 工具 批准,以及运行在您进程中的后端功能.
- 文字与结构对象生成.
- 最终用户范围界定客户端
forUser。 。 。 . - Cursor pagination,上传和下载.
- 请求识别和输入出错 .
BlazingAgentsChatTransport财务报告和审定财务报表createChatRelay连接 AI SDKuseChat转到你的后端.
安装
npm install @blazingagents/sdk ai@^7.0.84 zod@^4.5.4
ai 财务报告和审定财务报表 zod 需要同伴依赖关系。 SDK再出口AI SDK
信件类型和Zod计划,所以你的应用程序和SDK各共享一份.
快开始
在爆破代理仪表盘中创建完整的 API 密钥并设定
BLAZING_AGENTS_API_KEY 在您的服务器环境中。 你的关键行为
整个房客,所以保持它 在你的后端,从来没有发送到浏览器.
import { BlazingAgents } from "@blazingagents/sdk";
const client = new BlazingAgents({
apiKey: process.env.BLAZING_AGENTS_API_KEY!,
});
const result = await client.completion({
agentId: "ag_...",
prompt: "Write a friendly welcome message.",
});
console.log(await result.text);
替换 ag_... 带着仪表板上的特工身份.
对于用户的请求,请将客户端扩展至用户ID: 后端在登录时被验证,从不从请求机构到ID. 范围 客户端只到达最终用户的代理、会话和工作空间。 一个 未瞄准的代理在您的所有用户中共享一个工作空间, 所以给每个用户 本人的代理人:
export async function createAgentForUser(userId: string): Promise<string> {
const agent = await client.forUser(userId).agents.create({
name: "Assistant",
providerId: "prv_...",
model: "openai/gpt-6-luna",
});
return agent.id;
}
export async function chatAsUser(
userId: string,
agentId: string,
text: string
): Promise<Response> {
const chat = await client.forUser(userId).chat({
agentId,
message: {
id: crypto.randomUUID(),
role: "user",
parts: [{ type: "text", text }],
},
});
return chat.toResponse();
}
打电话 createAgentForUser 每个用户一次,然后与用户一起存储代理ID.
与没有范围创建的代理机进行范围化聊天失败 404。 。 。 .
chatAsUser 返回聊天作为流线 Response从
浏览器为 useChat,服务 createChatRelay 从您的后端和使用
BlazingAgentsChatTransport。中继范围为每个请求对用户
resolveContext 返回.
实例
这个 实例存储器 已经 完整的 TypeScript 和 Python apps 创建于 Blazing Agents SDKs上.
文档
读取 脚本 SDK 文档 客户端设置、最终用户范围界定、聊天和生成、每个用户的指南 资源,以及错误处理.
发展
npm ci
npm run check
npm run test:consumer
见 捐款额 更改日志公约及其 释放.