SuperAPI AI 工具集

tool-use-guardian

部署与运维

查看项目

更新于 10-15 21:10

技能介绍

用途:Tool Use Guardian 是面向 AI 智能体的工具调用可靠性包装层,用于在外部工具调用出现截断 JSON、超时、限流或任务链中途失败时自动恢复,避免丢失推理链。

主要能力:调用前校验必填参数与类型、检查工具是否被标记为不可靠、确认请求大小在已知限制内;失败时按 9 类分类处理,包括截断 JSON 重新分页或分块获取、API 超时先简化请求重试再分解、429 限流指数退避最多 3 次、认证过期交由用户处理、任务链中断从最近成功检查点恢复、识别伪装成成功的错误响应、模式不匹配尝试自动转换并在有损时警告、网络失败带抖动重试最多 2 次、未知错误记录完整上下文并升级给用户。对多步工具链维护检查点,第 4 步失败即从第 4 步恢复而非重头开始;按工具跟踪失败模式,同类失败 3 次以上标记为不可靠并建议替代方案。

使用方式:安装命令为 npx skills add christopherlhammer11-ai/tool-use-guardian。资料建议让 Guardian 自动包装所有外部工具调用,查看可靠性报告识别不稳定工具,长链使用检查点恢复;不要对限流 API 关闭重试逻辑,不要忽略重复失败警告。

适用场景:工具调用返回截断或畸形 JSON、API 超时或限流、多步链中途断裂、需要自动重试逻辑、依赖外部工具可靠性的智能体工作流。

限制:仅在任务明确匹配上述范围时使用;输出不能替代环境特定验证、测试或专家评审;缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。资料未提供具体收费价格、平台支持范围或效果保证。