@agentskit/sandbox

中文文档
0.6.13发布于 2026/10/10MITTypeScriptESM + CJS构建来源已验证近 30 天下载 3936

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

中文使用文档
文档目录13 节
  1. 已核实的证据
  2. 如何适应生态系统
  3. 为什么是沙盒
  4. 安装
  5. 快速实例
  6. 特征
  7. 诚实的隔离主张
  8. 生态系统
  9. 贡献者
  10. 许可证
  11. 文档
  12. 成熟性和相容性
  13. 捐款

@ agentskit/ sandbox (英语)

简介 : concise-package

AgentsKit

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

npm version npm downloads bundle size license stability GitHub stars

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

已核实的证据

如何适应生态系统

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

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

文档 : 软件包指南 • 妇女 代理交接

为什么是沙盒

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

安装

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

快速实例

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/ 运行时间createRuntime({ tools })
@ agentskit/ 工具与强制性沙盒政策配套的工具
@ agentskit/ 适应器用于代码源任务的 LLM
@ agentskit/ 核心工具合同

贡献者

AgentsKit contributors

许可证

麻省理工学院——见 自由主义。 。 。 .

文档

完整文档 • 妇女 GitHub 图像

成熟性和相容性

  • 稳定性: β 语录 看到了吗 文件/服务.md没有1.0.
  • 节点.js 20+ 财务报告和审定财务报表 类型脚本 严格模式
  • 发表于 @agentskit/sandbox

捐款

见 捐款额 单曲 自由主义。 。 。 .

版本与发布记录

@agentskit/sandbox 共发布 42 个版本,首次发布于 2026/04/06;过去 12 个月发布了 42 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.6.13latest2026/10/1028 天前
0.6.122026/10/031 个月前
0.6.112026/10/031 个月前
0.6.102026/09/291 个月前
0.6.92026/09/281 个月前
0.6.82026/09/281 个月前

关于 @agentskit/sandbox 的常见问题

@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 和提交记录判断。