Skill 广场
Agent工具调用排障指导 Skill

Agent工具调用排障指导.Skill

@WenyuChiou/tool-calling-tutor

4.6优秀AI 评分基础检查通过源自 GitHub

输入大模型工具调用的报错或需求,引导四分支症状排查与五步参数规范修复,解决Agent不调工具、参数错误与死循环问题。

编程正在编写大模型Agent的后端工程师基于OpenAI或Anthropic接口自研工具调用的开发者学习ReAct工作流与Agent底层原理的技术人员2026-09-29 更新main

Agent工具调用排障指导

专门面向大语言模型智能体开发者,解决在实现工具调用(Tool Calling)时遭遇的各类机制问题。用户提供代码现象或工具定义需求后,系统引导定位四类典型故障:LLM拒绝触发工具、传递参数格式或类型错误、ReAct循环死锁或漏步,以及从零规划Function Schema。无需依赖重型框架,帮助开发者理清调用边界并完成标准Schema设计。

常见场景

它能帮你做什么?

01

LLM不触发工具调用排查:当模型直接用自然语言回答而不发起工具调用时,诊断工具描述模糊度与边界重叠问题,将功能说明改写为模型适用格式。

02

工具参数类型与必填校验修复:解决模型调用工具时传递字符串、缺少字段或单位格式混乱的问题,指导补充类型约束、必填项与枚举值。

03

ReAct循环死锁与漏步排错:排查多步推理中历史消息未回填、调用ID未匹配或缺少退出熔断机制引起的Agent死循环与步骤跳过问题。

04

零基础规范化Schema设计:通过明确定义、描述视角重写、参数类型约束与错误提示链等步骤,从零编写规范的Function Calling定义。

三步完成

怎么使用

1安装 Skill

把右侧安装请求发给你的 AI。

2说清楚目标

告诉 AI 你想完成什么,或直接贴入内容。

3检查结果

按需要继续调整语气、范围或格式。

复制就能用

你可以直接这样说

“我的 Agent 接收到查天气请求后直接文字回答,根本没有触发 get_weather 工具,怎么修?”

“LLM 确实调用了我的 transfer_money 工具,但把 amount 传成了字符串且漏了 currency 字段,怎么修改 schema?”

“我的 ReAct Agent 跑起来之后一直在调用同一个搜索工具停不下来,如何定位死循环原因?”

适用人群

适合谁?

正在编写大模型Agent的后端工程师基于OpenAI或Anthropic接口自研工具调用的开发者学习ReAct工作流与Agent底层原理的技术人员

上手门槛

使用难度

进阶

需要了解任务流程,页面已整理好使用步骤。

兼容范围

支持哪些 AI?

Codex可直接使用
Claude Code可直接使用
OpenClaw可直接使用
Hermes Agent可直接使用
国内 Agent可直接使用

中文用户增强

Skill Px 做了什么?

中文说明简化使用方式补充中文案例整理安装流程降低理解难度