与其他沙箱工具的对比

说明： 本页出现的 abx 命令由 cli 仓库中的 Node.js CLI 提供（npm install -g @agent-sandbox/cli）。CLI 专属文档（CLI 设计、教程、参考）也在该仓库；本仓库记录 Python SDK（agent-sandbox）与容器侧运行时（agent-sandbox-server）。

本文档客观对比 Agent Sandbox (abx) 与其他主流沙箱及远程执行平台：E2B、Modal、Docker Sandbox。

定位与场景

SDK 对比

代码示例

Agent Sandbox：

from agent_sandbox.api.sandbox import Sandbox

async with await Sandbox.create(template="python-hello") as sb:
    result = await sb.run_code("print('hello')")
    print(result.text)

E2B：

from e2b import Sandbox

sandbox = Sandbox()
result = sandbox.run_code("print('hello')")
print(result.text)
sandbox.kill()

Modal：

import modal
app = modal.App("example")

@app.function()
def hello():
    print("hello")

使用风格对比

Agent Sandbox 同时支持 命令式（E2B 风格）和 声明式（Modal 风格）两种编程范式：

E2B 风格（命令式）— 细粒度控制：

from agent_sandbox.api.sandbox import Sandbox

async with await Sandbox.create() as sb:
    await sb.commands.run("pip install pandas")
    await sb.files.write("/app/data.csv", csv_content)
    result = await sb.commands.run("python3 /app/analyze.py")
    report = await sb.files.read("/app/report.txt")

Modal 风格（声明式）— 像调本地函数：

from agent_sandbox.declarative import sandbox

@sandbox(packages=["pandas"])
def analyze(data: list[dict]) -> dict:
    import pandas as pd
    df = pd.DataFrame(data)
    return {"mean": df["value"].mean(), "count": len(df)}

# 调用方式和本地函数一样，自动在远程沙箱中执行
result = analyze(my_data)

完整示例参见 examples/compat-demos/comparison.py

CLI 对比

基础设施

Agent Sandbox 的独特能力

E2B 风格的 API

Agent Sandbox 使用 E2B 风格的方法名，E2B 代码通常只需少量改动即可迁移。它不是 E2B 的直接替代品：配置、认证和部分行为都不同。

# 迁移的起点：改导入，然后按指南逐项处理
from agent_sandbox.compat import Sandbox

完整迁移指南参见从 E2B 迁移。

阿里云集成

VPC、OSS 卷、自定义域名是平台侧设置（模板运行时配置和账号级资源），Python SDK 没有对应的 API。

注册命令

注册在沙箱 server 里的函数（@sandbox.register，由容器内 Server SDK 实现）通过一个 API 调用：

result = await sandbox.run("analyze", data="input.csv")

此能力在 E2B 和 Modal 中不可用。

MCP Server 集成

Agent Sandbox 内置 MCP (Model Context Protocol) Server，使 AI IDE（Cursor、Claude Desktop、VS Code）可以直接操作沙箱：

abx mcp install --target cursor

提供 7 个工具：create_sandbox、run_code、run_command、read_file、write_file、list_files、kill_sandbox。

声明式沙箱装饰器

from agent_sandbox import sandbox

@sandbox(template="python-hello", timeout=60)
async def my_task():
    ...

其他平台（简要）

总结

延伸阅读

• 命令与 SDK 对照
• 从 E2B 迁移
• SDK 使用指南
• CLI 教程
• MCP 集成
• 认证详解