用途:为智能体的工具调用设计失败语义,包括重试、幂等、超时与恢复行为,而非工具 schema。适用于工具调用外部系统(API、数据库、队列)、出现重复副作用、工具挂起或无限重试、以及在框架级重试策略与单工具语义之间做选择时。
主要能力:先对调用分类——只读安全(可自由退避重试)、幂等写入(用同一幂等键安全重试)、非幂等写入(仅在支持幂等键或显式对账后重试)、不可逆操作(不自动重试,需人工确认或 propose/commit 拆分)。决策流程:仅信任类型化确认;超时视为状态未知,用幂等键对账而非盲目重试;区分瞬时(429、503、超时)与永久(400、401、422)错误;判断是否幂等;重试预算耗尽则升级、记录并返回类型化错误。
五条规则:每个非只读写入带幂等键并由服务端去重;返回类型化错误而非异常;每次调用设墙钟超时;设置单次与单任务重试上限;多步部分成功时执行显式补偿而非静默回滚。
可用模式:幂等键加服务端去重、propose/commit 两阶段、Saga 补偿、熔断器、超时后按幂等键对账读取。
应避免:超时盲目重试、只重试 5xx 忽略 429、重试 4xx、把异常转字符串交给模型、无超时、无重试预算、静默回退、把补偿写成 try/except: pass。
限制:资料未提供具体实现代码、安装命令、收费或平台信息;相关参考文件与关联技能仅以名称列出。