agentbox

agentbox

你是编排器。每启动一个子 Agent，就启动一个 box（Docker 容器），并将其名称交给该子 Agent。子 Agent 会在主机上使用常规工具继续运行，但所有网页操作都必须通过 agentbox exec <box> -- <command> 执行。每个 box 都会记录每个请求、每条命令以及 Agent 自己的日志，因此你可以在汇报前核实子 Agent 提出的每项主张。

orchestrator (you)
 ├─ subagent A ──docker exec──▶ box A: terminal · Chromium · listeners · proxy tunnel ──▶ proxy ──▶ website
 ├─ subagent B ──docker exec──▶ box B: …
 └─ subagent C ──docker exec──▶ box C: …
                                  └─ /work  ==  $AGENTBOX_HOME/runs/<box>/ on the host (logs, results)

激活此技能后，按以下顺序执行

1. Docker：阅读 docker/01-preflight.md 并运行其中的检查。如果缺少 Docker 或 Docker 未运行，请停止并告知用户。切勿自行安装 Docker。
2. 工作区和镜像：阅读 docker/02-workspace.md。如果工作区尚未安装（或其版本早于此技能的版本），请根据下方文件夹中的内容生成其中列出的所有文件，然后构建镜像（docker/03-image.md）。主机 CLI 见 docker/04-cli.md。
3. 代理：阅读 proxy/01-config.md。确保 $AGENTBOX_HOME/config/proxy.json 存在，其中包含用户的代理服务、每个 box 的预算以及各项服务的费用。如果文件不存在，请向用户索取（切勿编造凭据或价格）。Box 也可以在没有代理的情况下运行，但只能使用直连模式。
4. 了解各组件，再向任何人说明任务（每个会话阅读一次，之后略读）：
   • proxy/02-routing.md：流量如何离开 box、proxy on|off、预算执行。
   • listener/README.md：如何在不触碰请求的情况下观察请求。
   • browser/browser.md：持久化浏览器及其 CLI。
   • logs/logs.md：日志内容、Agent 日志、时间线和审计。
5. 编排：遵循 subagents/orchestrator.md。使用填写完整的 subagents/subagent-prompt.md 向每个子 Agent 说明任务，其中包括代理费用表。子 Agent 必须遵循的升级阶梯见 subagents/escalation.md。
6. 审计并汇报：子 Agent 完成后，收集其对话记录，生成时间线，并根据请求日志核查每项主张（见 logs/logs.md 中的“审计”）。完成后再汇报。
7. 拆除：运行 agentbox down <box> 或 agentbox down --all。运行记录会保存在磁盘上。

文件夹结构

文件夹	内容
docker/	预检、工作区布局、Dockerfile 和镜像构建、主机 CLI
proxy/	与提供商无关的代理配置（凭据、预算、各项服务费用）、浏览器隧道、proxy 命令、预算核算
listener/	共享日志库、浏览器监听器（CDP）、curl 包装器、python 钩子、reqlog
browser/	Chromium 启动标志和 browser 命令
logs/	日志文件、Agent 日志、对话记录导入、时间线、主张审计
subagents/	编排流程、子 Agent 提示词模板、升级阶梯

始终适用的规则

• 每个子 Agent 使用一个 box。切勿让多个子 Agent 共用一个 box。
• 监听器只负责观察。流量路径中不得有任何组件，也不得为记录日志而解密 TLS。
• 每个 box 都必须选择启用代理（proxy on），且代理受预算限制。预算用完后，请求会以 HTTP 402 失败。费用是根据配置价格得出的估算值；提供商的控制面板才是准确信息来源。
• 切勿尝试绕过登录、付费墙或 CAPTCHA。应报告哪些内容受阻，以及受阻内容的后续情况。
• 遵守各网站的服务条款和速率限制。只能抓取用户有权收集的内容。
• 只有当日志显示请求在升级阶梯的每一级都失败时，子 Agent 提出的“受阻”或“不可用”主张才算成立。