教程2026-11-14 · 智涌AI

常驻 Agent 怎么搭:收件箱、定时器、记忆、权限、发件箱

常驻 Agent 教程头图:左侧大字「常驻 Agent 五个部件」与 5 个核心部件、每个收件箱 1 个活跃 worker、长任务单题成本降 78% 数据卡;右侧流程图展示事件收件箱、worker 启动 run、写记忆和发件箱的循环

想让 Agent 帮你盯邮件、到点出日报、等对方回复后接着干,光有一个对话循环不够。Anthropic 在 11 月 13 日发了一篇架构说明《Building always-on agents》,把这类「常驻 Agent」拆成五个部件:事件收件箱、定时器、记忆、权限、发件箱。这篇按这五个部件讲每一块该存什么、怎么串起来,以及最容易踩的几个坑,适合正在给自己产品加「主动型 Agent」的开发者。

「一直在线」只是体验,背后是睡醒循环

Anthropic 的定义是:常驻 Agent 有状态、会主动,能跨会话管理上下文,不需要人盯着就能行动。底层用的还是普通 Agent 那套循环,区别全在外围架构:什么时候醒、两次运行之间带走什么、结果怎么送到用户手里。

文章特意说明,它其实没有一直挂着。每次干活叫一个 run:收到事件、完成任务、保存发生了什么。run 发生在某个 session 里,session 就是消息和工具调用的记录。跑完就睡,下一个事件来了再醒。模型不在线时不花钱,这也是这类 Agent 现在跑得起的原因之一:官方举的例子是,在一个长周期编程基准上,Opus 5.5 每解决一个任务的成本比 Opus 5 低 78%,常规负载只低 40%。

收件箱:所有触发源先排队

最直觉的写法是让 webhook、定时任务、后台作业各自直接调 Agent。问题是两个事件同时到会启动两个互相打架的 run,进程一崩事件就丢了。收件箱的最简版本有三样东西:

官方建议先按「一个用户一个收件箱」起步,需要更多并行再拆。用户回复这类延续旧工作的事件,恢复原来的 session;其他事件开新 session。四条实操要点:

要点为什么
handler 快速确认webhook 提供方会把慢响应当失败重发;提示词注入检查这类重活放进 run 里做
收件箱是唯一事实来源worker 醒来先从表里拉最新事件,中途挂掉,新 worker 能接着重试同一事件
一个收件箱只有一个活跃 worker防止两个 run 重复干活或互相覆盖;中途来的新事件可以留到下一轮、并进当前轮,或打断重来
批量处理待办事件用户连发三条消息,合成一次 run,Agent 只回一次

定时器:让 Agent 主动,但别让它自己起床

定时器分两类:follow-up 是 Agent 给自己定的截止时间,比如「三小时后看看对方回没回」;schedule 是固定节奏的任务,比如每天的简报。两者可以共用相近的表结构,schedule 多存一个重复规则。

定时器本身不直接启动 run。由一个调度器按固定间隔扫表,每轮做三件事:找出到期的定时器;follow-up 标记完成,schedule 把下次触发时间往后推;往收件箱写一个事件并叫醒 worker。这样所有 run 仍然只有收件箱这一个入口。调度器可以自己写,也可以用现成的持久化执行引擎。

定时器、用户消息、webhook 最后都变成收件箱里的一行,Agent 只认这一个入口。

记忆:只存查不回来的东西

常驻 Agent 靠记忆在一次次断开的 run 之间保持连贯。Anthropic 自家的做法(Claude Code 的 auto memory、Messages API 的 memory tool)是一个文件目录;常驻场景下这个目录要映射到数据库或对象存储,保证 worker 换了记忆还在。经验法则是:别的系统里已经有的(比如工单),只存一个指针。官方列了四类:

每次 run 都要先装进系统提示词、工具定义和记忆文件,这部分开销次次都付,官方建议保持精简并开提示词缓存。session 太长时可以压缩旧消息或开新 session,两种都会丢细节,所以要留的东西随手写进记忆。记忆写宽了也有风险,站内的 Agent 记忆陷阱 讲过一次性授权被记成永久规则的问题,可以对照着定写入规则。

权限:凭证不进环境,大事挂起等人

文章说权限是常驻 Agent 风险最大的地方:一个 run 拿着用户的权限,而且设计上就是没人看着。每个工具调用都要判断是自己执行、拦下,还是等批准。三个组件:

  1. 凭证存储:推荐在 Agent 环境之外放一个代理,Agent 发不带凭证的请求,代理转发前注入真实凭证。
  2. 自动模式:参照 Claude Code 的 auto mode,用分类器审查高风险操作,拦下危险的让模型换安全做法;最重要的决定仍由用户拍板。
  3. 挂起的工具调用:Claude Code 里 hook 可以把一个工具调用挂起等用户输入。常驻 Agent 同理:调用挂起时 run 结束、session 停在调用中途保存;请求推给用户(比如用 MCP Apps 做的交互卡片),用户的答复作为新事件回到收件箱,新 run 恢复原 session 继续。等待期间 worker 照常处理别的事件。

用 Claude Code 的读者可以先从 hooks 护栏 和 MCP Apps 交互卡片 两篇入手,这两块正好对应权限里的拦截和审批界面。

发件箱:先安静,再慢慢多说

普通 Agent 会把推理和工具调用流式展示给用户;常驻 Agent 在后台干活,用户只需要结果和少量细节。一个 run 有三种结局:往发件箱发消息、判断不需要发、或用挂起调用请求批准。

多数场景一个直接投递的 send 工具就够了。需要控制发消息节奏、或让 Agent 能从出错中恢复时,再上正式的发件箱:一张待发消息表,加一个类似 worker 的 dispatcher 决定发什么。发太多会吵,发太少会漏,官方建议用评测找平衡点,开局宁可安静一点,再逐步争取用户的注意力。

动手:让编程 Agent 搭一个骨架

想快速起个原型,可以把下面这段交给 Claude Code 或 Codex,按自己的技术栈改:

按「事件收件箱 + 定时器 + 记忆 + 权限 + 发件箱」搭一个常驻 Agent 骨架:
1. events 表:id、user_id、source、source_event_id(唯一,用于去重)、payload、status、session_id
2. timers 表:id、user_id、kind(followup|schedule)、due_at、recurrence、status
3. POST /events:只校验并写表,立即返回 200,然后唤醒 worker
4. worker:每个 user 同一时间只跑一个;先从 events 拉全部 pending,合并成一次 run;
   回复类事件恢复原 session,其余开新 session;run 结束后标记 done
5. scheduler:每分钟扫 timers,followup 置 done,schedule 推到下次时间,各写一条 event
6. 记忆目录:instructions.md、notes/index.md、sent.md、tasks/<id>.md,放对象存储
7. 敏感工具调用走凭证代理;删除、付款、对外发消息先挂起,生成审批事件
先写测试覆盖:并发事件、worker 中途崩溃重试、重复 webhook 去重。

常见坑

完成标准

最后

如果你已经有一个只会被动回答的 Agent,先别加新功能,花半天把「事件表 + 单 worker」这一层补上,其他四个部件都建在它上面。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。