使用工具

最近更新时间:2026-05-27 14:21:31

我的收藏
当智能体已无法依赖大模型的现有能力完成任务时,例如需要调用外部工具获取实时信息(例如天气查询、搜索引擎)时,或者希望使用外部工具强化单一场景下的具体表现(例如代码生成、数学计算)时,您可以通过以下三种方式为智能体应用启用工具能力:
智能工作台:在智能工作台中添加工具,模型可以根据用户问题和工具描述,自动判断是否需要调用对应能力。
Claw 模式/Multi-Agent 模式应用:在 Claw/Multi-Agent 应用模式内的设置页添加工具,为智能体启用外部能力。
工作流:在某个工作流画布内添加工具节点,随后在标准模式应用的工作流管理内选择该工作流;或在单工作流模式下运行该工作流画布。

智能工作台

管理已添加工具

进入智能工作台后,点击底部工具栏中的「工具」,即可打开「管理工具」窗口。窗口中会展示当前已添加到对话中的工具,包括工具名称、工具描述和来源标识。
您可以在此页面查看当前对话可用的工具能力,也可以删除不需要的工具,避免工具过多影响模型判断。系统可能会默认预置部分常用工具,例如知识库问答、图片理解等,用于支持基础问答、图片理解和文件处理能力。


添加工具

在管理工具窗口中点击 添加,即可进入 添加工具 页面。您可以在工具广场中浏览平台提供的工具集,也可以查看已创建的自定义工具。添加工具页面支持按分类筛选,您也可以通过「官方」「收藏」「类型筛选」和搜索框,快速定位所需工具。
工具通常以“工具集”的形式展示,一个工具集下可以包含一个或多个具体工具。您可以根据需要选择添加方式:
全部添加:将该工具集下的全部工具一次性添加到当前对话中,适合您明确需要完整使用该工具集能力的场景。
展开后选择单个工具:点击工具集右侧的展开按钮,查看该工具集下包含的具体工具,再按需添加部分工具。适合只需要其中某几个能力的场景。




Claw/Multi-Agent 模式应用

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




在提示词内添加工具

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




调整工具

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



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



单击工具设置,配置工具参数及相关信息。



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



配置完成后,当用户与智能体应用对话时,大模型将自行判断在何种情况下需要使用工具以更好地完成任务。
如果配置的工具中包含自定义工具,自定义工具删除后,在 Multi-Agent 模式应用内会提示用户“该工具已失效”。




工作流

您可以在 工作流 内将 连接器与工具节点 拖拽至画布内,并按照需求选择合适的工具。



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



如果配置的工具中包含自定义工具,自定义工具删除后,工作流画布中对应的工具节点处会提示用户“已失效”。




使用 OAuth 工具

在应用中添加 OAuth 工具时,支持完成授权并选择授权模式,以满足不同安全级别和业务场景的需求。

Agent-工具设置



工作流-插件节点



选择 OAuth 授权模式

1. 点击 去授权 前往第三方进行登录授权操作,刷新以获取最新授权状态(如果在后续步骤中选择了 使用者授权,这里的已授权凭证不会继承给终端用户)。
2. 支持点击 重新授权 更换授权账号,新的授权会覆盖老授权。



3. 选择授权模式:授权模式决定了应用发布后,终端用户在对话中调用工具时,访问的是谁的数据。平台支持两种授权模式:使用者授权开发者授权
使用者授权
选择该模式时,需要由每位终端用户在首次对话使用应用时,分别完成自己的账号授权。智能体调用工具时,只会访问该用户本人账号权限范围内的数据。
该模式适用于需要按用户身份隔离数据的场景。例如,用户 A 使用应用时访问的是 A 自己的知识库、文档或工作空间;用户 B 使用应用时访问的是 B 自己的知识库、文档或工作空间。不同用户之间的数据相互隔离,互不可见。
典型场景包括:
个人笔记、待办、文档检索助手;
团队成员各自查询自己的工作内容;
需要严格按用户身份访问外部系统数据的应用;
不希望不同用户共享同一份数据权限的场景。
使用者授权更适合“每个用户查自己的数据”的应用,能够保证数据权限与用户身份一致。
使用者授权-用户在首次对话中完成授权
使用者授权-用户在首次对话中完成授权

开发者授权
选择该模式时,需要由应用开发者在应用配置阶段点击 去授权 绑定一个固定账号。应用发布后,所有终端用户在调用该工具时,都会通过这个固定账号的权限访问数据,终端用户无需再单独授权。
该模式适用于希望所有用户访问同一份共享数据的场景。例如,开发者绑定了一个企业知识库账号,所有使用该应用的用户都通过该账号访问同一份公司 FAQ、产品手册或公共制度文档。
典型场景包括:
公司 FAQ 问答机器人;
产品手册、帮助中心、知识库问答;
公共政策、规章制度查询;
面向全员开放的共享资料查询应用。
使用开发者授权时,建议绑定专门为该应用准备的服务账号,避免使用开发者个人账号。否则,可能导致开发者个人账号下的私有内容被所有应用用户访问。