SuperAPI AI 工具集

tool-use-guardian

智能体与模型

查看项目

更新于 10-16 03:50

技能介绍

Tool Use Guardian 是一个面向 AI 智能体的工具调用可靠性包装层。其定位是监控工具调用、自动重试失败、修复被截断的响应,并学习哪些工具不可靠,从而避免智能体在任务中途丢失思路。该技能由 Genesis Agent Marketplace 构建,宣称永久免费。

【用途】 当工具调用返回被截断或格式错误的 JSON、当 API 超时或对智能体限流、当多步链在中间断开、当需要自动重试逻辑而无需自行编写、或任何依赖外部工具可靠性的智能体工作流时,都可以使用该技能。

【主要能力】

  1. 调用前校验:在每次工具调用前,校验必需参数是否存在且类型正确、该工具是否因先前失败被标记为“不可靠”、请求大小是否在已知限制内。
  2. 失败分类与恢复:当工具调用失败时,将其归类为 9 种失败类型之一并执行对应恢复动作——截断 JSON 使用分页或更小分块重新获取;API 超时以更简单请求重试一次、再拆解任务;限流(429)采用指数退避、最多重试 3 次;鉴权过期标记为需用户介入;链中断从上次成功检查点恢复;错误伪装成 200 时检测以成功形态出现的 {"error": "..."};模式不匹配尝试自动转换、若有损则告警;网络故障带抖动重试、最多 2 次;未知错误记录完整上下文并上报用户。
  3. 链保护:对多步工具链维护检查点。若 7 步中的第 4 步失败,则从第 4 步恢复,绝不从头重启。
  4. 学习:按工具追踪失败模式。同一类型失败超过 3 次后,将该工具标记为不可靠并建议替代方案。

【使用方式】 安装命令:npx skills add christopherlhammer11-ai/tool-use-guardian

【最佳实践】 让 Guardian 自动包装所有外部工具调用;查看 Guardian 的可靠性报告以识别不稳定的工具;对长链使用检查点恢复。不要为限流 API 禁用重试逻辑;不要忽略重复出现的失败警告。

【相关技能】 @recallmax — 长上下文记忆增强(同样来自 Genesis Marketplace,免费)。

【限制】 仅当任务明确匹配上述范围时使用本技能。不要将输出视为环境特定验证、测试或专家审查的替代品。若缺少必需的输入、权限、安全边界或成功标准,应停止并请求澄清。

【链接】 仓库:https://github.com/christopherlhammer11-ai/tool-use-guardian Marketplace:https://genesis-node-api.vercel.app 浏览技能:https://genesis-marketplace.vercel.app