Agent Tools 编写指南一文章目录Agent Tools 编写指南一影响因素对照表1. 工具 name2. 工具 description回报最高3. 参数 schema4. agent instructions5. 工具数量与架构6. few-shot / 上下文排查顺序工具调用不准时提高工具调用准确率的核心公式准确率 模型能力上限× 工具描述质量最可控× 工具数量与边界架构× instructions 策略辅助影响因素对照表因素能否改影响力主要治什么模型能力换模型高上限整体理解、参数抽取工具 name能中高语义匹配工具 description能最高该不该用、和别的工具怎么区分参数 schema能高参数填错agent instructions能中策略用不用、怎么用、出错怎么办工具数量/架构能高工具多导致的干扰few-shot / 上下文能中边界情况、多轮一致性1. 工具 name用动词_名词形式search_flights、calculate用用户会说的词别用内部黑话calculate好过calc_expr_v2名字本身就是模型做匹配的强信号2. 工具 description回报最高一段好的 docstring 写四件事做什么—— 一句话什么时候用—— 正向触发场景什么时候不要用—— 负向排除最容易被忽略回报极高输入格式—— 参数长什么样、边界、示例function_tooldefunit_convert(value:float,from_unit:str,to_unit:str)-str:单位换算。适用于长度/重量/温度。 当用户说换算/转换成/等于多少并涉及两个单位时使用。 不处理货币汇率用 currency_convert不处理时区用 timezone_convert。 from_unit/to_unit 用英文缩写如 km,mile,celsius。 工具描述互相重叠是选错的最大原因。有歧义时在描述里显式互相引用“短期天气用 A多天预报用 B”。3. 参数 schema参数名要可读city好过cdate_iso好过d能enum就enum限制取值比自由文本准得多每个参数都写description说明格式真正必填的才设 required参数越受限模型填错的空间越小。4. agent instructions只写策略层不写哪个工具对应哪种说法那是 description 的活优先用工具 vs 直接回答“纯概念问题直接答不要调工具”工具结果要不要再加工出错怎么办“失败就告诉用户不要编造”多工具协作顺序不要把每种工具都枚举成 if-else又长又没用。5. 工具数量与架构单 agent 工具数 15选择准确率明显下降工具一多光改描述救不了要改架构拆 agent handoffmath_agent / weather_agent 各带自己领域的工具工具检索按用户 query 召回 top-k 相关工具只发这几个 schema给LLM选择6. few-shot / 上下文多轮场景模型会沿用前一轮参数边界情况在 instructions 给 1~2 个用户说 X → 调用 Y的例子能设默认值的参数就设默认排查顺序工具调用不准时打开 tracing/日志看模型收到什么、返回什么描述重叠导致选错 → 改 description加不要用的排除参数填错 → 加 enum / 更明确的参数描述工具太多 → 拆 agent 或做检索上面都做了还不行 → 换更强的模型