AI Agent 故障排查：日志、权限和 API Key 检查

AI Agent 出错时，不要先重装。第一步看日志：请求是否发出、模型是否返回、工具是否被调用、错误发生在认证、网络、解析还是写文件阶段。日志能把问题从“感觉不可用”变成“某一步失败”。

实践要点

第二步检查权限和密钥。API Key 是否过期，额度是否足够，环境变量是否被当前终端读取，工具是否有访问目录、浏览器、数据库或网络的权限。很多问题只发生在后台任务或服务进程中，因为它们读取不到用户终端里的变量。

第三步缩小任务。把复杂请求拆成单步：先让 Agent 读取文件，再调用工具，再写入结果，再运行验证。每一步都能通过后，再组合成完整工作流。

后续内容

这是一篇种子文章，后续会围绕“AI Agent 故障排查：日志、权限和 API Key 检查”补充更完整的操作截图、命令、配置示例和问题排查记录。