用途:面向 Claude(资料标题写作 clade)API 集成的高级排障,处理超出基础错误处理的复杂问题,包括输出不一致、工具调用失败(调用不存在的工具)、流式连接中断、max_tokens 截断以及图像/视觉格式问题。
主要能力与处理方式:
- 输出不一致:原因为 temperature 默认 1.0(最高随机性),可将 temperature 设为 0 获得确定性输出。
- 工具调用失败:执行前校验工具名称是否在已定义工具列表中,未知工具应通过 tool_result 带 is_error: true 返回错误信息。
- 流式连接中断:遍历流事件时检测是否出现 message_stop,未出现视为连接掉线并可重试。
- max_tokens 截断:检查 stop_reason 是否为 max_tokens,可选增大 max_tokens、在系统提示中要求简洁,或用另一次调用继续。
- 图像/视觉问题:最大图像 5MB,支持 PNG、JPEG、GIF、WebP,每次请求最多 20 张图,data 字段须为原始 base64(不含 data URI 前缀),media_type 须与实际格式一致。
使用方式:按资料步骤先阅读各模式代码示例,再按需集成到自身代码库并逐项测试,最后运行测试套件验证。前提是已完成基础错误处理并熟悉 Claude API 响应结构,且可访问含完整请求/响应数据的日志。基础错误处理可参考 clade-common-errors,证据收集可参考 clade-debug-bundle。
限制:资料未提供具体价格、平台支持范围、模型可用性及性能数据,以上均暂未提供;示例代码中的模型名称为 claude-sonnet-4-20250514,实际使用需按自身环境确认。