智能体或工作流应用可发布为模块化的组件,供其他智能体或工作流应用接入使用,实现功能复用,加速复杂 AI 应用开发。
快速开始
以创建天气查询组件为例,您将学会组件的开发和使用方法。该组件可接入“旅途规划”、“农业管理”、“户外运动”等多种 AI 应用,提供便捷的天气查询服务。
步骤一:创建应用
您可以创建智能体或工作流应用,以实现一个天气分析模块。
智能体应用
工作流应用
创建应用:前往应用管理,创建一个新的任务型(或对话型)工作流应用。
配置开始节点:删除默认的 city 和 date 参数,在本例中不会使用。
配置大模型节点:拖入一个大模型节点。连接开始节点和大模型节点。除以下配置外,其他配置保持不变。
配置项
配置内容
模型配置
通义千问-Max
参数配置
最长回复长度
8192
开启搜索
开启
搜索策略
效果增强版
强制开启搜索
开启
搜索扩展
开启
System Prompt
你是一个天气分析助手,你的任务是查询某个城市的实时天气和气温走势。
User Prompt
输入‘/’呼出变量菜单,选择"系统变量/query"
配置结束节点:连接大模型节点和结束节点。除以下配置外,其他配置保持不变。
配置项
配置内容
输出模式
文本输出
文本框
输入‘/’呼出变量菜单,选择"大模型1/result"
测试效果:在测试窗(或对话框)中输入“查询杭州气温变化趋势”,工作流将输出一份文字预报。
步骤二:发布应用为组件
您可以在发布应用的同时发布组件。此外,对于已经发布的应用,您也可以在组件管理面板将其发布为组件。
发布应用为组件
发布应用:前往智能体或工作流应用的编辑界面,点击发布应用。
发布组件:在发布应用时选择发布应用组件。
也可以随时在发布渠道里创建组件。
在管理面板发布组件
控制台提供了组件管理,您可以点击创建组件来将已有的智能体发布为组件,您也可以查看、修改或删除应用组件。
步骤三:配置组件名称和参数
在发布时,您需要为组件设置合适的名称、描述和参数设置,以便接入智能体或工作流应用。
为了标准化接入方式,组件预设了以下系统参数:
query:用于传递用户输入的文本。例如:“请你帮我查询杭州今天的天气预报”。
imageList:用于传递用户输入的图像公网地址列表。仅在组件使用视觉理解模型时有效。
预设的系统参数无法删除。如果您不需要某个预设参数,请在配置参数时隐藏该参数(将是否可见设置为否)。
填写组件名称和描述
组件名称:
描述组件功能的名称。(填写示例:天气分析智能体)
组件描述:
组件的功能简介。(填写示例:用于分析城市的天气信息)
接入智能体时,大模型会根据组件描述和上下文,自动判断是否调用该组件。
接入工作流时,该描述仅用于说明组件功能,不影响工作流的运行。
设置入参
配置项 | 用途 | 填写示例 | ||
输入信息 | 参数名称 | 参数的原始名称,不能修改。 | query | imageList |
别名 | 为避免参数名称相同,您需要给参数起别名。调用组件时,调用者只能看到参数的别名。 | userQuery | imageList | |
参数描述 | 参数的内容描述。
| 用自然语言表述的查询指令 | 用户上传的图片链接 | |
是否可见 | 组件是否对外透出此参数,用于隐藏不需要的参数。例如,组件使用了文本模型,就需要隐藏图像输入参数。 | 是 | 否 | |
传参方式 | 业务透传:
模型识别:
| 模型识别 | 模型识别 |
步骤四:接入组件到智能体/工作流应用
智能体应用
组件可以作为工具接入智能体。在此场景下,智能体将根据用户问题自动使用组件。
如果接入的组件包含需要业务透传的参数,您可以在测试时手动填入入参变量配置,或者在 API 调用时通过 biz_param
参数传入。
接入组件:前往应用管理,创建一个新的智能体应用。智能体的配置如下:
配置项
配置内容
模型
通义千问-Max-Latest
提示词
你是一个智能体。请持续进行处理,直到用户的疑问完全解决后,再结束你的回合并将控制权交还给用户。只有当你确信问题已得到解决时,才可终止你的回合。
如果你对用户请求所涉及的文件内容或代码库结构不确定,请使用你的工具来读取文件并收集相关信息:切勿猜测或编造答案。
在每次调用函数之前,你必须进行详尽的规划,并对先前函数调用的结果进行深入的反思。切勿仅通过调用函数来完成整个过程,因为这可能会削弱你解决问题和进行有洞察力思考的能力。
智能体
天气分析智能体
测试效果:在对话框中输入“请你查询杭州天气预报”,智能体将调用组件输出一份天气预报,表明组件已成功接入智能体。
工作流应用
组件可以作为组件节点接入工作流。在此场景下,您需要手动为组件传入符合要求的参数,并将组件的输出结果传递到下一个节点。
创建应用:前往应用管理,创建一个新的任务型(或对话型)工作流应用。
配置开始节点:删除默认的 city 和 date 参数,在本例中不会使用。
配置组件节点:拖入一个组件节点。选择之前创建的智能体或工作流组件。连接开始节点和组件节点。除以下配置外,其他配置保持不变。
配置项
用途
配置内容
输入
传入需要组件处理的内容
系统变量/query
流式输出
开启后,组件生成的内容将流式返回
开启
配置结束节点:连接组件节点和结束节点。除以下配置外,其他配置保持不变。
配置项
配置内容
输出模式
文本输出
文本框
输入‘/’呼出变量菜单,选择"组件1/result"
测试效果:在测试窗(或对话框)中输入“查询杭州气温变化趋势”,工作流将输出一份天气预报,表明组件已成功接入工作流。
注意事项
组件自动更新:应用发布为组件后,如果应用重新发布,那么该组件也会自动更新。
避免嵌套调用:对于 A 调用 B,B 调用 A 的情况,应用会进入重复调用状态,导致功能不可用。
避免多级调用:对于 A 调用 B,B 调用 C 的情况,应用有最长运行时间限制,多级调用容易产生超时错误。