Paperclip 入门：用组织结构管理 AI Agent 团队
Paperclip 架构：任务如何变成心跳、运行与回执
沿着控制路径追踪一次工作分派，而不只看 Agent 的最终回答。
Paperclip 架构：任务如何变成心跳、运行与回执知识学习CN编辑简报更新 2026-09-26
你将学会
- 董事会提供意图
- 运行时负责执行
- 治理形成闭环
开始前需要
- Node.js 与 Agent 运行环境基础
- 不含敏感资料的测试公司
把源码阅读转成有边界、有退出条件的团队实验。
先看结论
- 心跳是控制面的事件。
- 运行完成不等于工作验收。
- 任务与运行编号使链路可审计。
董事会提供意图
目标和任务定义要完成什么，组织角色确定谁负责。README 描述了定时和事件触发，都会形成唤醒请求。每条运行记录应保留任务编号。
心跳应在调用适配器前找到合适任务。若两个 Agent 处理同一项工作，要检查任务领取与调度，而不只是责怪模型输出。
运行时负责执行
文档描述的路径会检查预算、解析工作目录、注入限定密钥，再调用所选适配器。日志、成本事件和会话状态为事后复核提供线索。
可能的故障包括没有待办、目录错误、缺少凭据或适配器出错。技术上结束的运行，也可能没有交付可用成果。
治理形成闭环
审批、评论和审计事件让人能在下一步行动前核对结果。预算阈值可暂停工作，却无法判断草稿是否正确。
图示来自 README 和服务文件的架构阅读，并不是从实际部署抓到的分布式调用轨迹。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
选一条任务并标出责任人。
- 2
在本地日志追踪入队、适配器与成本事件。
- 3
把结果和审批编号连回原任务。
可复制示例
text
issue -> wakeup queue -> budget/workspace checks -> adapter run
run -> logs + cost event -> review/approval常见问题
模型实际在哪里运行？
在适配器连接的 Agent 环境中；Paperclip 负责协调。
每次心跳都会产生新工作吗？
可能找不到合适任务，也可能被策略挡住，应检查队列和状态。
资料来源
- Paperclip / README.md来源核查 2026-09-26
- Paperclip / server/src/services/approvals.ts来源核查 2026-09-26
- Paperclip / server/src/services/budgets.ts来源核查 2026-09-26