Anthropic发布常驻代理指南,评论区:就是cron跑的小脚本
五个部件
常驻代理大部分时间在睡觉。它醒来是为了执行一次“运行”,运行发生在会话内部。
Anthropic 11 月 13 日发布了一套设计指南。它把常驻代理拆成五块:收件箱、定时器、内存、权限、发件箱。指南是设计文档,不是功能发布。
事件收件箱是一个持久化存储。webhook、计划任务和后台作业把事件发进去。每个收件箱配一个工作线程,代理睡着时事件也不会丢。
定时器是代理给自己设的后续任务,加上定期重复的计划,由调度器触发。没有人在旁边,它也能自己醒来。
内存是代理自己的存储,通常是一个文件目录,放指令、笔记、历史消息和任务进度。指南指向 Claude Code 的自动内存和 Messages API 的内存工具。
权限包括凭证注入代理、自动模式和延迟工具调用。钩子把一次调用推迟,运行结束,会话被保存下来。代理等批准的时候,不用一直占着会话。
发件箱是一张带调度器的外发消息表,或者干脆就是一个"send“工具。
发帖的人每天跑一个定时的 Claude 任务。按他的说法,五块里最弱的是内存。评论区最高票的留言把整套东西归纳成一句:”所以,就是一个从 cron 跑的小型 shell 脚本。“
玩笑挡不住故障报告。撞得最集中的一块是内存。
最先坏的是内存
gptrv 的公司跑着几个常驻 Claude Code 代理,分别管支持、代码和营销。内存是重构最多的一块。最先出事的是一个笔记文件,代理不停往里追加。文件长到代理没法可靠读取。旧事实和新事实互相打架,代理最后照着一条几周前就废弃的规则执行了。
他们的改法分两层。一层是始终加载的短列表,一行一条。另一层是按主题拆开的文件,代理只在做相关工作前打开。每个主题配一行说明,写清楚什么时候该读。
规则也跟着定死。每行带上这条知识被学会的日期;两条冲突时,新的赢;人写的行,胜过代理推断的行。代理不在任务中途写内存。会话安静之后单独跑一遍,把决策留下来。半成品的猜测,不会变成规则。
重启之后,代理第一件事是重读原始请求。在这条规则之前,一次丢了上下文的定时运行会回头来问”简报再发一次“。然后任务就永远停在那里。
Duckducklaugh 的团队用了另一套:一个事实一个小文件,外加一个始终加载的索引,每个文件占一行。代理看到哪行像相关,才打开那个文件。他们觉得最要紧的一条是,错的事实直接删掉,或者原地重写,绝不在下面补一条更正。追加更正,正是代理几周后还在执行废规则的原因。
指南给内存整理留了个名字,叫”dreaming“。
权限、定时器和发件箱
权限方面,gptrv 建议补一条:批准要绑定到确切的文本或负载。截止日期前没人批,就不发。
定时器被 ianreboot 评为最难。按钟点醒来,和这条通道负不负担得起运行,是两件事。他的后台通道跑在一个套餐上,配额按五小时一桶到账。排期于是变成了给桶做预算,选时间反而在其次。
LLM-logs 同意这个判断。通道一旦跑在配额上,”什么时候该醒“就变成”这次醒不醒得起“。调度器要把预算当输入,时钟只是输入之一。
发件箱的事故来自 Unusual-Albatross43。一种情况是,后台工作有时在启动它的那次运行结束之后才完成。代理那时写的东西,哪也没发出去。另一种是,两个代理差点回复同一条 Reddit 评论,因为每个都能自己发帖。修法是每个账户一个所有者。其他代理只起草、把文本交出去,由这一个发布。发布前先检查那条评论下有没有己方的回复。用他的话说,这就是指南里”每个收件箱一个工作线程“的规则,只是搬到了出口方向。
LLM-logs 还点出一个常被低估的接缝:调度器和收件箱之间的交互。调度器是至少一次投递。代理停机期间一个定时器触发两次,就投递两个事件。处理程序不是幂等的,后续动作就发两遍。去重要放在收件箱,按事件 ID 做,不要放在处理程序里。
他还把凭证注入代理叫作”安静的主角“。代理从不持有原始凭证,”这个代理到底能做什么“可以从代理的配置里答出来。这正好是安全审查第一个会问的问题。
已经有人拼好了
InternationalData569 做了一个 Claude Code 插件,叫 Quarterdeck,照着这套公式走。从一条提示就能拉起一个代理去干任何活。
Quarterdeck 的收件箱把目标运行排进 SQLite,重复项丢掉。监视(shell 命令,或 Gmail 这类连接器)和 webhook 启动运行。崩溃那次运行留下的事件,转到下一次。定时器支持间隔和 cron 计划,带活动时间。
内存由每次运行开头的一次”brief"调用完成。brief 带来目标的指令、它的内存、未结事项和最近几次运行的摘要。运行结束时再写一份摘要,留给下一次。
权限交给一个守卫插件。每个工具调用被分成关、提议、自动三档。提议的动作等人批准,由下一次运行执行。一次运行只要读过外部文本——网页、邮件、issue——自动动作就全部降级为提议。这一降级是为了防提示注入。
发件箱把运行报告挡在聊天之外。一条状态行、一个目标面板,只有真需要人时手机才响。
指南也照出了他自己的差距。运行给自己设后续任务、内存整理、正式的发件箱,都还在路线图上。他最喜欢的用法是让代理做自己的开发:Issue Fixer 这个目标会从仓库里取新的 GitHub 问题去处理。
关键事实
- Anthropic于11月13日发布了关于构建常驻代理的指南,将其分为五个部分:收件箱、定时器、内存、权限、发件箱。
- 该指南是设计指南,而非功能发布。
- 事件收件箱是一个持久化存储,webhooks、计划和后台任务发送事件,每个收件箱有一个工作线程,确保代理休眠时事件不丢失。
- 定时器是代理为自己设置的后续任务和定期计划,由调度器触发,使代理无需用户干预即可唤醒。
- 内存是代理自己的存储,通常是文件目录,用于指令、笔记、历史消息和任务进度。指南指向Claude Code自动内存和Messages API内存工具。
- 权限部分包括凭证注入代理、自动模式和延迟工具调用,其中钩子延迟调用,运行结束并保存会话,以便等待批准而不消耗会话。
- 指南发布于11月13日,因上周其他发布而未受太多关注。
- 帖子作者运行每日定时Claude任务,并认为内存部分最薄弱。