阿里云智能体沙箱容器版

需安装Node 插件

在阿里云 ACS 或 ACK 的 sandbox-manager 上运行沙箱，也就是容器版。

安装

shell

abx provider install alibaba-agent-sandbox/awesome-providers//alicloud-container --allow-unpinned --yes
python -m agent_sandbox.providers install registry:alicloud-container --yes

使用

python

await Sandbox.create(
    provider="alicloud-container",
    template="<template id in the cluster>",
)

需要. 一个 sandbox-manager 域名和它的 API Key。

能力 9 项能力

沙箱

创建、连接、列出、销毁sandbox.lifecycle

调整存活时间sandbox.timeout

暂停与恢复sandbox.pause

执行

运行命令exec.run

流式输出exec.stream

进程列表与信号process.manage

交互终端pty · 不支持

文件

读写、目录、重命名files.rw

目录监听files.watch · 不支持

上传下载 URLfiles.transfer · 不支持

代码

代码解释器code.interpret

模板

读取模板templates.read · 不支持

构建模板templates.build · 不支持

网络与存储

端口访问 URLports.url

自定义域名ports.domain · 不支持

挂载存储storage.mount · 不支持

VPC 网络network.vpc · 不支持

会话

沙箱内命名命令sessions · 不支持

调用这些能力会直接返回 E8004。

配置项

密钥只从该提供方自己的环境变量读取，不会转发极速版的密钥。

名称	环境变量	说明
`domain`	`ABX_ALICLOUD_CONTAINER_DOMAIN`	sandbox-manager 域名。原生协议的 API 是 https://api.{domain}。
`base_url`	`ABX_ALICLOUD_CONTAINER_BASE_URL`	覆盖 API 源站。私有协议是 https://{domain}/kruise/api。
`api_key` 密钥必填	`ABX_ALICLOUD_CONTAINER_API_KEY`	sandbox-manager 的 API Key，放在 X-API-Key。
`protocol`	`ABX_ALICLOUD_CONTAINER_PROTOCOL`	native 用 {port}-{id}.{domain}。private 用 /kruise/{id}/{port}。 · 默认值: `native`

文档

目录提供方，id 是 alicloud-container。这不是极速版 alicloud-express。它是 ACS 或 ACK 上的 OpenKruise Agents sandbox-manager，说的是 E2B 形状的 HTTP。类型 node（provider.mjs，由宿主进程加载）。CLI 和所有 SDK 都能用：CLI 直接运行，SDK 经由本机引擎（abx provider engine serve）。

总说明：工作原理 · 安装

安装和调用

export ABX_ALICLOUD_CONTAINER_DOMAIN=sbx.example.com
export ABX_ALICLOUD_CONTAINER_API_KEY=REPLACE_ME
abx provider install alibaba-agent-sandbox/awesome-providers//alicloud-container --allow-unpinned --yes   # 或 Python：python -m agent_sandbox.providers install registry:alicloud-container --yes（索引上线后）
abx --provider alicloud-container create --template code-interpreter

from agent_sandbox import Sandbox

sb = await Sandbox.create(
    provider="alicloud-container",
    template="code-interpreter",
    provider_options={
        "domain": "sbx.example.com",
        "api_key": "REPLACE_ME",
        "protocol": "native",
    },
)

模板 id 按集群里的镜像。文档示例是 code-interpreter，不是极速版的 base。

配置

项	环境变量	说明
域名	`ABX_ALICLOUD_CONTAINER_DOMAIN`	必填，除非 `base_url` 已经给了源站
API 源站	`ABX_ALICLOUD_CONTAINER_BASE_URL`	可省略
API Key	`ABX_ALICLOUD_CONTAINER_API_KEY`	请求头 `X-API-Key`。不读 `ABX_SANDBOX_API_KEY`
协议	`ABX_ALICLOUD_CONTAINER_PROTOCOL`	`native`（默认）或 `private`

native：API 是 https://api.{domain}，数据面是 https://{port}-{id}.{domain}。创建响应里没有 envdUrl 时，适配器补 https://49983-{id}.{domain}。集群的 envd 端口如果不是 49983，命令会连错主机。

private：API 是 https://{domain}/kruise/api，数据面是 https://{domain}/kruise/{id}/49983，端口 URL 是 https://{domain}/kruise/{id}/{port}。

这个适配器会打的路径

能力	请求
`sandbox.lifecycle`	`POST /sandboxes`、查询、列表、`DELETE`。`connect` 先 POST，4xx 再 GET。列表也会打 `GET /v2/sandboxes`
`sandbox.timeout`	`POST /sandboxes/{id}/timeout`
`sandbox.pause`	`POST /sandboxes/{id}/pause` 和 `POST /sandboxes/{id}/resume`
`exec.run`、`exec.stream`	envd `POST /process.Process/Start`，`stdin: false`
`process.manage`	envd 的进程列表、标准输入和信号
`files.rw`	envd 的读、写、列目录、移动和删除
`code.interpret`	Jupyter `POST /execute`，端口 49999，读 ndjson。不是 envd 的 CodeInterpreter RPC
`ports.url`	按上面的 native 或 private 规则在本地计算

会抛出 E8004 的调用

files.watch、files.transfer、templates.read、templates.build、ports.domain、storage.mount、network.vpc、sessions。

sandbox-manager 没有 /terminal。PTY 要走带 pty 字段的进程启动，这个适配器还没接，所以清单不声明 pty。官方说明里，预签名上传下载、日志、指标和卷也不在容器版的 E2B 兼容范围内。

实测

单元测试打的是本机假 API（cli/tests/test_providers/test_node_plugins.test.ts）。真实 sandbox-manager 需要同时设置 ABX_ALICLOUD_CONTAINER_DOMAIN 和 ABX_ALICLOUD_CONTAINER_API_KEY。这台环境没有 ACS/ACK 集群，所以真实创建没有执行。没有这两项时，测试只确认适配器在发请求前拒绝，不会把极速版密钥发出去。

English

Catalog provider, id alicloud-container. This is the ACS/ACK OpenKruise Agents sandbox-manager, not Express (alicloud-express). Kind node (provider.mjs, loaded by the host). It runs from the CLI and from every SDK (through the local engine, abx provider engine serve).

export ABX_ALICLOUD_CONTAINER_DOMAIN=sbx.example.com
export ABX_ALICLOUD_CONTAINER_API_KEY=REPLACE_ME
abx provider install alibaba-agent-sandbox/awesome-providers//alicloud-container --allow-unpinned --yes   # or, Python only once the index is live: python -m agent_sandbox.providers install registry:alicloud-container --yes

Setting	Environment
Domain	`ABX_ALICLOUD_CONTAINER_DOMAIN`
API origin, optional	`ABX_ALICLOUD_CONTAINER_BASE_URL`
API key, header `X-API-Key`	`ABX_ALICLOUD_CONTAINER_API_KEY`
`native` or `private`	`ABX_ALICLOUD_CONTAINER_PROTOCOL`, default `native`

native uses https://api.{domain} and https://{port}-{id}.{domain}. private uses https://{domain}/kruise/api and https://{domain}/kruise/{id}/49983. It does not read ABX_SANDBOX_API_KEY.

Declared: sandbox.lifecycle, sandbox.timeout, sandbox.pause, exec.run, exec.stream, process.manage, files.rw, code.interpret, ports.url. run_code is Jupyter POST /execute on port 49999. pty is not declared; sandbox-manager has no /terminal.

Unit tests use a local fake API. A live create needs both the domain and the API key. This environment has no ACS/ACK cluster, so that create did not run. The example template id is code-interpreter, not Express base.