Agent 沙箱 E2B SDK 兼容指南｜PPIO 文档

PPIO 沙箱服务提供了 E2B 兼容的 API（目前兼容的模块包括 Sandbox 和 Template），如果您已经在使用 E2B 沙箱并希望切换到 PPIO 沙箱，您可以使用特定版本的 E2B SDK 和 CLI 来操控 PPIO 沙箱。当然，我们建议使用 PPIO Sandbox SDK 来访问所有功能。

安装

安装 e2b SDK

# JavaScript & TypeScript
npm i e2b

# Python
pip install e2b

配置环境变量

您需要在运行代码前设置如下环境变量，来指定使用 PPIO 沙箱服务。

export E2B_DOMAIN=sandbox.ppio.cn

由于 E2B SDK 会校验 API Key 的格式，设置 E2B_API_KEY 时需要关闭 API Key 格式校验，直接使用 PPIO 的 API Key。

export E2B_VALIDATE_API_KEY=false
export E2B_API_KEY="<Your PPIO API Key>"

示例

下面示例展示了如何通过 E2B SDK 来操控 PPIO 沙箱。

from e2b import Sandbox

sbx = Sandbox.create()
execution = sbx.commands.run('ls -l')
print(execution)

sbx.kill()

import { Sandbox } from 'e2b'

const sbx = await Sandbox.create()
const execution = await sbx.commands.run('ls -l')
console.log(execution)

await sbx.kill()

最后修改于 2026年10月13日