Anthropic 的 Agent 自动化参考实现:六个部件与几个容易漏掉的失败模式
Anthropic 开源了每日简报自动化的完整配置,本文按官方长文拆解六个部件、书签增量、投递确认与凭据隔离,并整理成可复用的检查清单。
让 Agent 定时运行并不难,难的是它每天都能稳定交付:不重复、不遗漏、不越权、不把失败藏在”今天没事”里。10 月 8 日,Anthropic 的 Lance Martin 与 CJ Avilla 发了一篇长文《Building effective agent automations》,用 Claude Managed Agents(beta)搭了一个”每日简报”参考实现并开源了全部配置。本文按原文拆解它的设计,中文社区已有转述(本文选题来自一篇公众号整理),但真正可复用的是那些踩过坑才写下的规则。
为什么”每日简报”值得参考
这个 Agent 做一件很朴素的事:按日程读取你指定的 Slack 频道与 GitHub 仓库,跟踪上次运行之后的变化,把值得行动的内容投递到 Slack。它几乎覆盖了定时 Agent 的全部典型失败:读取窗口错位、来源失败被静默吞掉、投递不确定导致重复、凭据泄露、以及被消息正文里的”指令”带跑。把这五件事处理对,其他自动化大多可以照搬。
六个部件
参考实现把系统拆成六块,每块对应一个配置文件:
- 来源(Sources):带名字的读取位置列表,以及每个来源的凭据引用。
- 投递目标(Destination):Agent 唯一被允许写入的地方,这里是一个 Slack 频道。
- Agent:
agent.md里的模型、工具、MCP 服务器与指令正文;指令按编号步骤写明怎么读、怎么筛、怎么投。 - 日程(Schedule):
deployment.md里的 cron 表达式与时区,例如工作日早 7:32(America/New_York)。 - 记忆(Memory):两个挂载到
/mnt/memory/的目录——你的偏好(Agent 只读)与 Agent 自己的状态(读写)。 - 护栏(Guardrails):网络白名单、只读令牌、凭据保险库与每次运行的预算上限。
整套配置由 ant apply 一次创建为 Claude API 工作区里的资源,ID 写回 claude-lock.json;之后自动化跑在 Anthropic 的基础设施上,本机不需要常开任何进程。
用书签代替时间窗
最常见的错误是让 Agent 读”过去 24 小时”。任务延迟就会漏,提前跑就会重。参考实现给每个来源维护一个书签:每次运行结束,把该来源读到的最新时间戳写进 bookmarks.json,下次从书签继续,窗口随实际间隔伸缩。书签存在 state 记忆库中,随每次运行的沙箱挂载进来。
失败读取也要写进简报
MCP 服务器挂了或令牌过期时,运行仍会启动,只是少了那个来源的工具。日志里有错误,但 Agent 什么都看不到,于是报告”今天没有新内容”——这比漏报更危险。agent.md 里有三条规则:来源失败时书签原地不动;用其他来源照常写简报;在结尾用一行说明本次读不到什么(例如 “pull requests unavailable this run”)。
投递确认与账本
自动投递最容易出两类事故:没送达却更新了进度,信息永久丢失;不确定是否送达就重试,读者收到重复简报。规则同样有三条:投递前先检查频道里是否已有今天的标题;只有 Slack 返回 "ok": true 与消息 ts 才算发送成功;确认之后才更新账本与书签。结果不明时标记为 “maybe posted”,其余状态一律不动。Agent 还在 state 里保留每次运行的记录(runs/<date>.md),写清投递前后的状态。
另外两条提升质量的规则值得抄:条目要”今天会被行动”才写,数量统计不算条目;临投递前逐条复核实时状态,已解决就删、有变化就改、无法确认就删并记入”本次删掉的内容”。链接必须从来源自身的字段复制,不允许手写拼接。
护栏:只读与凭据隔离
Agent 读的是别人写的消息,正文可能包含指令。参考实现的对策是限制它”即使照做也做不了什么”:GitHub 令牌只读;Slack 机器人令牌存在 vault 里,沙箱内只有占位符 $SLACK_BOT_TOKEN,请求离开沙箱时平台才会对白名单主机注入真实值;MCP 工具通过沙箱外的代理访问凭据。此外,部署文件里设置每次运行的预算上限(spending cap),从成本侧兜底。
从模板跑起来
需要两样东西:一个 Slack 应用(按仓库里的 manifest 创建)与一个 GitHub 令牌。流程是复制模板、用 ant apply 创建资源、在 preferences 记忆库里写入你的偏好(模板带 scripts/seed-preferences.sh),再用 ant beta:deployments run --deployment-id <id> 手动跑一次验证。或者在 Claude Code 里执行 /claude-api managed-agents-onboard https://claude.dev/blog/building-effective-agent-automations/,让技能替你完成配置。偏好文件每次运行都要重新读,不要把它烤进提示词,否则你改过的规则不会生效。
可直接抄的清单
如果你也要做定时 Agent,参考实现里最值得照搬的是下面六条规则:
- 用书签替代时间窗:按来源持久化最新已读时间戳,下次从书签继续,不要写「过去 24 小时」。
- 失败读取要声明:来源出错时书签不动,其他来源照常成稿,并用一行说明读不到什么。
- 确认后再记账:只有服务商返回成功才算送达;确认之后才更新账本与书签,不确定就标记 maybe posted。
- 账本用稳定 ID:记录上报时间、来源与不变 ID,未结项合并成一行,已结项直接消失。
- 临投递前复核:逐条确认实时状态;已解决删掉、有变化改写、无法确认删掉并记录。
- 限制爆炸半径:只读令牌、凭据入保险库且沙箱只见占位符、网络白名单、每次运行预算上限。
小结
这套参考实现真正的价值不在”每日简报”本身,而在它把自动化的可靠性问题逐条变成了可执行的规则:书签保证不重不漏,失败声明保证坏消息可见,确认机制保证状态与事实一致,凭据隔离与只读令牌把”被注入”的损失压到最小。想把这套思路用在代码评审上,可以对照我们拆解的 Claude Code 验证闭环;两者共同的关键词都是”证据先于结论”。