E2B 兼容说明

Sandbox

第一代运行时的暂停与恢复仅对已开通白名单的账号可用，请先完成白名单开通，再调用 sandbox.pause() 或连接已暂停的 Sandbox；第二代运行时默认支持暂停与恢复，无需加入白名单。

Snapshot 功能同样仅对已开通白名单的账号可用，且仅支持第二代运行时（microVM）。请先完成白名单开通，再调用 Snapshot 相关接口。

支持以下 Sandbox 生命周期和访问能力：

• Sandbox.create()

• Sandbox.connect(sandboxId)

• Sandbox.list()

• Sandbox.getInfo(sandboxId)

• Sandbox.kill(sandboxId)

• Sandbox.setTimeout(sandboxId, ms)

• sandbox.getInfo()

• sandbox.isRunning()

• sandbox.setTimeout(ms)

• sandbox.pause()

• sandbox.kill()

• sandbox.downloadUrl(path)

• sandbox.uploadUrl(path)

• sandbox.getHost(port)

• sandbox.createSnapshot({ name? }) / Sandbox.createSnapshot(sandboxId, { name? })

• Sandbox.listSnapshots({ sandboxId?, name?, limit?, nextToken? })

• Sandbox.deleteSnapshot(snapshotId | qualifiedName)

• Python：sandbox.create_snapshot(name=...) / Sandbox.create_snapshot(sandbox_id, name=...)、Sandbox.list_snapshots(...)、Sandbox.delete_snapshot(snapshot_id | qualified_name)

Sandbox.connect(sandboxId) 可连接已有 Sandbox。如果目标 Sandbox 已暂停，连接时会自动恢复。

Sandbox.create() 的模板参数除模板名 / 模板 ID 外，还可以是 Snapshot ID 或已命名 Snapshot 的全名。Snapshot 使用限制和命名规则参见快照（Snapshot）（邀测）。

Commands

支持以下命令执行和进程管理能力：

• sandbox.commands.run()

• sandbox.commands.list()

• sandbox.commands.connect()

• sandbox.commands.sendStdin()

• sandbox.commands.kill()

交互式终端和依赖 TTY 的任务使用 sandbox.pty API。

Filesystem

支持以下文件系统能力：

• sandbox.files.list()

• sandbox.files.exists()

• sandbox.files.getInfo() / sandbox.files.get_info()

• sandbox.files.read()

• sandbox.files.write()

• sandbox.files.makeDir() / sandbox.files.make_dir()

• sandbox.files.remove()

• sandbox.files.rename()

• sandbox.files.watchDir() / sandbox.files.watch_dir()

sandbox.files.write() 支持写入文本、二进制内容和流式内容。目录监听适合等待 Agent 输出文件或同步任务产物。

Agent Sandbox极速版 文件自定义元数据暂不支持。以 Python SDK e2b==2.31.0 为例：方法签名虽然接受 metadata 参数，但第一代运行时的 Sandbox 使用 envd 0.5.2，SDK 在发出写入请求前会直接抛出 TemplateException: File metadata requires envd 0.6.2 or later。

Code Interpreter

支持代码解释器核心能力：

• sandbox.runCode() / sandbox.run_code()

• sandbox.createCodeContext() / sandbox.create_code_context()

• sandbox.listCodeContexts() / sandbox.list_code_contexts()

• sandbox.restartCodeContext() / sandbox.restart_code_context()

• sandbox.removeCodeContext() / sandbox.remove_code_context()

• 执行结果输出，包括 stdout、stderr、execution count、裸表达式结果和 execution.results 富结果。

• 流式输出场景下的 stdout、stderr 和结果回调。

• 多次代码执行之间的变量和上下文状态保持。

• 通过 language 参数执行 Python、JavaScript、TypeScript 和 Bash。

图表与可视化当前只支持文件降级方案：在 Sandbox 内生成图片文件后，通过 Filesystem 或下载 URL 取回。

Template

支持模板的创建、查询、更新和删除（增删改查）。当前模板构建支持从镜像创建模板。具体使用方式参见构建和管理模板。

CLI

Agent Sandbox极速版兼容 E2B CLI 的常用 Sandbox 命令，并扩展部分 Template 管理命令：

新版本 E2B CLI 使用 E2B_API_KEY 认证。配置方式参见通过 CLI 使用Agent Sandbox极速版。

Metrics

支持 E2B metrics，并在控制台提供可观测能力；暂不支持 Metrics API。