场景一:接入 Agent Sandbox
控制台操作
通过控制台创建密钥与沙箱工具。
1. 登录 Agent 沙箱服务控制台。
2. 在 API Keys 页面,单击新建,创建并存储 API Key。API Key 需在客户端的环境变量中配置,请参见 步骤二:配置环境变量。
3. 在 沙箱工具 页面,创建沙箱工具,获取沙箱工具名称。沙箱工具名称需在沙箱实例启动时设置,请参见 步骤三:启动 Agent 沙箱。
客户端操作
步骤一:安装 SDK
在客户端创建虚拟环境,安装 SDK。
uv venv venvsource ven/bin/activateuv pip install pipuv pip install e2b-code-interpreter
步骤二:配置环境变量
os.environ["E2B_DOMAIN"]="ap-guangzhou.ags.tencentcs.com"os.environ["E2B_API_KEY"]="ark_xxxx" # 需要改为控制台创建的 API Key
步骤三:启动 Agent 沙箱
运行以下示例来创建一个沙箱,并运行指定命令:
import osfrom e2b_code_interpreter import Sandbox#创建一个代码沙箱,template 需要替换为上述控制台新建的沙箱工具名称,默认运行10分钟,使用 timeout 参数指定运行时间,此处保持运行3600s(1h)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()
场景二:迁移场景,兼容 E2B
控制台操作
通过控制台创建密钥与沙箱工具。
1. 登录 Agent 沙箱服务控制台。
2. 在 API Keys 页面,单击新建,创建并存储 API Key。API Key 需在客户端的环境变量中配置。
3. 在 沙箱工具 页面,创建沙箱工具,获取沙箱工具名称。沙箱工具名称请与 E2B 模板名称(template)保持一致。
客户端操作
替换环境变量
os.environ["E2B_DOMAIN"]="ap-guangzhou.ags.tencentcs.com"os.environ["E2B_API_KEY"]="ark_xxxx" # 需要改为控制台创建的 API Key