让 Agent 重启后仍发送原样审批内容
作者将回复生成、人工审批与发送拆分,由 Temporal 工作流记录审批后的正文和目标地址,发送阶段不再调用模型。文章同时区分了工作流决策的确定性与外部 HTTP 请求结果的不确定性。
AI 深度解读
人已经审核过的 AI 回复,不能因为 worker 重启就让模型重新写一遍。作者在私人开源协作工具 oss-assist 中,把生成、审批和发送拆开,让 Temporal 工作流沿用已记录的回复继续执行。
但「恢复后文字不变」和「绝不重复发评论」是两回事。这篇文章值得读的地方,是作者把两条边界讲得很清楚:哪些状态已经固定,哪些发送结果还需要证据,以及当前方案究竟保证不了什么。
审核过的文字,什么时候才真正固定下来
oss-assist 的流程是:agent 起草回复,作者在笔记里修改并批准,另一个 Temporal 工作流负责发送。
下面这段流程展示了关键的数据交接点:
model proposes a reply
↓
human edits the note and marks it approved
↓
scan Activity returns destination + parsed reply body
↓
workflow schedules a posting Activity with those values
↓
posting Activity reconciles or sends, then records the URL
要看的是第三步:扫描 Activity 返回「目标位置和解析后的正文」。扫描完成、结果进入工作流历史后,发送步骤拿到的就是这组确定的值。
例如,扫描捕获的回复是:
Thanks for the reproduction. I can reproduce this with retries disabled.
要保留的是整段正文,包括 retries disabled 这样的具体表述。worker 重启后,工作流重放会使用已记录的扫描结果,不会重新读取笔记,也不会调用模型替换段落。
这里的「确定性」指工作流基于已记录的 Activity 结果作出相同决策。外部 HTTP 请求仍然可能失败,也可能出现结果未知的情况。
当前实现固定的是扫描完成后的执行快照,并没有在人工批准那一刻锁定内容。
作者读取的仍是一份可修改的笔记,批准时没有保存内容哈希。如果批准后、扫描完成前修改笔记,扫描捕获的正文可能改变。新启动一次工作流执行,也会重新扫描。
更严格的做法,是把批准的目标位置和正文保存成带版本的动作,任何一项变化都让原审批失效。作者明确说了,这是待做的改进,当前实现尚不具备这项保证。
HTTP 已经成功,为什么恢复时还可能重复发送
另一个问题发生在请求之后:远端已经创建评论,worker 却在记录成功前崩溃。此时直接重试 HTTP 请求,就可能多发一条。
作者用本地账本保存发送进度,以草稿页面为键:
- 发送前写入「处理中」条目,保存开始时间。
- 拿到评论 URL 后,用 URL 替换处理中条目。
- 再次执行时,如果账本已有 URL,就直接返回。
因此,同一个页面成功发送后,即使修改正文并重新批准,也不会产生第二次发送。这既防止重发,也限制了页面的复用方式。
如果账本只有开始时间,没有 URL,发送器会到目标位置查找:是否存在作者账号发布的、时间接近且正文匹配的评论。找到后补回 URL,无须再发一次。
恢复时,最初的时间戳不会被后续尝试覆盖。否则每重试一次都向后移动查找窗口,就可能漏掉第一次请求实际创建的评论。
作者还把发送评论与更新笔记分开。评论发出后,即使回写笔记失败,账本仍能阻止重发。账本损坏时则停止发送,不会当成空历史继续运行。
不过,这套补查机制存在一个明确缺口:处理中条目没有保存原始正文。 如果上一次发送结果未知,后续执行又读到了修改后的文字,用新正文查找就无法可靠识别旧评论。此时需要依据原始动作核对;证据不足,就得人工处理。
此外,评论可见性、查询覆盖范围、并发发送和文本匹配,都可能影响查找结果。查询与远端 API 发送并不构成一个事务,不能据此承诺任意服务上的 exactly-once,即恰好执行一次。
我的判断
我认同这条边界:模型负责提议,审批后的执行路径负责搬运具体动作。人工批准的是某段文字发往某个位置,恢复时再让模型理解一次任务,即使意思接近,也已经偏离审批对象。
但作者的方案有两个前提。第一,当前审批容许扫描前内容继续变化。第二,草稿页面可以作为一次发送的身份标识。若业务允许同一页面多次发布不同版本,页面键就不足以区分这些动作,需要重新设计动作身份。
和失败后直接重试相比,账本加远端补查多了恢复证据;但补查仍受远端查询能力约束,不能替代服务端幂等保证。
作者用 fake senders 测了几个具体边界:先记账再发送、已完成页面修改后不重发、保留首次时间戳、损坏账本阻止发送。这些测试有针对性,但没有真实服务的对照数据,也没有可靠性百分比或 exactly-once 证明。它是一份边界清晰的实现记录,不能直接当作生产可靠性结论。
能拿来做什么
- 如果你正在做 AI 起草、人工审批、自动发布的工具,可以把模型调用放在提议阶段,让发送步骤只接收明确的目标位置和正文,恢复时沿用已捕获的输入。
- 如果用 Node 编写发送任务,应区分「请求明确失败」与「请求可能成功但未记下结果」。遇到后一种情况,先依据账本和远端证据核对,再决定是否重试。
- 如果审批内容必须严格对应实际发布内容,可以保存带版本的批准动作,绑定目标位置与正文,并在任一字段变化后要求重新批准。
- 为恢复逻辑补测试时,可以优先覆盖作者列出的四个边界;对结果未知且正文已变化的情况,应保留原始动作供核对,证据不足时转人工处理。