Agent 异步支付如何避免重复扣款
文章以支付已成功但调用方超时的案例,介绍用持久化记录保存交付归属和完成状态,并要求规划器执行前读取。进一步测试推送通知重复、延迟及执行中到达时的行为,讨论通知与状态查询的分工。
AI 深度解读
一笔 29 美元的扣款已经成功,负责付款的程序却在等了 1 秒后把结果记成 UNKNOWN。付款回执用了 2.5 秒才到。如果下一轮计划只看这条超时记录,同一笔钱就可能再扣一次。
作者用同一套小实验比较了三种做法。规划器在下一步前主动查状态,以及收到通知后再查状态,都只扣了一次。只有记录更新、规划器却没去读的那版扣了两次。对写任务队列或 AI 工具调用的人来说,这篇最实用的地方,是讲清了该在哪一刻重新读状态,以及两次通知撞在一起时怎么避免漏掉一次。
下一步要根据哪条记录来计划?
实验里的规划器(planner)按三步执行:发起付款、给客户发送确认、报告结果。超时后,它手上的执行结果是 UNKNOWN,只说明等待结束时还没有收到回执。晚到的回执会更新一条认领记录(claim row),其中记着谁负责这次交付、交付是否已完成。规划器在决定下一步前读取这条记录,才能知道先前那次付款已经完成,接下来可以发确认。
作者用同一笔 29 美元付款和同一个慢响应接收方做了三版对照。主动读取(pull)版和通知后读取(push)版都只完成一次付款,随后进入第 2 步。只记录更新的版本也有认领记录,但规划器没读,结果发送了两次付款。只要下一步会产生外部副作用,规划器就该用认领记录里的最新状态来做决定。
这也划清了两条链路的职责。通知负责提示缓存可能过期,读取负责取回当前状态。即使通知带着 status done,它也只是发送当时观察到的状态。等接收方处理这条消息,记录可能已经更新了一次。两者有出入时,以记录为准。
通知在步骤中途到达,要立刻重排吗?
付款回执在 2.5 秒时把记录改成 done,监听器送出一条 version 2, status done 通知。大约第 3 秒,通知进入收件箱,此时第 1 步还在起草确认说明。作者让它继续执行,到第 4.5 秒结束时才集中处理收件箱、重读认领记录,并用读到的状态规划第 2 步。
能这样等,有一个明确前提:正在运行的步骤有自己的交付键和去重保护。贸然中断会留下做了一半的工作,随后还得弄清哪些动作已经发生。实验把重新读取放在两个步骤的交界处,既让当前步骤做完,也让后续决策用上新状态。
第 2 步进行到一半,监听器又送来了同一条 version 2, status done。收件箱一共四行,版本顺序为 1、2、2、3。规划器上一次实际读到的版本已经是 2,第二份版本 2 因此被判为重复。这里的比较基准是「已经读到的版本」,因为收到一条消息和真正刷新本地状态是两件事。
读完状态以后,为什么还可能吞掉一条通知?
规划器用一个标记记住缓存过期了,等到下一处步骤边界再读记录。正常情况下,读到目标版本后就该清掉标记,否则后面每一步都会白读一次,新通知也很难再触发一次独立的刷新。
麻烦出在「读完」和「清标记」之间。假设规划器刚读到版本 2,版本 3 的通知马上把标记更新了。如果规划器紧接着直接重置,版本 3 的提醒就被一起抹掉,此时缓存仍停在版本 2。这次竞态在正常运行中没有撞到,作者另外写了测试,用相同的时序对比两种清除方式。直接重置丢了版本 3,比较并交换(compare-and-swap)则发现当前标记已经变了,拒绝清除,让版本 3 留待下次处理。作者说两种实现只差五行。
还有一种情况是收件人已经退出。作者在第 1 步之后杀掉规划器,随后在第 5.4 秒从外部把认领记录从版本 2 更新到版本 3。监听器发现心跳过期,确认进程已经结束,就把版本 3 的通知写到兜底负责人的文件。旧收件箱里仍留着未读的版本 1 和 2。这组实验验证了退出后的消息分流,兜底负责人怎么接手、怎样判断原任务可否恢复,原文没有展开。
我的判断
对这个付款例子,我会先把步骤边界上的主动读取做扎实。只写日志的版本扣了两次,说明真正起作用的是下一步读到了完成状态。在这套实验里,推送确实让规划器更早收到提醒,但两版都在规划第 2 步时作出同一个决定。原文没有给出推送让下一步提前了多少,也没有比较轮询频率、读库开销或通知延迟。更快察觉状态变化有价值,值不值额外维护一条通知链路,仍是经验判断。
还有个容易带进项目的误解:这里的主动读取只覆盖规划器确实经过的决策点。如果 Node worker 在另一个超时分支直接重试付款,那个分支也得先确认本次交付的状态。实验中的步骤已经有交付键和去重保护,作者也只测了一套小环境。多 worker 同时处理同一笔交付时,认领和去重怎么配合,原文没有验证。
能拿来做什么
- 给会扣款、发信或提交外部记录的 AI 工具调用保留同一个交付键。工具超时就把这次执行标成
UNKNOWN,在进入下一步或决定重试前,先查这次交付是否已经完成。 - 在 Node worker 里接入队列通知时,让消息携带记录版本,并在步骤边界用已读版本去重。刷新后清除待处理标记时,确认它仍对应刚处理的版本,并用一条固定执行顺序的测试覆盖读完后立即收到新通知的情况。
- 如果用了每个进程独有的收件箱,就测试 worker 在步骤结束后退出的情形。确认监听器发现心跳过期并核实进程退出后,能把新通知送到有明确负责人的位置。