# @blaxel/langgraph 中文文档

规范地址：https://npmcn.com/package/%40blaxel/langgraph/

版本：0\.3\.36
npm 元数据更新时间：2026-11-09T18:22:28.975Z
中文译文更新时间：2026-11-09T18:23:20.087Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：874 kB，26 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：14 个
- 首次发布：2025-05-04T07:01:55.058Z
- 最新版本发布：2026-11-09T18:22:28.774Z
- 近 30 天下载量：4412（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：684（近 12 个月 338 个）

## 中文简介

用于类型脚本的 Blaxel SDK

## 安装

```sh
npm install @blaxel/langgraph
```

也可以使用：`pnpm add @blaxel/langgraph`、`yarn add @blaxel/langgraph`、`bun add @blaxel/langgraph`

## README

# 银河类型SDK

[银河](https://blaxel.ai/) 是一个永久的沙盒平台,它通过将无限安全的沙盒保留在自动备用状态来实现近瞬间潜伏状态,同时联合托管你的代理逻辑来切断网络上架.

这个软件包包含了为Blaxel的TypeScript SDK提供的帮助器功能,可以让你以LangChain/LangGraph所要求的格式检索模型客户端和MCP工具定义.

## 示例

```ts
import { blTools, blModel } from "@blaxel/langgraph";

const stream = await createReactAgent({
  llm: await blModel("sandbox-openai"),
  prompt: prompt,
  tools: [
    ...(await blTools(["blaxel-search", "webcrawl"])),
    tool(
      async (input: any) => {
        console.debug("TOOLCALLING: local weather", input);
        return `The weather in ${input.city} is sunny`;
      },
      {
        name: "weather",
        description: "Get the weather in a specific city",
        schema: z.object({
          city: z.string(),
        }),
      }
    ),
  ],
}).stream({
  messages: [new HumanMessage(process.argv[2])],
});
```

## 安装

```bash
# npm
npm install @blaxel/langgraph

# yarn
yarn add @blaxel/langgraph

# bun
bun add @blaxel/langgraph
```

## 认证

SDK使用这些源( 按优先级排序) 以您的 Blaxel 工作空间认证 :

1.  Blaxel CLI,登录时
2.  环境变量 `.env` 文件( 编号`BL_WORKSPACE`, (中文(简体) ), `BL_API_KEY`(中文(简体) )
3.  系统环境变量
4.  Blaxel 配置文件 (`~/.blaxel/config.yaml`(中文(简体) )

当本地开发时, 推荐的方法只是登录您的工作空间 :

```bash
bl login YOUR-WORKSPACE
```

这使得您可以运行Blaxel SDK功能,这些功能将自动连接到您的工作空间而无需额外的设置. 当你在Blaxel上部署时,这种连接会自动地持续.

当运行Blaxel SDK时,我们建议使用上文第三个选项中描述的环境变量.

## 使用量

### 模型使用

Blaxel作为模型API的统一网关,集中访问证书,追踪和遥测. 您可以与任何模型 API 提供者进行集成,或者部署自己的自定义模型. 当在Blaxel上部署一个模型时,也会创建一个全球API端点来称呼它.

这个软件包包含一个帮助器功能,它创建了对布赖斯尔上部署的模型的参考,并返回一个框架特定的模型客户端,通过布赖斯尔的统一网关来引导API调用.

```typescript
// With LangChain
import { blModel } from "@blaxel/langgraph";
const model = await blModel("gpt-5-mini");
```

### MCP 工具的使用

Blaxel允许您部署并托管模型背景协议(MCP)服务器,可以在全局端点上访问可流的HTTP.

此软件包包含一个帮助器功能,以特定框架所需要格式从由Blaxel托管的MCP服务器中检索并返回工具定义.

以下是一个以朗格拉夫要求的格式从Blaxel sandbox的MCP服务器中检索工具定义的例子:

```typescript
import { SandboxInstance } from "@blaxel/core";
import { blTools } from "@blaxel/langgraph";

// Create a new sandbox (base-image is Alpine + Node.js 22 + git; no Python — use "blaxel/py-app:latest" for Python)
const sandbox = await SandboxInstance.createIfNotExists({
  name: "my-sandbox",
  image: "blaxel/base-image:latest",
  memory: 4096,
  region: "us-pdx-1",
  ttl: "24h"
});

// Get sandbox tools
const tools = await blTools(['sandbox/my-sandbox'])
```

### 遥测

当工作量运行在Blaxel上时,仪器自动发生.

通过导入 : `@blaxel/telemetry` 软件包 :

```typescript
import "@blaxel/telemetry";
```

## 所需资源

-   节点.js v18 或以后

## 文档

-   [连接运行在 Blaxel 上的 MCP 服务器](https://docs.blaxel.ai/Agents/Develop-an-agent-ts)
-   [连接到运行在 Blaxel 上的 API 模型](https://docs.blaxel.ai/Agents/Develop-an-agent-ts)

## 捐款

欢迎捐款! 请随意 [提交拉动请求](https://github.com/blaxel-ai/sdk-typescript/pulls)。 。 。 .

## 许可证

这个项目根据麻省理工学院的许可证获得许可。 见 [自由主义](https://npmcn.com/package/%40blaxel/langgraph/LICENSE) 详细文件.

## 常见问题

### @blaxel/langgraph 是什么？

用于类型脚本的 Blaxel SDK

### 如何安装 @blaxel/langgraph？

在项目目录运行 npm install @blaxel/langgraph，或使用 pnpm add / yarn add / bun add。

### @blaxel/langgraph 支持 TypeScript 吗？

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

### @blaxel/langgraph 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @blaxel/langgraph 需要什么版本的 Node\.js？

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

### @blaxel/langgraph 可以商用吗？

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

### @blaxel/langgraph 的下载量有多少？

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

### @blaxel/langgraph 还在维护吗？

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