注册 PPIO 账号

如果您之前没有 PPIO 账号,请通过 https://ppio.cn/user/register 先进行注册,详情请参考 新手指引

创建 API 密钥

通过 PPIO API 密钥管理 页面,您可以创建 API 密钥并保存好 API 密钥的值用于后续步骤。

安装 SDK

因为 PPIO Agent 沙箱服务是兼容 E2B 协议的,所以您可以使用任何支持 E2B 协议的 SDK 来使用 PPIO Agent 沙箱服务。

您可以通过在终端执行以下命令来安装 SDK。

npm i @e2b/code-interpreter dotenv

配置环境变量

在您的项目文件夹新建 .env 文件(如果之前不存在的话),并配置 API 密钥和 API 域名地址。

通过这种方式,对于 JavaScript 和 TypeScript 项目,需要在项目中引入 dotenv/config 包;对于 Python 项目,需要在项目中引入 dotenv 库,并调用 load_dotenv 方法来加载环境变量。 详情请参考 示例

.env
E2B_API_KEY=sk_*** # 通过前面步骤获取的 API 密钥
E2B_DOMAIN=sandbox.ppio.cn # 指向 PPIO 沙箱服务地址

或者您在运行代码的命令行终端中,通过设置环境变量来配置 API 密钥和 API 域名地址。

Bash
export E2B_API_KEY=sk_*** # 通过前面步骤获取的 API 密钥
export E2B_DOMAIN=sandbox.ppio.cn # 指向 PPIO 沙箱服务地址

编写代码来启动 Agent 沙箱

下面通过一个简单的实例来展示如何通过 SDK 来创建一个沙箱,并运行指定命令;

import 'dotenv/config'
import { Sandbox } from '@e2b/code-interpreter'

const sbx = await Sandbox.create()
const execution = await sbx.runCode('print("hello world")')
console.log(execution.logs)

const files = await sbx.files.list('/')
console.log(files)

// 不再使用时,关闭沙箱
await sbx.kill()

执行以下命令来运行上面代码:

npx tsx ./index.ts