通过 E2B SDK 管理沙箱实例的生命周期并执行数据面操作。使用百炼沙箱接入地址与 API Key,即可创建实例、执行命令、运行代码与读写文件。
Sandbox 兼容 E2B SDK。安装 E2B 官方 SDK 后,将接入地址指向百炼沙箱、用百炼 API Key 鉴权,即可创建实例、执行命令、运行代码与读写文件。
本文示例基于以下版本验证:
使用百炼 API Key 根据模版 code 创建一个云端沙箱,成功后得到
连接到沙箱后,可执行命令、运行代码,也可像操作本地文件一样读写文件。
空闲时暂停沙箱,需要时重新连接会从暂停点恢复;不再使用时释放资源。
数据面操作推荐通过 SDK 完成,SDK 会使用连接实例返回的 domain 与 token 直接访问沙箱运行时。
推荐版本
本文示例基于以下版本验证:
鉴权与接入
| 参数 | 说明 |
|---|---|
api_url | 百炼沙箱接入地址,形如 https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/sandbox |
Authorization | Bearer <百炼 API Key>,用于真实鉴权 |
api_key | E2B SDK 必填参数,仅用于满足 SDK 格式,推荐填写 e2b_${ALIYUN_UID} |
template | 模版 code,即控制台创建的 templateCode |
api_key 只需满足 e2b_ 后跟十六进制字符的格式。阿里云 UID 为纯数字,天然满足校验(如 e2b_your aliyunUid)。百炼侧不使用 api_key 做业务鉴权。步骤 1:创建实例
使用百炼 API Key 根据模版 code 创建一个云端沙箱,成功后得到 sandbox_id,后续访问与管理均使用它。
步骤 2:访问实例
连接到沙箱后,可执行命令、运行代码,也可像操作本地文件一样读写文件。
步骤 3:管理实例生命周期
空闲时暂停沙箱,需要时重新连接会从暂停点恢复;不再使用时释放资源。
支持的能力
实例生命周期
| 能力 | SDK 方法 |
|---|---|
| 创建实例 | Sandbox.create(template=...) |
| 获取实例信息 | sbx.get_info() |
| 连接实例 | Sandbox.connect(sandbox_id=...) |
| 暂停实例 | sbx.pause() |
| 释放实例 | sbx.kill() |
数据面操作
数据面操作推荐通过 SDK 完成,SDK 会使用连接实例返回的 domain 与 token 直接访问沙箱运行时。
| 能力 | SDK 方法 | 底层数据面请求 |
|---|---|---|
| 执行命令 | sbx.commands.run(...) | POST /process.Process/Start |
| 创建目录 | sbx.files.make_dir(path) | SDK 文件系统 RPC |
| 写文件 | sbx.files.write(path, content) | POST /files?path=... |
| 读文件 | sbx.files.read(path) | GET /files?path=... |
| 运行代码 | sbx.run_code(...) | POST :49999/execute |
模版管理没有稳定的 SDK 对象方法,需通过 raw HTTP 调用管控面接口,详见 Sandbox API - 模版管理。实例生命周期与数据面操作使用上述 SDK 方法即可。