https://ai.wujiong.cc/tags/%E9%99%8D%E7%BA%A7/Recent content in 降级 on AI 观察Hugozh-CNMon, 19 Oct 2026 18:08:00 +0800https://ai.wujiong.cc/posts/2026-10-19-agent-tool-timeout-handling/Mon, 19 Oct 2026 18:08:00 +0800https://ai.wujiong.cc/posts/2026-10-19-agent-tool-timeout-handling/<p><strong>超时策略是产品体验，也是正确性。</strong> 工具调用卡住时，Agent 若只会「再试一次」，可能把支付、发信等副作用打成双份。</p> <h2 id="分层设置">分层设置</h2> <table> <thead> <tr> <th>层</th> <th>建议</th> </tr> </thead> <tbody> <tr> <td>单次工具 HTTP</td> <td>明确 timeout + 可取消</td> </tr> <tr> <td>Agent 步级</td> <td>单步墙钟上限</td> </tr> <tr> <td>整任务</td> <td>全局预算，到点总结已得结果</td> </tr> </tbody> </table> <h2 id="处理剧本">处理剧本</h2> <ol> <li><strong>可安全重试</strong>（只读查询）：有限次退避，参见 <a href="https://ai.wujiong.cc/posts/2026-10-19-agent-retry-backoff-checklist/">重试退避清单</a>。</li> <li><strong>有副作用</strong>：超时后先查幂等键/状态，勿盲重放；见 <a href="https://ai.wujiong.cc/posts/2026-10-19-agent-idempotent-tool-calls/">幂等工具调用</a>。</li> <li><strong>对用户</strong>：说清「哪一步超时、已保留什么、可选改走手工」。</li> </ol> <h2 id="提示策略片段">提示/策略片段</h2> <div class="highlight"><pre tabindex="0" style="color:#e6edf3;background-color:#0d1117;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>若工具在 {{N}}s 内未返回： </span></span><span style="display:flex;"><span>- 停止等待该调用 </span></span><span style="display:flex;"><span>- 记录 tool_name、timeout、是否已知副作用 </span></span><span style="display:flex;"><span>- 若只读：可按退避重试至多 {{K}} 次 </span></span><span style="display:flex;"><span>- 若写操作：改为 status_check 工具，禁止重复 submit </span></span><span style="display:flex;"><span>- 向用户输出降级说明，不要假装成功 </span></span></code></pre></div><h2 id="与结果截断">与结果截断</h2> <p>超时和「返回过长被截断」不同，后者见 <a href="https://ai.wujiong.cc/posts/2026-10-19-agent-tool-result-truncation/">工具结果截断</a>。</p>