# @blazingagents/sdk 中文文档

规范地址：https://npmcn.com/package/%40blazingagents/sdk/

版本：0\.47\.0
npm 元数据更新时间：2026-11-08T00:38:46.343Z
中文译文更新时间：2026-11-08T06:30:38.465Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40blazingagents/sdk
原文对照：https://npmcn.com/package/%40blazingagents/sdk/?lang=original
项目主页：https://docs.blazingagents.com/
源码仓库：https://github.com/blazingagents/typescript-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：518 kB，109 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：1 个
- peer 依赖：ai ^7\.0\.84，zod ^4\.5\.4
- 首次发布：2026-09-01T00:32:23.186Z
- 最新版本发布：2026-11-08T00:38:45.973Z
- 近 30 天下载量：4673（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：56（近 12 个月 56 个）

## 中文简介

用于爆破代理 API 的 SDK 脚本

## 安装

```sh
npm install @blazingagents/sdk
```

也可以使用：`pnpm add @blazingagents/sdk`、`yarn add @blazingagents/sdk`、`bun add @blazingagents/sdk`

## README

[![Blazing Agents logo](https://raw.githubusercontent.com/blazingagents/docs/main/public/brand/icon.svg)](https://docs.blazingagents.com/)

# 发亮代理类型SDK

以打入的 TypeScript 客户端为 Blazing Agents API 构建生产代理.

[文档](https://docs.blazingagents.com/sdk/typescript) • 妇女 [无](https://www.npmjs.com/package/@blazingagents/sdk)

官方 TypeScript SDK 是"爆破特工"的客户端 `/v1` API 这个 您的后端用于管理代理, 并为用户运行 。 这需要 节点.js 24或更新.

## 特征

-   输入方法 `/v1` 操作 API 密钥可调用: Agents, 技能、会话、回忆、提示、任务、工作空间、艺术、, 供应商、MCP连接、聊天连接、使用、支出限额、租户 设置和商家货币化.
-   以 AI SDK UI 消息流格式聊天流, 有方向盘、 工具 批准,以及运行在您进程中的后端功能.
-   文字与结构对象生成.
-   最终用户范围界定客户端 `forUser`。 。 。 .
-   Cursor pagination,上传和下载.
-   请求识别和输入出错 .
-   `BlazingAgentsChatTransport` 财务报告和审定财务报表 `createChatRelay` 连接 AI SDK `useChat` 转到你的后端.

## 安装

```console
npm install @blazingagents/sdk ai@^7.0.84 zod@^4.5.4
```

`ai` 财务报告和审定财务报表 `zod` 需要同伴依赖关系。 SDK再出口AI SDK 信件类型和Zod计划,所以你的应用程序和SDK各共享一份.

## 快开始

在爆破代理仪表盘中创建完整的 API 密钥并设定 `BLAZING_AGENTS_API_KEY` 在您的服务器环境中。 你的关键行为 整个房客,所以保持它 在你的后端,从来没有发送到浏览器.

```ts
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. 范围 客户端只到达最终用户的代理、会话和工作空间。 一个 未瞄准的代理在您的所有用户中共享一个工作空间, 所以给每个用户 本人的代理人:

```ts
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` 返回.

## 实例

这个 [实例存储器](https://github.com/blazingagents/examples) 已经 完整的 TypeScript 和 Python apps 创建于 Blazing Agents SDKs上.

## 文档

读取 [脚本 SDK 文档](https://docs.blazingagents.com/sdk/typescript) 客户端设置、最终用户范围界定、聊天和生成、每个用户的指南 资源,以及错误处理.

## 发展

```console
npm ci
npm run check
npm run test:consumer
```

见 [捐款额](https://npmcn.com/package/%40blazingagents/sdk/CONTRIBUTING.md) 更改日志公约及其 释放.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40blazingagents/sdk/LICENSE)

## 常见问题

### @blazingagents/sdk 是什么？

用于爆破代理 API 的 SDK 脚本

### 如何安装 @blazingagents/sdk？

在项目目录运行 npm install @blazingagents/sdk，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：ai（^7\.0\.84）、zod（^4\.5\.4）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @blazingagents/sdk 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @blazingagents/sdk 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @blazingagents/sdk 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @blazingagents/sdk 可以商用吗？

@blazingagents/sdk 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @blazingagents/sdk 的下载量有多少？

根据 npm 官方下载统计，@blazingagents/sdk 在 2026/10/09 – 2026/11/07 这 30 天内被下载 4,673 次，日均约 156 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @blazingagents/sdk 还在维护吗？

最新版本 0\.47\.0 发布于 2026/11/08（今天）；至今共发布 56 个版本，其中过去 12 个月发布了 56 个；首次发布于 2026/09/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。