题目
如何设计工具名称、描述和参数,减少误选与误调用?
答案
名称应直接表达动作和对象,例如 `get_order_status` 比 `process_data` 更清楚。容易混淆的工具,要在描述中说明使用条件和区别。
描述应包含用途、必要前提、是否修改数据,以及返回什么。例如“提交退款申请,会创建退款单;必须先确认订单归属和可退金额”。不要只重复工具名称。
参数尽量使用明确的类型、枚举和单位。金额注明分还是元,时间注明时区,订单号与用户 ID 不要都叫 `id`。默认值只有在业务确实允许时才设置。
减少让模型填写的环境参数。用户身份、租户和认证信息由服务端注入;模型只填写任务所需业务参数。最后用误调用样本验证描述,观察它是否仍把“查询退款”当成“发起退款”。
