​
注册 PPIO 账号

如果您之前没有 PPIO 账号，请通过 https://ppio.com/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