扣子怎么给智能体添加插件
智能体遇到查天气、查汇率这类实时数据就答不上来,插件补的正是这一块。讲清添加入口、指令怎么写,以及加了却调不动的排查。
智能体只会聊天,遇到查天气、查汇率、读网页这类需要实时数据的事就答不上来。插件就是给它接上的手和眼。这篇讲插件在哪里加、加完怎么测,以及加了却调不动时该查什么。
入口在哪
- 进入扣子后先打开工作空间,在智能体列表里找到要改的那一个,点进去就是编排页面。
- 编排页面中间是人设与指令,往下能看到「插件」或「工具」区域,添加入口就在这里。
- 插件分官方插件和自定义插件两类,前者从插件广场搜索添加,后者要自己配置接口地址和参数。
- 不同版本的界面名称略有差别,找「插件」两个字最快,实在找不到就在页面里搜。
具体步骤
- 先想清楚要它做什么,比如查某个城市的天气,再按这个需求去插件广场搜关键词,不要一上来就加一堆。
- 点添加,勾选插件里具体的工具。一个插件下面常有好几个工具,只勾用得上的,勾多了模型容易选错。
- 回到人设与指令,把使用条件写清楚:什么情况下该调用哪个工具,参数从用户的话里怎么取,拿不到参数时先反问。
- 要求它调用后必须引用返回结果,不允许自己编数字,这条在涉及时间、价格、地址时尤其重要。
- 在右侧预览区发一句话测试,看它有没有真的发起调用,返回的数据和网页上查到的是否一致。
- 测试通过再发布到需要的渠道,发布前把调试记录清一遍,避免把测试用的临时设定带上去。
几个坑
- 指令写得太笼统,模型会绕开插件直接凭记忆回答,看着像加了插件,其实根本没调用。
- 一次加十几个工具,模型在多个相似工具之间反复犹豫,回答变慢还容易选错,按需分阶段加。
- 插件需要参数却拿不到,比如只说了城市没说日期,这时要让它反问,而不是自己猜一个日期填进去。
- 自定义插件要填鉴权信息,密钥写错或者过期,表现是调用失败但界面不报错,只能从运行日志里找原因。
- 插件返回的字段名和单位不统一,模型可能把毫秒当秒、把美元当人民币,最好在指令里规定单位换算和保留几位小数。
- 调用次数和额度有限制,具体以控制台显示为准,上线前先估算一下每天的对话量。
怎么验证
准备五到十条真实会遇到的问法,覆盖正常提问、缺参数、参数错误三种情况,逐条在预览区跑一遍。每条都看两点:有没有真的触发调用,返回结果和原始数据对不对得上。
再故意问一个插件覆盖不到的问题,看它是老实说查不到,还是硬编一个答案。后者说明指令约束不够,要补一句:没有可用工具时直接说明无法查询。
常见问题
插件加上了但从来不调用
先把人设里的触发条件写具体,比如凡涉及实时天气一律先查工具。再确认模型能不能看到这个工具:在预览区直接问它有哪些可用工具。如果它列不出来,说明插件没有保存成功或者没有发布,回去检查一遍。
调用成功但回答还是错的
看返回的原始数据。常见情况是插件返回了多个候选,模型挑了第一个;或者字段是英文缩写,模型理解偏了。在指令里指明取哪个字段、怎么判断,必要时让它先把原始结果摘要出来再回答。
能不能让它按固定时间自动跑
普通对话不会自己定时执行,定时任务要用平台提供的定时能力单独配置,和插件是两件事。配置时注意时区,写清楚是每天几点、按哪个时区算,否则容易差几个小时。
一句话总结:插件只是工具,真正决定它好不好用的是指令里写清的调用条件、参数来源和结果引用规则。