SuperAPI AI 工具集

anth-advanced-troubleshooting

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:该技能用于排查 Claude API 的复杂故障,包括上下文窗口溢出、工具调用失败、流式传输损坏和响应质量下降。核心方法是每次只改变一个变量(token 预算、工具 schema 与 tool_choice、流式传输、停止原因或提示配置),并产出可安全交给运维人员查看的证据。

主要能力:用 Token Counting API 预检输入 token 数,按显式策略裁剪或摘要历史消息;检查工具描述是否明确说明何时使用,必要时用 tool_choice={"type": "any"} 强制调用;对不可恢复的流式请求实现带内容追踪的重连;根据 stop_reason(end_turn、max_tokens、stop_sequence、tool_use)判断截断原因;用 curl 逐个测试模型可用性。

使用方式:在获批的沙箱工作区中,使用固定模型 ID 和合成消息/工具复现最小失败用例,记录 correlation_id,逐项变更输入并与已知良好基线对比。输出排障记录,包含 correlation_id、假设、变更变量、模型、输入/输出 token 数、停止原因、流事件数、重试次数、基线对比、金丝雀状态、回滚引用和清理状态,且提示、补全、工具输入与凭据字段需脱敏。

限制:token 计数调用失败不能证明消息调用安全,应停在预检门;部分流不得当作完整答案;工具调用响应视为不可信输入,需按允许列表校验名称与参数,副作用需审批;质量回归无法隔离时应冻结发布并回退到已知良好配置。具体收费、价格与平台支持情况暂未提供。