问题库故障排查有解决方案

AI 工具请求超时或返回 429,如何逐项排查?

AI Agent

排查要点

把网络超时、供应商服务异常和限流分别检查。429 的具体原因需要结合供应商返回信息、额度与并发限制判断。

适用范围
配置排查参考;以当前工具版本和供应商文档为准。
适用系统
macOSWindowsLinux
问题类型
配置 / 兼容问题

请求超时先检查连接

确认 API 域名能从当前网络访问,并检查代理设置与供应商服务状态。通过相同供应商发送一个短请求,避免用长任务作为首次连接测试。

429 检查额度与请求频率

查看供应商的完整错误信息及重试提示,核对可用额度、每分钟请求数、Token 限制和并发任务数。降低并发后重试,避免无间隔重复请求。

记录出现时间、工具版本、模型和去除凭据后的响应信息。供应商限制与工具自身错误需要根据实际证据分别判断。

资料来源

  1. OpenAI API 错误说明