工具调用的契约设计

让模型调用工具，本质是给它一份 API 文档，文档质量决定调用质量。

参数设计

参数少而明确，必填项尽量少。枚举值写清楚，避免模型自由发挥。每个工具只做一件事。

描述

描述里写明何时该用、何时不该用，以及返回什么。模型对否定式说明的遵循度往往比想象中好。

错误返回

返回结构化错误，例如缺少参数、权限不足、对象不存在。模型能据此修正，而不是重复同样的错误调用。

副作用

写操作要求显式确认或二次校验。删除、支付、发消息这类工具，不能让模型在无人监督时自行触发。