快速入门
更新时间:2025-11-06
接入Agent 沙箱服务
本文指导您快速接入Agent 沙箱服务。本服务兼容了E2B SDK,您可以的使用E2B SDK快速接入。
环境准备
- 运行环境
E2B提供的官方SDK,若使用Python语言,则请使用python3及以上。SDK安装E2B SDK 2.0及以上版本。
- 您可以根据需要确定需要使用的Agent沙箱服务地域,目前支持北京,广州,苏州。以下是各地域沙箱服务的访问Endpoint, 请您根据需要获取接入Agent沙箱服务域名
| 地域 | Endpoint |
|---|---|
| 北京 | sandbox-execute.bj.baidubce.com |
| 广州 | sandbox-execute.gz.baidubce.com |
| 苏州 | sandbox-execute.su.baidubce.com |
- 认证鉴权
在您选定的地域的官网控制台 API Keys页面,点击新建,创建并存储API Key。API Key 需在客户端的环境变量中配置,用于后续访问沙箱服务。您在选定的地域新建API KEY并保存,后续在环境变量中使用。
安装依赖库
安装E2B python依赖库/或者JavaScript库
1pip install e2b-code-interpreter python-dotenv
1npm i @e2b/code-interpreter dotenv
配置环境变量
您可以通过以下三种常见方式设置环境变量,推荐您使用 dotenv 文件来配置环境变量。
dotenv文件
在您的项目文件夹创建 .env 文件,在其中配置环境变量。假设您使用广州的Agent沙箱服务,您可以在.env文件中写入如下内容并保存。E2B_DOMAIN环境变量设置为Agent沙箱服务域名;E2B_API_KEY设置为您准备工作中创建的API Key
.env
1E2B_DOMAIN=sandbox-execute.gz.baidubce.com
2E2B_API_KEY=bsx_xxxxxxxx
然后在您的代码中使用 dotenv 库来引入,通过该种方式引入的环境变量在当前代码范围内生效。
1from dotenv import load_dotenv
2load_dotenv()
1import 'dotenv/config'
启动Agent沙箱
将如下Python代码写入main.py文件,或Javascripts代码写入index.ts文件中。
1# main.py
2from dotenv import load_dotenv
3load_dotenv()
4from e2b_code_interpreter import Sandbox
5
6# 默认创建代码沙箱,过期时间5分钟
7sbx = Sandbox.create()
8
9# 在沙箱中运行Python代码
10execution = sbx.run_code("print('hello world')") # Execute Python inside the sandbox
11print(execution.logs)
12
13# 展示沙箱/目录的文件有哪些
14files = sbx.files.list("/")
15print(files)
1// index.ts
2import 'dotenv/config'
3import { Sandbox } from '@e2b/code-interpreter'
4
5//默认创建代码沙箱,过期时间5分钟
6const sbx = await Sandbox.create()
7//在沙箱中运行Python代码
8const execution = await sbx.runCode('print("hello world")')
9console.log(execution.logs)
10
11//展示沙箱/目录的文件有哪些
12const files = await sbx.files.list('/')
13console.log(files)
运行您客户端代码
1python main.py
1npx tsx ./index.ts
