Agent 排障指南

LangChain Agent 循环调用导致 Token 暴涨，如何定位工具、Prompt 和重试策略？

LangChain Agent 出现循环调用和 Token 暴涨时，不能只换模型，要从工具返回、停止条件、Prompt、记忆、重试策略、并发和预算熔断逐项定位。

Claude Code 调用自定义 API 时 401/403，如何区分 Key、权限和 base URL 问题？

Claude Code 调用自定义 API 返回 401/403 时，不要只反复换 Key，要按环境变量、项目权限、base URL、模型名、网关日志和上游返回码逐项排查。

Dify 工作流里 OpenAI 节点偶发超时，如何区分模型、网关和重试问题？

Dify 工作流 OpenAI 节点偶发超时，不能只调大 timeout，应拆开模型延迟、网关转发、上下文长度、并发、重试策略和预算熔断逐项排查。

Cursor 自定义 API base URL 偶发不生效，如何从配置、模型名和日志排查？

Cursor 自定义 API base URL 偶发不生效时，不要只反复改地址，应先确认配置作用域、模型名、请求是否到达网关、缓存、代理和错误码。

Gemini API 出现 429 或 RESOURCE_EXHAUSTED，如何处理限流和预算？

Gemini API 出现 429 或 RESOURCE_EXHAUSTED 时，不要无限重试，应先确认配额、并发、模型、请求大小、重试策略和项目预算。

Codex 调用模型返回空响应或超时，如何从 Key、模型名和日志排查？

Codex 调用模型返回空响应或超时时，要先确认请求是否到达网关，再检查 Key、模型名、超时、流式输出、重试和预算。

Dify 工作流调用超时，如何从节点、模型和重试策略定位？

Dify 工作流调用超时时，不要只增加等待时间；应从节点输入、模型延迟、HTTP 超时、重试策略和网关日志定位。

Claude Code 认证失败或模型不可用，应该怎么排查？

Claude Code 认证失败或模型不可用时，要先拆开 Key、组织权限、模型名、网络、网关路由和调用日志逐项检查。

Agent 循环调用导致 Token 暴涨，如何定位工具、Prompt 和重试策略？

Agent Token 暴涨通常来自工具循环、长上下文、失败重试和无边界 Prompt，必须用日志按项目、工具、模型和状态码定位。

Cursor 自定义 API Base URL 不生效，如何从配置、模型名和日志排查？

Cursor 自定义 API Base URL 不生效时，要同时检查客户端配置、模型名、Key、网络代理、网关路径和调用日志。