用途:通过 E2B API 创建和管理用于 AI 代码执行的安全云沙箱(临时 VM)。官方文档见 https://e2b.dev/docs/api-reference。
主要能力:创建沙箱、列出运行中的沙箱、查询沙箱状态、刷新超时、终止沙箱、列出可用模板。创建时默认模板为 base(基于 Debian,含常用运行时),可指定 timeout(秒,默认 300)和 metadata 标签。
使用方式:先连接 E2B 连接器(app.vm0.ai/connectors),并配置 E2B_TOKEN。创建沙箱:curl -s -X POST "https://api.e2b.app/sandboxes" --header "Content-Type: application/json" --header "X-API-Key: $E2B_TOKEN" -d @/tmp/e2b_create.json,请求体如 {"templateID": "base"}。响应含 sandboxID、templateID、alias、clientID。列出沙箱:curl -s -X GET "https://api.e2b.app/sandboxes" --header "X-API-Key: $E2B_TOKEN"。查询状态:GET /sandboxes/<sandbox-id>。刷新超时:POST /sandboxes/<sandbox-id>/refreshes,请求体 {"timeout": 300}。终止:DELETE /sandboxes/<sandbox-id>。列出模板:GET /templates,响应含 templateID、aliases、buildID。
适用场景:AI 代理执行代码、代码审查等需要隔离运行环境的任务。
限制:沙箱为临时性,超时后自动终止(默认 5 分钟),需保存 sandboxID 供后续操作;任务超时可用刷新端点延长。完成后应删除沙箱以避免额外费用和并发上限。并发受套餐限制,批量创建前需确认。请求失败可运行 zero doctor check-connector --env-name E2B_TOKEN 或 zero doctor check-connector --url https://api.e2b.app/sandboxes --method GET 排查。