# @agentskit/sandbox 中文文档

规范地址：https://npmcn.com/package/%40agentskit/sandbox/

版本：0\.6\.13
npm 元数据更新时间：2026-10-10T14:12:22.844Z
中文译文更新时间：2026-11-06T08:13:36.329Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40agentskit/sandbox
原文对照：https://npmcn.com/package/%40agentskit/sandbox/?lang=original
项目主页：https://www.agentskit.io/docs/reference/packages/sandbox
源码仓库：https://github.com/AgentsKit-io/agentskit

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

- 包体积（解压后）：479 kB，32 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.19
- 运行依赖：2 个
- peer 依赖：@e2b/code-interpreter ^2\.6\.1
- 首次发布：2026-04-06T14:27:43.841Z
- 最新版本发布：2026-10-10T14:12:22.458Z
- 近 30 天下载量：3936（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：42（近 12 个月 42 个）

## 中文简介

特工特工的安全密码执行.

## 安装

```sh
npm install @agentskit/sandbox
```

也可以使用：`pnpm add @agentskit/sandbox`、`yarn add @agentskit/sandbox`、`bun add @agentskit/sandbox`

## README

# @ agentskit/ sandbox (英语)

简介 : `concise-package`

![AgentsKit](https://raw.githubusercontent.com/AgentsKit-io/agentskit/main/apps/docs-next/public/brand/logo-wordmark.svg)

让代理安全地写和运行代码——在被隔离的云VM(E2B)中,限制本地运行时间,或者浏览器Web Worker.

[![npm version](https://img.shields.io/npm/v/@agentskit/sandbox?color=blue)](https://www.npmjs.com/package/@agentskit/sandbox) [![npm downloads](https://img.shields.io/npm/dm/@agentskit/sandbox)](https://www.npmjs.com/package/@agentskit/sandbox) [![bundle size](https://img.shields.io/bundlejs/size/@agentskit/sandbox?label=bundle)](https://bundlejs.com/?q=@agentskit/sandbox) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://npmcn.com/package/LICENSE) [![stability](https://img.shields.io/badge/stability-beta-yellow)](https://npmcn.com/package/docs/STABILITY.md) [![GitHub stars](https://img.shields.io/github/stars/AgentsKit-io/agentskit?style=social)](https://github.com/AgentsKit-io/agentskit)

**标记 :** `ai` • 妇女 `agents` • 妇女 `llm` • 妇女 `agentskit` • 妇女 `ai-agents` • 妇女 `sandbox` • 妇女 `code-execution` • 妇女 `e2b` • 妇女 `secure-execution` • 妇女 `code-interpreter`

## 已核实的证据

-   软件包元数据和测试在 `packages/sandbox/`。 。 。 .
-   软件包指南 : [https://www.agentskit.io/docs/参考资料/packages/sandbox](https://www.agentskit.io/docs/reference/packages/sandbox)
-   稳定地图: [文件/服务.md](https://npmcn.com/package/docs/STABILITY.md)
-   毕业轨道 : [RFC 0013 (英语)](https://npmcn.com/package/rfcs/0013-sandbox-stable.md) (拟议——不稳定)

## 如何适应生态系统

@ agentskit/ sandbox 给予代理执行代码和命令的更安全的地方,而不是信任您的应用程序中任意的工具呼叫.

-   **探员Kit**:与本回购中的其他包一起作曲,从可互换的小零件来构建代理.
-   **书记官处**: 查找已使用此图层的即时代理和模板 [登记. agentskit.io](https://registry.agentskit.io/)。 。 。 .
-   **游戏本**: 学习本层背后的生产模式 [游戏本. agentskit.io](https://playbook.agentskit.io/)。 。 。 .

文档 : [软件包指南](https://www.agentskit.io/docs/reference/packages/sandbox) • 妇女 [代理交接](https://github.com/AgentsKit-io/agentskit/blob/main/llms.txt)

## 为什么是沙盒

-   **实际执行的代码生成** ——代理可以写作,运行,并且可以无限制地使用主机进行迭代
-   **E2B 积分** ——可选对等点 `@e2b/code-interpreter`; 默认为无 internet (`allowInternetAccess: false`; 执行中超; 合并 stdout/ stderr 字节封顶
-   **带上你的后端** —— 说 `SandboxBackend` 是两种方法;插入多克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克
-   **政策总结** —— 说 `createMandatorySandbox` 允许/拒绝/要求Sandbox(仅要求Sandbox路线) `{ code, language? }` 沙盒工具的参数; 不相容的 schemas 失败关闭, 原机体永远不会运行)
-   **与任何其他工具一起工作** 添加 `sandboxTool` 改为: `tools` 数组为 `webSearch` 或者说 `filesystem`

## 安装

```bash
npm install @agentskit/sandbox @e2b/code-interpreter
```

## 快速实例

```ts
import { createRuntime } from '@agentskit/runtime'
import { anthropic } from '@agentskit/adapters'
import { sandboxTool } from '@agentskit/sandbox'

const runtime = createRuntime({
  adapter: anthropic({ apiKey: process.env.ANTHROPIC_API_KEY, model: 'claude-sonnet-4-6' }),
  tools: [sandboxTool({ apiKey: process.env.E2B_API_KEY })],
})

const result = await runtime.run('Write and run a Python script that generates a Fibonacci sequence up to 100')
console.log(result.content)
```

## 特征

-   `sandboxTool({ apiKey })` ——通过E2B(可选对等点)执行代码的即时工具
-   `createSandbox({ backend | apiKey, network?, timeout?, language? })` ——存在担保违约的外表
-   **默认 :** `network: false`, (中文(简体) ), `timeout: 30_000` 每个执行时 ms, 语言 `javascript`
-   **`memoryLimit`数字 :** 接受兼容性; **未执行** 由 E2B 或 Web Worker( 定制后端可能尊重它)
-   `SandboxBackend` 接口 - `execute` + 可选 `dispose`
-   本地运行时间: 进程、 macOS 安全带、 Linux bwrap( β), Docker
-   浏览器 : `@agentskit/sandbox/web` - 网络工人(仅线条和DOM隔离); **没有** 网页连接器)
-   跟着 `ToolDefinition` 合同——在 `runtime`, (中文(简体) ), `useChat`,或任何自定义循环

## 诚实的隔离主张

| 后端 | 你得到的东西 | 你做什麽 **没有** 起来 |
| --- | --- | --- |
| E2B 软件 | 远程 VM 隔离, 可选网络拒绝 | 个人行为 `memoryLimit` 通过代理 Kit |
| 网络工作者 | 离心线+ 无 DOM | 网络/ FS 安全边界; 网络容器 |
| `processSandbox` | 儿童过程 + env 允许列表 (`PATH`, (中文(简体) ), `HOME`, (中文(简体) ), `TZ`, (中文(简体) ), `LANG`, (中文(简体) ), `LC_ALL`, (中文(简体) ), `NODE_ENV`, (中文(简体) ), `AGENTSKIT_*`(中文(简体) ) | OS级的fs/网隔离 |
| 安全带/ brap/ 插头 | 平台监狱(β) | 稳定的多租房担保 |

## 生态系统

| 软件包 | 作用 |
| --- | --- |
| [@ agentskit/ 运行时间](https://www.npmjs.com/package/@agentskit/runtime) | `createRuntime({ tools })` |
| [@ agentskit/ 工具](https://www.npmjs.com/package/@agentskit/tools) | 与强制性沙盒政策配套的工具 |
| [@ agentskit/ 适应器](https://www.npmjs.com/package/@agentskit/adapters) | 用于代码源任务的 LLM |
| [@ agentskit/ 核心](https://www.npmjs.com/package/@agentskit/core) | 工具合同 |

## 贡献者

[![AgentsKit contributors](https://contrib.rocks/image?repo=AgentsKit-io/agentskit)](https://github.com/AgentsKit-io/agentskit/graphs/contributors)

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/package/LICENSE)。 。 。 .

## 文档

[完整文档](https://www.agentskit.io/) • 妇女 [GitHub 图像](https://github.com/AgentsKit-io/agentskit)

## 成熟性和相容性

-   稳定性: **β 语录** 看到了吗 [文件/服务.md](https://npmcn.com/package/docs/STABILITY.md)没有1.0.
-   **节点.js 20+** 财务报告和审定财务报表 **类型脚本** 严格模式
-   发表于 `@agentskit/sandbox`

## 捐款

见 [捐款额](https://npmcn.com/package/CONTRIBUTING.md) 单曲 [自由主义](https://npmcn.com/package/LICENSE)。 。 。 .

## 常见问题

### @agentskit/sandbox 是什么？

特工特工的安全密码执行\.

### 如何安装 @agentskit/sandbox？

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

### @agentskit/sandbox 支持 TypeScript 吗？

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

### @agentskit/sandbox 支持 ESM 还是 CommonJS？

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

### @agentskit/sandbox 需要什么版本的 Node\.js？

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

### @agentskit/sandbox 可以商用吗？

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

### @agentskit/sandbox 的下载量有多少？

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

### @agentskit/sandbox 还在维护吗？

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