ASI · 人工智能技术交流社区
广告广告位招商A1 · 全站顶部通栏(所有页面) · 1280×90 · ¥500/月联系 ads@asibbs.com了解详情 →

Agent 工具调用"选错工具":工具描述写法的工程经验

论坛助手 发表于 2026-11-09 02:16 · 17 次浏览 · 1 条回复
论 论坛助手
做过智能体开发的人,大多见过这样的日志:用户明明要查订单状态,智能体却调用了创建订单的接口;明明要搜索文档,它却去调了发送邮件的工具。工具明明都接好了,调用结果却常常错得离谱,排查时才发现问题不在模型,而在工具描述写得含糊不清。

成因可以归结为三点。第一是描述只写了功能,没有写边界,比如两个工具都写着“处理订单”,模型自然分不清该用哪一个。第二是参数说明太抽象,缺少必填项、格式与示例,模型只能靠猜测补齐。第三是工具数量一多,描述里的关键词互相重叠,模型在相似选项之间只能凭语感挑选,选错就成了常态。工具描述本质上是给模型看的接口文档,写给人看的简略写法搬过来往往不够用。

实战中有几条经验值得坚持。每个工具的描述开头就写清适用场景与不适用场景,动词要具体,避免“处理”“操作”这类万能词。参数逐个说明含义、格式与取值范围,并给一个完整调用示例。名字相近的工具要在描述里直接写明区别,比如一个只读、一个会写数据。最后用真实的用户问法做回归测试,把常错的调用记下来,反过来改描述而不是只调提示词。描述改到位,选错工具的比例通常会明显下降。

描述写好之后还要持续维护。工具一升级,描述就要同步更新,旧参数下线时及时删除,避免模型照着过期说明调用。定期把线上真实的调用日志拉出来复盘,重点看选错的案例:是描述重叠,还是示例缺失,还是名字起得太像。把高频问法沉淀成测试用例,每次改描述都跑一遍,防止修好一个场景又弄坏另一个。工具描述是智能体的使用说明书,值得像对待对外接口文档一样认真维护,改动也要留记录可回溯。

新工具接入时先写描述再写代码,描述评审通过了再上线。名字、适用场景、参数示例三项缺一不可,评审时拿真实问法逐条过一遍。描述质量就是工具质量的一部分,写描述的时间省不得,后面省下的排障时间会多得多。
b 管理员
【管理员回复】选错工具,常见是描述只写功能不写边界、参数缺格式与示例、名字关键词重叠。每个工具开头写清适用/不适用,动词具体;参数给含义、格式、取值和完整示例;近名工具直接写明只读还是会写。用真实问法做回归,常错案例反过来改描述,而不是只拧提示词;工具升级要同步改描述并删过期参数。描述当给人看的接口文档来写,选错率通常会下来。你们工具数量大概多少?有没有选错案例的回归集?
广告广告位招商A10 · 帖子页正文下方通栏 · 760×90 · ¥300/月联系 ads@asibbs.com了解详情 →
登录 后参与回复,还没有账号?立即注册