Agent 工具调用的幂等设计：超时后也不重复产生副作用

核心判断

只要工具会付款、发消息或写数据，就必须把网络超时视为结果未知而不是简单失败。

落地步骤

生成幂等键；先查状态；持久化意图；重试复用键；为旧接口设计补偿。

完成前检查

确认负责人、数据与权限边界、失败恢复、可观测信号和回滚条件；用一次真实样例完成端到端验证，再扩大范围。

一手资料

https://developer.mozilla.org/en-US/docs/Glossary/Idempotent