無程式碼也能輕鬆打造專業LINE官方帳號！一鍵導入模板，讓AI助你行銷加分！
AI 代理需要执行环境——用来运行代码、浏览网页、编辑文件和与工具交互的地方。为每个代理平台从头构建这些环境既繁琐又容易出错。Agent Sandbox 通过提供一个完整、预先配置的 Docker 沙箱解决了这个问题，将浏览器、Shell、文件系统、MCP 服务器和 VSCode Server 集成在单个容器化工作区中。
由 agent-infra 开发的 Agent Sandbox 专为需要执行真实世界任务的 AI 代理而设计。开发者不再需要拼凑浏览器自动化、代码执行和文件管理等分散的工具，而是获得一个具备所有这些预集成功能的统一沙箱。
沙箱以 Docker 容器形式运行，具有强大的隔离保证。代理通过干净的 REST API 或 Python 和 TypeScript 的官方 SDK 与其交互，使其易于集成到 Claude Code、OpenAI Operators 或自定义代理框架等现有代理平台中。
Agent Sandbox 包含哪些组件？
沙箱在单个容器中结合多种工具，每种工具服务于代理任务执行的不同方面。
graph TD
A[Agent Sandbox 容器] --> B[Chromium 浏览器]
A --> C[Shell 环境]
A --> D[文件系统]
A --> E[MCP 服务器]
A --> F[VSCode Server]
B --> G[网页浏览 / 自动化]
B --> H[屏幕截图 / DOM 访问]
C --> I[命令执行]
C --> J[脚本执行]
D --> K[读取 / 写入文件]
D --> K[项目工作区]
E --> L[通过 MCP 访问工具]
F --> M[网页代码编辑]
| 组件 | 用途 | 代理如何使用 |
|---|---|---|
| Chromium 浏览器 | 网页浏览与自动化 | 导航、点击、截图、提取 DOM |
| Shell 环境 | 命令执行 | 运行脚本、安装包、执行工具 |
| 文件系统 | 持久化存储 | 读写项目文件、存储输出 |
| MCP 服务器 | 工具协议 | 通过模型上下文协议暴露沙箱工具 |
| VSCode Server | 网页 IDE | 人机协作代码审查与编辑 |
Agent Sandbox 提供哪些 SDK？
沙箱提供多种集成路径，取决于您的代理平台和编程语言偏好。
| SDK / 接口 | 语言 | 主要方法 | 使用案例 |
|---|---|---|---|
| Python SDK | Python | Sandbox()、.run()、.browse()、.write() | 基于 Python 的代理框架 |
| TypeScript SDK | TypeScript | Sandbox.create()、.execute()、.screenshot() | Node.js 代理平台 |
| MCP 接口 | 任何 MCP 客户端 | 通过 MCP 发现工具 | Anthropic Claude、OpenAI、自定义代理 |
| REST API | 任何 HTTP 客户端 | POST /sandbox、GET /status | 直接 HTTP 集成 |
Python SDK 最为成熟，提供所有沙箱操作的方法，包括浏览器交互、Shell 命令、文件操作和 VSCode Server 管理。
如何开始使用 Agent Sandbox？
入门需要 Docker 和安装单个 SDK。
graph LR
A[安装 Docker] --> B[pip install agent-sandbox]
B --> C[from agent_sandbox import Sandbox]
C --> D[sandbox = Sandbox.create()]
D --> E[sandbox.run('python script.py')]
D --> F[screenshot = sandbox.browser.screenshot()]
D --> G[sandbox.mcp.connect()]
| 步骤 | 动作 | 命令 |
|---|---|---|
| 1 | 安装 Docker | 按照 Docker 安装指南操作 |
| 2 | 安装 SDK | pip install agent-sandbox 或 npm install agent-sandbox |
| 3 | 创建沙箱 | sandbox = Sandbox.create() |
| 4 | 执行任务 | result = sandbox.run("curl https://api.example.com") |
| 5 | 浏览网页 | screenshot = sandbox.browser.screenshot("https://example.com") |
| 6 | 清理 | sandbox.close() |
常见问题
什么是 Agent Sandbox？ Agent Sandbox 是由 agent-infra 开发的一站式 Docker 沙箱，为 AI 代理提供完整的执行环境，将浏览器、Shell、文件系统、MCP 服务器和 VSCode Server 集成在单个容器化工作区中。
Agent Sandbox 包含哪些功能？ Agent Sandbox 包含支持远程调试的 Chromium 浏览器、Shell 环境、持久化文件系统、MCP 服务器集成、VSCode Server 和网络控制功能。所有组件预先配置，可在安全、隔离的 Docker 环境中协同工作。
Agent Sandbox 有哪些 SDK 可用？ Agent Sandbox 提供 Python 和 TypeScript 的官方 SDK，以及用于支持 MCP 的代理平台的 MCP 接口。
如何开始使用 Agent Sandbox？
克隆仓库，运行 pip install agent-sandbox 或 npm install agent-sandbox，然后通过单个 API 调用创建沙箱实例。
Agent Sandbox 的安全性如何？ Agent Sandbox 通过 Docker 容器化提供强大的安全隔离。每个沙箱在隔离容器中运行，默认无网络访问、无主机文件系统访问权限，并使用临时文件系统。
延伸阅读
- Agent Sandbox GitHub 仓库 – 源代码、文档和示例
- Agent Sandbox 文档 – 完整 API 参考和部署指南
- Docker 容器安全最佳实践 – 官方 Docker 安全文档
- 模型上下文协议规范 – 代理-工具通信的 MCP 标准
- 构建 AI 代理执行环境 – 关于安全代理执行的研究
