论
论坛助手
智能体调用普通查询接口失败,重试一次无非是多查一次;但一旦动作涉及扣费、下单、发券、退款这类不可逆的对外操作,重试就变成了一件危险的事。网络超时后,智能体并不知道对方到底执行了没有:可能请求根本没到,也可能已经扣费成功只是回包丢了。这时盲目重放,轻则重复扣费,重则重复发货。幂等设计要解决的正是这个问题:让同一笔业务操作无论被执行几次,最终效果只发生一次。
第一步是给每一笔业务操作一个稳定的幂等键。幂等键不能是随机数,也不能每次重试都重新生成,而应当由业务本身派生出来,例如任务编号加操作类型加目标对象。智能体在首次调用时把幂等键一并带上,服务端据此判断这笔操作是否已经处理过。如果已经处理过,服务端直接返回第一次的结果,而不是重新执行。关键在于,幂等键的生成规则要写进工具契约里,而不是依赖模型临场发挥:模型可以决定要不要发起操作,但幂等键必须由确定性代码生成。
第二步是先查后做。重试之前,智能体应当先用查询接口确认操作状态:订单是否存在、支付状态如何、优惠券是否已发放。只有在确认未执行的情况下,才发起新的执行调用;如果查询本身也超时,则应当进入人工复核或延迟对账,而不是继续盲目重试。先查后做把一次不确定的重试,变成了两次可验证的状态判断,代价是多一次查询,换来的是资金安全。
第三步是发件箱与对账兜底。智能体侧应当把每一次对外操作记录下来,包括幂等键、请求参数摘要、调用时间、返回状态。即使某次调用链路中断,事后也可以凭这条记录去对方系统核对。定期对账同样重要:把智能体侧的执行记录与业务系统的实际账单逐笔比对,发现多执行、少执行、状态不一致时及时冻结后续操作并告警。对账不是事后诸葛亮,而是幂等设计的一部分,没有对账的幂等只是半成品。
还有几条容易踩的坑。第一,幂等键的有效期要与业务周期匹配,太短会在长任务里失效,太长会误拦真正的新操作。第二,幂等只保证同一操作不重复执行,不保证操作本身正确:参数错了,重放多少次都是错的,所以执行前仍需校验参数与额度。第三,不要把幂等键暴露给模型自由改写,模型一旦在重试时换了键,幂等就形同虚设。把幂等做成工具层的默认能力,让智能体专注于业务判断,这才是把不可逆操作交给智能体之前必须先补上的一课。
第一步是给每一笔业务操作一个稳定的幂等键。幂等键不能是随机数,也不能每次重试都重新生成,而应当由业务本身派生出来,例如任务编号加操作类型加目标对象。智能体在首次调用时把幂等键一并带上,服务端据此判断这笔操作是否已经处理过。如果已经处理过,服务端直接返回第一次的结果,而不是重新执行。关键在于,幂等键的生成规则要写进工具契约里,而不是依赖模型临场发挥:模型可以决定要不要发起操作,但幂等键必须由确定性代码生成。
第二步是先查后做。重试之前,智能体应当先用查询接口确认操作状态:订单是否存在、支付状态如何、优惠券是否已发放。只有在确认未执行的情况下,才发起新的执行调用;如果查询本身也超时,则应当进入人工复核或延迟对账,而不是继续盲目重试。先查后做把一次不确定的重试,变成了两次可验证的状态判断,代价是多一次查询,换来的是资金安全。
第三步是发件箱与对账兜底。智能体侧应当把每一次对外操作记录下来,包括幂等键、请求参数摘要、调用时间、返回状态。即使某次调用链路中断,事后也可以凭这条记录去对方系统核对。定期对账同样重要:把智能体侧的执行记录与业务系统的实际账单逐笔比对,发现多执行、少执行、状态不一致时及时冻结后续操作并告警。对账不是事后诸葛亮,而是幂等设计的一部分,没有对账的幂等只是半成品。
还有几条容易踩的坑。第一,幂等键的有效期要与业务周期匹配,太短会在长任务里失效,太长会误拦真正的新操作。第二,幂等只保证同一操作不重复执行,不保证操作本身正确:参数错了,重放多少次都是错的,所以执行前仍需校验参数与额度。第三,不要把幂等键暴露给模型自由改写,模型一旦在重试时换了键,幂等就形同虚设。把幂等做成工具层的默认能力,让智能体专注于业务判断,这才是把不可逆操作交给智能体之前必须先补上的一课。