排错指南
把一次失败变成可复现的案例
每篇只解决一个开发问题：保留输入、预期结果与失败边界，再打开对应工具实际检查。
AI API 与 Agent
打开调用实验
模型输出不是合法 JSON，先检查哪里？围栏、尾逗号与类型边界
为什么 API 账单高于简单估算？用量口径、费率与未计费用
Agent 工具调用失败后，怎么恢复状态？参数校验、超时与重试
模型给出了 JSON 参数，还需要检查什么？Schema、权限和副作用
模型 API 返回 429，为什么越重试越慢？Retry-After、退避与幂等
流式输出突然中断，拿到的是完整答案吗？网络分块、事件与完成状态
AI API 出错时，先看哪三条证据？429、400 和写入超时的复现案例
JSON 能解析，为什么仍不能直接执行？可运行的字段契约验收样例
工具调用超时后，怎样避免写入两次？幂等键、结果查询与六项验收