小节一:工具选错与参数错误——看起来都像“Tool 没干成”,但根因完全不同

很多同学一看到 Tool 没执行成功,就习惯把问题都归成一类。但实际上,“工具选错”和“参数错误”虽然表面都像没干成,排查方向却完全不一样。前者应该先看 Tool Description、能力边界和权限;后者则应该先看 Schema、参数校验和调用前的约束。

图片[1]-小节一:工具选错与参数错误——看起来都像“Tool 没干成”,但根因完全不同-大赛人网

把这两个问题分开后,你在写复盘时就不会只写一句“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
喜欢就支持一下吧
点赞13 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容