很多同学一看到 Tool 没执行成功,就习惯把问题都归成一类。但实际上,“工具选错”和“参数错误”虽然表面都像没干成,排查方向却完全不一样。前者应该先看 Tool Description、能力边界和权限;后者则应该先看 Schema、参数校验和调用前的约束。
![图片[1]-小节一:工具选错与参数错误——看起来都像“Tool 没干成”,但根因完全不同-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1782.png)
把这两个问题分开后,你在写复盘时就不会只写一句“tool failed”,而是能明确写出:到底是模型挑错了工具,还是工具没错、只是参数传坏了。
这两类错误非常常见,也最容易混在一起。
工具选错:Tool Selection Error
例如用户只是要求:
查看 app.py
模型却选择:
write_file
或者明明只是分析日志,却调用:
delete_file
这说明模型在“选能力”这一步出了问题。
典型原因可能是:
Tool 名字过于相似
Tool Description 太模糊
System Prompt 没讲清工具职责
Skill 没有规定先读后改
工具太多,选择空间过大
这类问题的修复方向通常是:
改 Tool Description
改 Tool Naming
优化 Tool Schema
缩小 Tool Registry
完善 Skill
而不是先改参数校验。
参数错误:Argument Error
另一种情况是:
Tool 选对了
但参数错。
例如:
read_file
是正确 Tool。
可模型传:
{
"path": "src/app.py"
}
真实文件却在:
app/app.py
这种就属于 Argument Error。
常见根因:
文件路径没探索
Schema 约束太弱
上下文里路径信息过时
模型猜参数
Tool Error Observation 不够清晰
修复方向更偏:
Schema Constraint
Parameter Validation
list_files / search_files
更清晰 Error Observation
为什么必须区分?
因为如果参数错,却去改 Tool 描述,通常治标不治本。
如果 Tool 选错,却只加强参数校验,也挡不住错误方向。
看 Trace 时,可以按照这个顺序:
1. 这个 Tool 本身该不该选?
2. Tool 对的话,Arguments 对不对?
3. Arguments 对的话,Tool Runtime 是否正常?
例如:
Step 07
Prompt:
需要读取项目入口文件
LLM Response:
read_file
Arguments:
{"path": "src/app.py"}
Tool Result:
FileNotFoundError
这里很清楚:
Tool Selection = 正确
Arguments = 错误
如果下一步 Agent:
list_files
→ 找到 app/app.py
→ read_file("app/app.py")
说明 Error Recovery 成功。
但如果它继续:
read_file("src/app.py")
read_file("src/app.py")
read_file("src/app.py")
问题就从 Argument Error 进一步演化成:
Recovery Failure
+
Loop Failure
这也是为什么 Agent 的失败往往不是单标签。
一个错误很容易在后续被放大。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END
















请登录后查看评论内容