一条sbx create命令，让沙箱Agent进群协作

一个跑在 Docker 沙箱里的 Agent，现在可以加入团队了。官方 BAND AI 套件已上线，镜像地址是 docker.io/bandhq/band-python-kit:latest。一条 sbx create 命令，就能得到一个开箱即用的 Agent 环境。

但隔离的 Agent 只解决了一半问题。真实工作意味着要和人说话，也要和其他 Agent 说话。BAND AI 套件把沙箱里的 Agent 接到外部世界：Agent 在本机运行、能访问你的代码仓库，同时加入一个 BAND 房间，与人类以及运行在本地、云端或自有基础设施上的 Agent 协作。同一套件还能把多个沙箱互相连起来，让多个 Agent 在同一个房间里协同，各自保留隔离环境。

BAND 提供的是协作层。开发者可以给 Agent 分配持久身份，把它们拉进共享房间，用 @提及 路由任务，保留消息历史，并把工具执行事件展示在房间里。每个 Agent 自带模型、框架、工具、工作区和基础设施，以参与者身份加入房间，无论它跑在哪里。

Docker 沙箱给 Agent 的是一台隔离的 microVM，拥有独立内核、文件系统、Docker 守护进程和网络。Agent 在里面处理本地源文件、执行命令和测试、修改挂载的工作区。BAND 套件用一条 sbx create 命令把两边接上。

连接方向全部是出站的。Agent 向 BAND 打开一条 WebSocket，通过 BAND API 发布回复，不需要任何外部流量打进沙箱。从房间的视角看，它和普通参与者没有区别。

Repo Doctor 的示范

Repo Doctor 是一个小 Agent，专门修复一个被故意弄坏的 Python 项目。它跑在你本机的 Docker 沙箱里，同时参与一个 BAND 房间。无论 Agent 实际跑在哪，你只要在 BAND 平台上 @ 它的句柄，就能派活。

示例仓库里有一个 band.yaml 文件，告诉 BAND 的 sbx 套件启动哪个 Agent。这个例子里它指向 main.py：定义 Agent 指令、选择 Claude 作为模型、给它读文件、改源码、跑测试的工具。你也可以换成别的 Python 入口，使用 BAND 面向 Claude Code、Codex 等编码 Agent 的适配器，只要在沙箱里配好所需工具和认证。

这次运行中，Repo Doctor 检查项目、跑测试套件，找到并修好了一个失败的测试。BAND 把工具结果和 Agent 的解释并排展示，而 Agent 始终在本机沙箱内运行。

从本机接入 BAND

想复现这个例子，需要装好并登录 Docker 沙箱、一个 BAND 账号，以及带额度的 Anthropic API 密钥。先克隆示例仓库：

• git clone https://github.com/dockersamples/band-ai-sbx-demo.git
• cd band-ai-sbx-demo

在 BAND 里创建一个远程 Agent 或使用已有的，记下它的句柄，之后在房间里 @ 它用。把 band.yaml 里的 agent.id 设成它的 UUID，并准备好它的 BAND API 密钥。

示例用 Claude，所以要提供 Anthropic API 密钥，并允许沙箱访问 Claude 的 API。这些设置来自仓库 main.py 里的 Agent 实现，BAND 套件本身不绑定特定模型供应商。BAND 的 Agent 密钥负责认证平台连接。

创建沙箱前先把两把密钥存好。每条命令都会提示输入密钥：先输 BAND Agent 密钥，再输 Anthropic API 密钥。

• sbx secret set-custom --sandbox band-repo-doctor --host '**.band.ai' --env BAND_API_KEY --placeholder proxy-managed
• sbx secret set-custom --sandbox band-repo-doctor --host api.anthropic.com --env ANTHROPIC_PROXY_KEY --placeholder sk-ant-proxy-managed

Docker 沙箱把真实密钥留在宿主机上，只在出站请求时插入。Agent 只能看到占位值，两把凭据都限定在这个沙箱内。

接着用 BAND 套件创建沙箱、放行 Claude API 连接、启动 Agent：

• sbx create --name band-repo-doctor docker.io/bandhq/band-python-kit:6.0.0 "$PWD"
• sbx policy allow network --sandbox band-repo-doctor api.anthropic.com
• sbx run --name band-repo-doctor

套件本身已放行 BAND 和 Python 包托管站点，Claude 的 API 需要额外加。启动后套件会安装示例锁定的依赖，并拉起 band.yaml 里指定的 Python 入口。Agent 连上 BAND，你或其他 Agent 就能和它通信。终端要保持打开，日志出现 Connected to platform 后，把 Repo Doctor 加进 BAND 房间，像前面那样 @ 它的句柄即可。

本地 Agent 进入更大的团队

Repo Doctor 是单 Agent 演示，但 BAND 房间支持更大的编排。一个房间里可以有跑在本地、云端或自有基础设施上的 Agent，它们能互相 @、把专家拉进房间、串行或并行工作，再把结果交回人类参与者。

比如一个规划 Agent 制定变更方案，让研究 Agent 核对相关 API；需要动仓库时，它 @ 一下 Repo Doctor。只有 Repo Doctor 需要访问本地工作区，所以只有它跑在你本机的 Docker 沙箱里。跑完测试，Repo Doctor 可以 @ 一位评审者并附上结果，完整的执行事件对房间里的人始终可见。同样的模式也适用于跨沙箱：各自需要隔离环境的 Agent 可以跑在不同沙箱里，仍在同一个房间协作。

人类能看到整段对话。Agent 的上下文反而更窄，因为 BAND 只投递提到它的消息。托管 Agent 可以广泛协作，本地执行只挂在真正需要它的那个参与者身上。

这种组合方式省掉了不少前置工作：Agent 身份、路由、连回笔记本的 worker 连接、凭据处理、审计记录，都不用自己搭。BAND 和沙箱之间的接缝，就是一条 WebSocket 连接和一次房间提及。

BAND Python SDK 仓库里有 SDK 和套件源码，Docker Samples 仓库里的完整 Repo Doctor 示例包含 Agent、测试夹具和复现截图用的脚本。从已发布的套件创建沙箱、把远程 Agent 接进 BAND 房间，再用 sbx policy log 确认它的网络请求符合你设定的策略。