帮你快速理解、总结文档立即下载
文档中心>Agent Runtime>操作指南>快速开始>用 E2B SDK 跑代码

用 E2B SDK 跑代码

最近更新时间：2026-09-15 11:35:34
本文档已由 AI 辅助审校
我的收藏

本页目录：

操作流程

操作步骤
说明
准备工作
准备 Python 环境、AGS API Key、endpoint 域名，以及可用的沙箱工具名称。
步骤一：安装 SDK 并配置环境变量
安装 e2b-code-interpreter，配置 E2B_API_KEY 和 E2B_DOMAIN。
步骤二：创建沙箱实例并执行代码
用最少 3 行 Python 创建沙箱实例、执行代码并打印结果。
步骤三：在沙箱实例内安装依赖并再次执行
使用 pip install 安装依赖，再执行 Python 代码验证结果。
步骤四：关闭沙箱实例
调用 kill() 释放当前沙箱实例。

准备工作

已获取 AGS 提供的 API Key。
已获取 AGS 提供的 E2B 兼容 endpoint 域名，例如 ap-guangzhou.tencentags.com。
当前 API Key 已具备创建和使用 Code Interpreter Sandbox 的权限。
本地已安装 Python 3.10 或更高版本，以及 pip。
已确认当前环境中可用的沙箱工具名称。本文示例使用 code-interpreter-v1。
注意：
E2B_DOMAIN 填写 AGS 提供的 E2B 兼容 endpoint 域名即可，不要添加 https:// 前缀。您可以直接复用 安装与配置 中的域名配置说明，例如 ap-guangzhou.tencentags.com。

步骤一：安装 SDK 并配置环境变量

安装 Python SDK

python3 -m pip install e2b-code-interpreter

配置 API Key、endpoint 和沙箱工具的名称

export E2B_API_KEY="e2b_your_api_key"
export E2B_DOMAIN="ap-guangzhou.tencentags.com"
export AGS_TEMPLATE="code-interpreter-v1"
说明：
示例中的 ap-guangzhou.tencentags.com 为公开域名格式示例，请替换为 AGS 为当前接入地域提供的 E2B 兼容服务域名。
相关配置说明如下：
环境变量
是否必填
说明
E2B_API_KEY
是
AGS 提供的 API Key。
E2B_DOMAIN
是
AGS 提供的 E2B 兼容 endpoint 域名，只填写域名部分。
AGS_TEMPLATE
建议
本文示例使用的沙箱工具名称。
如果您不希望通过环境变量传参，也可以在创建沙箱实例时显式传入 api_key 和 domain：
from e2b_code_interpreter import Sandbox

sandbox = Sandbox.create(
    template="code-interpreter-v1",
    api_key="e2b_your_api_key",
    domain="ap-guangzhou.tencentags.com",
)
sandbox.kill()
环境变量方式创建沙箱实例时，template="code-interpreter-v1" 也可以替换为 template=os.environ["AGS_TEMPLATE"]，便于在不同环境中复用同一份脚本。

步骤二：创建沙箱实例并执行代码

执行以下示例，使用 3 行 Python 完成创建沙箱实例、执行代码和打印结果：
from e2b_code_interpreter import Sandbox

sandbox = Sandbox.create(template="code-interpreter-v1")
print(sandbox.run_code("print('hello from AGS via E2B SDK')").text)
sandbox.kill()
如果您希望从环境变量中读取沙箱工具名称，也可以改为：
import os
from e2b_code_interpreter import Sandbox

sandbox = Sandbox.create(template=os.environ["AGS_TEMPLATE"])
print(sandbox.run_code("print('hello from AGS via E2B SDK')").text)
sandbox.kill()
运行成功后，终端中会看到类似输出：
hello from AGS via E2B SDK

步骤三：在沙箱实例内安装依赖并再次执行

如果您需要在当前沙箱实例中安装 Python 依赖，可以先执行 pip install，再运行代码验证依赖是否可用。
from e2b_code_interpreter import Sandbox

sandbox = Sandbox.create(template="code-interpreter-v1")
sandbox.commands.run("python -m pip install requests")
execution = sandbox.run_code("import requests\\nprint(requests.__version__)")
print(execution.text)
sandbox.kill()
执行完成后，根据输出确认依赖已安装成功。例如输出 2.32.3，表示 requests 已可在当前的沙箱实例中使用。
说明：
通过 pip install 安装的依赖只在当前沙箱实例的生命周期内生效。关闭沙箱实例后，如需再次使用，请重新创建沙箱实例并重新安装依赖，或改用已预装依赖的模板。

步骤四：关闭沙箱实例

如果您在前面的示例中没有立即调用 kill()，请在操作完成后显式关闭当前沙箱实例：
sandbox.kill()
关闭后，当前沙箱实例会被释放。建议在脚本结束前始终执行一次清理，避免产生不必要的资源占用。

后续操作

如果您需要长期复用相同依赖，可以使用预装依赖的沙箱工具，避免每次启动后重新安装。
如果您需要在沙箱实例中操作文件、执行 Shell 命令或保持运行上下文，可通过 sandbox.files、sandbox.commands 和 sandbox.run_code(...) 继续扩展脚本。
如果您需要同时运行多个沙箱实例或管理沙箱实例的生命周期，请参阅 实例生命周期 相关文档。
中国站