tool-call-retry_AI Agent skill-PHP中文网

tool-call-retry

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

自动重试并修复LLM工具调用，指数退避策略，格式验证与错误纠正，提升工具调用成功率90%

🔥 工具调用自动重试器

功能概述

🔥 工具调用自动重试器是一项面向实际任务的技能，主要用于✅ 成功率提升90%+ ：内置指数退避重试、格式校验、错误自动修复，解决Agent工具调用不稳定的核心痛点；🛡️ 全链路异常兜底：自定义错误处理、参数修复逻辑，支持复杂场景下的错误自愈；

核心要点

⚡ 零侵入增强：无需修改原有工具代码，一行封装即可获得重试能力，性能开销<1ms；
🔑 幂等性保证：支持幂等性键，避免重复调用导致的副作用；
🎯 适用场景；

使用与执行

所有调用外部AP。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

结果检查与注意事项

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

🔥 工具调用自动重试器

核心亮点

✅ 成功率提升90%+：内置指数退避重试、格式校验、错误自动修复，解决Agent工具调用不稳定的核心痛点
🛡️ 全链路异常兜底：自定义错误处理、参数修复逻辑，支持复杂场景下的错误自愈
⚡ 零侵入增强：无需修改原有工具代码，一行封装即可获得重试能力，性能开销<1ms
🔑 幂等性保证：支持幂等性键，避免重复调用导致的副作用

🎯 适用场景

所有调用外部API/工具的Agent场景
不稳定的第三方服务调用
大模型工具调用格式错误自动修复
高可靠性要求的Agent执行链路

📝 参数说明

参数	类型	必填	默认值	说明
toolFn	Function	是	-	要执行的工具函数，返回Promise
args	any	否	{}	调用工具的参数
maxRetries	number	否	3	最大重试次数，1-10
initialDelayMs	number	否	1000	初始重试延迟，100-10000ms
validatorFn	Function	否	()=>true	结果校验函数，返回true表示结果合法
errorHandlerFn	Function	否	undefined	错误处理函数，可返回修复后的参数或中止重试
idempotencyKey	string	否	undefined	幂等性键，相同键的调用只会执行一次

💡 开箱即用示例

基础用法（零配置）

const fetchWeather = async (params: { city: string }) => {
  const res = await fetch(`https://api.weather.com/${params.city}`);
  return res.json();
};

const result = await skills.toolCallRetry({
  toolFn: fetchWeather,
  args: { city: "Beijing" }
});

带结果校验

const result = await skills.toolCallRetry({
  toolFn: callLLM,
  args: { prompt: "Generate JSON output" },
  validatorFn: (res) => typeof res === "object" && res !== null && res.code === 0,
  maxRetries: 5
});

高级用法（错误自动修复）

const result = await skills.toolCallRetry({
  toolFn: callDatabase,
  args: { sql: "SELECT * FROM users" },
  errorHandlerFn: async (error, attempt) => {
    if (error.message.includes("SQL syntax error")) {
      // 自动修复SQL语法
      const fixedSql = await fixSqlWithLLM(error.message);
      return { args: { sql: fixedSql } };
    }
    if (attempt >= 2) {
      // 重试2次失败后中止
      return { abort: true };
    }
  }
});