本文介绍如何创建 Agent 沙箱服务的 API Key 与沙箱工具，安装 E2B 兼容 SDK，启动代码沙箱并运行 Python 代码
场景一：接入 Agent Sandbox
控制台操作
通过控制台创建密钥与沙箱工具。
1. 登录 Agent 沙箱服务控制台。
2. 在 API Keys 页面，单击新建，创建并保存 API Key。API Key 需在客户端的环境变量中配置。
3. 在 沙箱工具 页面，创建沙箱工具，并记录沙箱工具名称。沙箱工具名称需在沙箱实例启动时设置，请参见 步骤三：启动 Agent 沙箱。
客户端操作
步骤一：安装 SDK
在客户端创建虚拟环境，安装 SDK。
uv venv venvsource venv/bin/activateuv pip install pipuv pip install e2b-code-interpreter
步骤二：配置环境变量
import osos.environ["E2B_DOMAIN"]="ap-guangzhou.tencentags.com"os.environ["E2B_API_KEY"]="e2b_xxxx" # 替换为控制台创建的 API Keyos.environ["E2B_DOMAIN"]="ap-guangzhou.tencentags.com"os.environ["E2B_API_KEY"]="e2b_xxxx" # 替换为控制台创建的 API Key
步骤三：启动 Agent 沙箱实例
运行以下示例来启动一个沙箱实例，并运行指定命令：
import osfrom e2b_code_interpreter import Sandbox# template 替换为控制台创建的沙箱工具名称# timeout 指定运行时长，单位为秒；示例为 3600 秒（1 小时）sandbox = Sandbox.create(template="code-interpreter-v1",timeout=3600)#执行下述 python 代码，流式获取代码输出并打印，代码执行超时时间为600秒python_code = """import timeprint("hello python")time.sleep(2)print("hello python after 2 sec")"""print(sandbox.run_code(python_code,on_stdout=lambda data:print(data),timeout=600))sandbox.kill()
说明：
Sandbox.create 的 timeout 指定沙箱最长运行时间，单位为秒。本示例设置为 3600 秒（1 小时）。若未指定，且非持久化沙箱工具未配置默认超时，则系统默认使用 300 秒（5 分钟）
场景二：迁移场景，兼容 E2B
控制台操作
通过控制台创建密钥与沙箱工具。
1. 登录 Agent 沙箱服务控制台。
2. 在 API Keys 页面，单击新建，创建并保存 API Key。API Key 需在客户端的环境变量中配置。
3. 在 沙箱工具 页面，创建沙箱工具，获取沙箱工具名称。沙箱工具名称请与 E2B 模板名称（template）保持一致。
客户端操作
替换环境变量
import osos.environ["E2B_DOMAIN"]="ap-guangzhou.tencentags.com"os.environ["E2B_API_KEY"]="e2b_xxxx" # 需要改为控制台创建的 API Keyos.environ["E2B_API_KEY"]="e2b_xxxx" # 需要改为控制台创建的 API Key
