tencent cloud

使用插件

PDF
聚焦模式
字号
最后更新时间: 2026-02-06 15:49:47
当智能体已无法依赖大模型已有能力完成任务时,例如需要调用外部工具获取实时信息(例如天气查询、搜索引擎)时,或者希望使用外部工具强化单一场景下的具体表现(例如代码生成、数学计算)时,您可以通过以下两种方式为智能体应用添加插件功能:
工作流:在某个工作流画布内添加插件节点,随后在标准模式应用内选择该工作流。或在单工作流模式下运行该工作流画布。
Multi-Agent:在应用设置页添加插件功能,为智能体启用外部能力。

工作流

您可在工作流中将 插件节点 拖拽至画布内,按照需求选择合适的插件。



为确保插件的功能可以正常使用,您可以单独对插件进行测试。例如填写输入参数后点击测试,确保功能正常,避免因插件服务异常而导致工作流整体运行失败。


Multi-Agent 模式

在 Multi-Agent 模式下点击添加插件,根据具体场景选择合适的工具(例如代码生成、数学计算)。




在提示词内添加工具

让 LLM 提前了解各个插件的功能介绍与具体作用有助于正确调用插件工具。在应用的提示词中,支持通过快捷键“@”快速插入已选择的工具,同时还可以增加对于工具调用的描述说明,例如在何种情况下调用当前工具,提升大模型对于工具的调用效率。




调整插件工具

在插件框内,点击所选工具右侧的菜单按钮,例如调整工具设置复制插件名称删除插件



对于已添加至列表的工具,支持工具更新全部删除。单击工具更新,可刷新列表内所有工具的最新配置。




配置工具参数

单击工具设置,可以配置header,工具参数高级选项



1. header
部分工具在添加时需要设置SECRET_IDSECRET_KEYREGION等密钥信息,在工具设置 > header 中可以对密钥信息进行修改。

2. 工具参数
工具设置 > 工具参数中,可以查看工具的输入和输出参数,并支持设置参数对大模型是否可见。
输入参数设置:支持配置默认值并选择模型是否可见。将部分参数设置为模型不可见后,工具将按照默认值进行调用,从而提升调用的稳定性。例如,对于密钥类参数,建议预先填写参数并关闭模型可见开关,这样在对话过程中无需收集密钥相关字段。默认值的设置方式包括以下两种:
手动输入:直接填写参数值。
引用变量:引用 API 参数变量。创建 API 参数变量后,可在调用腾讯云智能体开发平台 API 时,通过 custom_variables 字段(该参数的使用详情请参考:对话端接口文档(HTTP SSE)对话端接口文档(WebSocket))传入变量。
输出参数配置:支持设置模型是否可见开关。关闭后,该输出参数对模型不可见,适用于隐藏非必要信息,以减轻模型的理解负担。



3. 高级选项
工具设置 > 高级设置中,可以配置结果输出设置:当开启时,工具结果会直接返回给用户,不再进入模型总结、改写或转交流程。支持选择以下输出结果格式:
原始JSON:返回工具输出参数原始 JSON 结果。
自定义文本输出:返回自定义文字结果,支持插入变量,包括工具输入输出参数和应用变量。
Widget输出:工具结果输出以 Widget 形式呈现。详请参见 工具调用直接输出 Widget

配置完成后,当用户与智能体应用对话时,大模型将自行判断在何种情况下需要使用工具以更好的完成任务。


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈