Agent Sandbox

开始

安装，然后在极速版上创建一个沙箱

下面的命令可以直接复制。尖括号里的值换成你自己的。密钥不要写进仓库、日志或聊天记录。

安装 CLI

需要 Node.js 20 或更高版本。装好之后，abx 在终端里创建和管理沙箱。

npm install -g @agent-sandbox/cli
abx --version

配置极速版凭证

默认提供方是 alicloud-express。API Key 放在环境变量里，或交给 abx config set 写到本机 ~/.abx/.env。CLI 不读取 E2B_API_KEY。默认地域是 cn-hangzhou。

export ABX_SANDBOX_API_KEY="<YOUR_API_KEY>"
abx config set sandbox_api_key <YOUR_API_KEY>
abx config set region cn-hangzhou

用 CLI 创建

base 是极速版上的默认模板。abx exec 在 -- 后面写要执行的命令。用完销毁，避免一直占用额度。

abx create --template base
abx list
abx exec <SANDBOX_ID> -- echo hello
abx kill <SANDBOX_ID> --yes

用 Python 在极速版上创建

安装 agent-sandbox。Sandbox.create(template="base") 使用唯一内置的提供方 alicloud-express。其他提供方默认不安装，没有安装之前不要把它们传给 provider。async with 结束时会销毁这个沙箱。

pip install agent-sandbox
import asyncio
from agent_sandbox import Sandbox

async def main():
    async with await Sandbox.create(template="base") as sandbox:
        result = await sandbox.commands.run("echo hello")
        print(result.stdout)

asyncio.run(main())

接着读