重试 on AI 观察

Agent 工具调用超时与重试：可落地的模式

Wed, 21 Oct 2026 18:19:00 +0800

超时重试不是「失败了再喊一次」，而是先分清错误类型，再与幂等键一起设计。 可重试的通常是网络抖动与限流；不可盲目重试的是业务拒绝、校验失败与已成功但响应丢失的不确定性——后者更依赖幂等。

决策顺序

为每次工具调用设明确超时。
对超时与 5xx / 限流：有限次退避重试。
对 4xx 业务错误：不要空转重试，返回给规划层改参数。
所有具有副作用的调用带幂等键（见相关幂等文）。
记录每次尝试的错误码与耗时，便于调参。

示意伪代码（虚构示意）

for attempt in 1..N:
 result = call_tool(args, idempotency_key=K, timeout=T)
 if success: return result
 if not retryable(error): raise
 sleep(backoff(attempt))
escalate_to_human_or_planner()

提示词（设计评审用）

请审查我的工具重试策略：哪些错误可重试、最大次数、退避、是否与幂等键绑定、超时如何设置。
指出可能导致重复副作用的路径。不要编造基准数字。
【策略描述】<<<>>>

实践提醒

把重试参数做成可配置项，并在仪表盘统计重试率与最终失败率。若某工具重试率突然升高，先查下游健康再调大次数。人工升级路径要在提示或工作流里写清，避免智能体空转耗尽配额。