#失败分支

工具调用契约提示法：让 AI 在按下回车之前先把「要调什么、返回什么形状、失败怎么办」写清楚——同一批任务瞎调工具从 34 次降到 4 次

Agent 最浪费钱的行为不是答错，是乱调工具：拿到一个模糊任务，不问不说，直接连着调七八个工具，其中一半是用错误参数试错，另一半是调完发现返回结构跟预期不符又重调一遍。2026 年 Agent 形态普及之后，工具调用成本已经超过文本成本，成为 token 消耗的主体。本文提出的工具调用契约提示法（Tool Call Contract Prompting）把每一次工具调用从「直接执行」改成「先声明契约再执行」：模型必须先写出一份四段式契约（意图 / 入参及其来源 / 预期返回形状 / 失败分支），契约通过自检才允许真正调用，调用后必须拿真实返回和契约比对，不符就走契约里预先写好的分支而不是临场发挥。在一个 23 个工具的企业运维 Agent 上实测：无效调用从 34 次降到 4 次，单任务平均调用轮次从 11.2 降到 5.6，token 消耗降低 41%，任务一次通过率从 47% 升到 79%。全文含契约四段式的完整定义、三种典型失败模式的拆解、可直接粘贴的模板、与 ReAct / Plan-and-Execute 的对比表，以及常见误区。