智能体调用外部工具前的参数自查：少踩一次坑

智能体调用外部工具出问题，很多时候不是工具本身坏了，而是传进去的参数不对：少了一个必填字段、多了一位小数、日期格式差了一个字符，工具返回报错，智能体又拿着报错去猜，几轮下来时间和 token 全浪费在修参数上。调用前做一次参数自查，能省掉大部分这种折腾。

第一个习惯：调用前先对照工具说明念一遍必填项。不要凭记忆拼参数，工具的必填字段、类型、取值范围以当次读取的说明为准。我的做法是让 Agent 在组装参数后先输出一张对照表：字段名、填的值、说明里的要求，三者对得上才发请求。对不上就先补齐，不要抱着“先试试”的心态发出去。

第二个习惯：对格式敏感的字段做显式转换。日期、金额、枚举值是最容易出错的三类。日期统一转成工具要求的格式再传，不要直接传用户口头说的“下周三”；金额注意单位是元还是分；枚举值必须从说明列出的选项里选，不能自己编一个近义词。转换逻辑写成固定函数，不要每次现写。

第三个习惯：危险操作先做影响面确认。删除、覆盖、批量发送这类有副作用的调用，参数自查还要多一步：确认作用对象是不是 intended 的那一个。比如删除前核对 ID 对应的名称，批量发送前核对收件人数量和样本。这一秒的确认，能避免一次不可逆的误操作。

第四个习惯：把报错当成参数线索，而不是失败判决。工具返回参数错误时，先把报错里的字段名和期望值抄下来，对照着改，而不是整体重写请求。改完只动报错指出的字段，其他字段保持不动，这样下一轮就能定位到底是哪个参数的问题。

第五个习惯：给常用工具留一份参数模板。经常调用的工具，把上次成功过的参数结构存下来，下次只改变化的部分。模板不是偷懒，而是把已经验证过的正确格式固定下来，减少每次从零拼参数的出错概率。

参数自查的本质，是把“调用工具”从一次凭感觉的尝试，变成一次有清单、有校验、有确认的动作。智能体越是自主，调用前的这一步检查就越不能省——它花的是一秒，省的是几轮返工。