AI工具故障排查：先保留说明中的关键条件

遇到AI工具输出异常或API调用失败，先别急着改提示词、重试或换模型。按顺序核对工具说明和请求记录，更容易判断问题可能出在输入、配置、网络还是结果处理。不同产品的接口规则并不相同，具体字段和限制应以当前使用的工具说明为准。 第一步，记录问题出现时的条件：使用的功能或接口、请求时间、输入内容的简要摘要和报错原文。如果有任务编号，也一并保存。不要把密钥、个人信

遇到AI工具输出异常或API调用失败，先别急着改提示词、重试或换模型。按顺序核对工具说明和请求记录，更容易判断问题可能出在输入、配置、网络还是结果处理。不同产品的接口规则并不相同，具体字段和限制应以当前使用的工具说明为准。

第一步，记录问题出现时的条件：使用的功能或接口、请求时间、输入内容的简要摘要和报错原文。如果有任务编号，也一并保存。不要把密钥、个人信息或完整敏感内容放进普通日志。密钥只保存在服务端或受保护的本机配置中，不写入网页、文章或日志。记录能够帮助复现问题的必要信息即可。

第二步，对照说明检查请求结构，留意必填字段、字段类型、输入格式、长度或内容限制，以及返回结果的解释。不要直接把其他产品的示例当作当前接口规则。若字段名称或格式不一致，先修正一处，再做小范围验证。说明没有讲清的行为应标为未知，不要自行推定。

第三步，分别检查请求是否到达、服务是否返回结果，以及本地程序是否正确读取结果。查看响应状态、错误信息和解析过程；若工具提供任务编号或结果查询方式，按说明核对已有任务。超时不能证明任务未处理或未计费，因此不要立刻重复提交，先查找可能已经生成的结果。

最后再做受控复测：固定输入和其他条件，每次只改一个设置，并记录变化。如果问题涉及模型输出是否准确，应另行核验事实；模型输出本身不等于事实证明。没有请求记录、接口说明或可复现条件时，只能列出可能原因，不能断言故障来源。自有网站的自动入库流程可用任务编号和内容摘要辅助识别重复记录，但还要结合业务规则检查，避免把不同任务误合并。