E2B 提供方

E2B 是目录提供方，源码在 awesome-providers/e2b，id 是 e2b。用 abx provider install alibaba-agent-sandbox/awesome-providers//e2b --allow-unpinned --yes（或 python -m agent_sandbox.providers install registry:e2b --yes）安装。Sandbox.create(provider="e2b") 和 abx --provider e2b 用宿主里的 E2B 协议类访问 E2B 公开 API。

它不是随 SDK 编译进去的。清单是 kind = "node"：provider.mjs 由 Node.js 宿主加载，Python SDK 通过本机引擎（abx provider engine serve）使用它。自己的说明在 awesome-providers/e2b/docs/README.md。

单元测试不访问 https://api.e2b.dev。它在 127.0.0.1 上用本地 TCP 服务回答 POST /sandboxes。

真实访问 E2B 需要设置 ABX_E2B_API_KEY。没有这个变量时，测试确认 Sandbox.create(provider="e2b") 在发出请求前抛出 InvalidAPIKeyError。极速版的 ABX_SANDBOX_API_KEY 不会被送到 api.e2b.dev。这台环境没有单独的 E2B 密钥，所以真实创建没有执行。

英文页：provider-e2b.md。

配置

字段	类型	环境变量	默认
base_url	url	ABX_E2B_BASE_URL	https://api.e2b.app
domain	字符串	ABX_E2B_DOMAIN	e2b.app
api_key	密钥	ABX_E2B_API_KEY	不设置

这三个名字也可以放在 provider_options 里。Sandbox.create(api_url=...) 不会改这个源站。解析器读的是 provider_options["base_url"]。

设置了密钥时，客户端发送请求头 X-API-Key。没有 ABX_E2B_API_KEY 时抛出 InvalidAPIKeyError，错误信息里写明 ABX_E2B_API_KEY。这个提供方不读 ABX_SANDBOX_API_KEY（阿里云极速版的密钥），也不读 E2B_API_KEY（本产品拒绝的旧名字）。

domain 是 https://{port}-{sandboxID}.{domain} 的后缀。envd 端口是 49983。创建响应里没有 region 时保持未知（空字符串），不会落成 cn-hangzhou。

当前 E2B SDK 用 https://api.e2b.app，域名是 e2b.app。数据面主机名是 https://{port}-{sandboxID}.e2b.app。https://api.e2b.dev 是旧源站；账号还在那边时同时设置 ABX_E2B_BASE_URL 和 ABX_E2B_DOMAIN。

from agent_sandbox import Sandbox

sb = await Sandbox.create(
    provider="e2b",
    provider_options={
        "base_url": "https://api.e2b.app",
        "domain": "e2b.app",
        "api_key": "...",
    },
    template="base",
)

这个适配器会调用的能力

创建是 POST /sandboxes，正文包含 templateID、timeout、metadata、envVars。其余由共享协议客户端发送。

能力	共享协议做的事
sandbox.lifecycle	POST /sandboxes、GET /sandboxes、GET /sandboxes/{id}、DELETE /sandboxes/{id}、GET /v2/sandboxes
sandbox.timeout	POST /sandboxes/{id}/timeout
sandbox.pause	POST /sandboxes/{id}/pause 和 POST /sandboxes/{id}/resume
exec.run、exec.stream	envd POST /process.Process/Start
process.manage	envd 的进程列表、标准输入和信号
files.rw	envd 的读、写、列目录、移动和删除
files.watch	envd WatchDir。已声明，不会因为未声明而返回 E8004
code.interpret	envd POST /code.CodeInterpreter/Execute
ports.url	本地计算 https://{port}-{sandboxID}.{domain}

会抛出 E8004 的调用

这些 id 不在 features 里。feature_gate 在发出 HTTP 之前拒绝未声明能力对应的协议方法。Provider.require 以同样的方式拒绝能力 id。

能力	被拒绝的内容
pty	交互终端。公开 envd 没有 /terminal
files.transfer	仅靠签名或 token 的文件 URL
templates.read	模板列表和查询
templates.build	模板构建和发布
ports.domain	单独的域名式能力 id。端口主机名仍然使用 domain
storage.mount	存储挂载
network.vpc	VPC
sessions	SandboxServer 上的具名命令

files.watch 已声明。files.watch / watch_dir 不会因为未声明而抛出 E8004。

扩展

extensions 是空的。18 个固定能力之外没有登记扩展。

E2B 公开 API 还有这些接口，这个适配器不调用，也不登记成扩展：沙箱日志（GET /v2/sandboxes/{sandboxID}/logs）、指标（GET /sandboxes/{sandboxID}/metrics）、快照、fork、更新网络、卷、模板标签、团队密钥、事件和 webhook。卷和未声明的 storage.mount 重叠。模板列表和构建与 templates.read、templates.build 重叠。