提升 Agent 工具调用准确率的 10 个实战技巧：从命名规范到参数描述调优

为什么模型总是“误解”工具？

大模型没有眼睛，它完全依赖工具的 name、description 以及参数字段的 description 来进行语义匹配。

---

10 个高频生效的工程调优法则

1. 明确的动宾命名法：使用 search_codebase 而非笼统的 code_helper，使用 fetch_user_profile 而非模糊的 user_data；
2. 在工具描述中明确写出“反例（When NOT to use）”：例如：“用于搜索具体的类名或函数，如果你想找特定 Git 提交记录，请使用 search_git_commits 代替”；
3. 参数必填项收敛（Avoid Optional Ambiguity）：能设定默认值的参数务必设定默认值，必填字段尽量控制在 3 个以内；
4. 优先使用枚举值（Enums）替代自由文本：例如 sort_by 字段严格限制为 ["created_at", "views", "stars"]；
5. 在入参描述中给出合法样例（Examples）：例如 date_range: "YYYY-MM-DD 格式，例如 2025-01-01"；
6. 避免功能高度重叠的近义工具；
7. 在输出中返回结构化状态码与明确指导；
8. 限制单次返回数据体积，避免冲垮上下文；
9. 善用类型收敛，能用 boolean 不用 string；
10. 给工具附加分类前缀，辅助模型层次化检索。