使用智能体或工作流作为组件

智能体或工作流应用可发布为模块化的组件,供其他智能体或工作流应用接入使用,实现功能复用,加速复杂 AI 应用开发。

快速开始

以创建天气查询组件为例,您将学会组件的开发和使用方法。该组件可接入“旅途规划”、“农业管理”、“户外运动”等多种 AI 应用,提供便捷的天气查询服务。

步骤一:创建应用

您可以创建智能体或工作流应用,以实现一个天气分析模块。

智能体应用

  1. 创建应用:前往应用管理,创建一个新的智能体应用。智能体的配置如下:

    配置项

    配置内容

    模型

    通义千问-Max-Latest

    提示词

    你是一个天气分析助手,你的任务是查询某个城市的实时天气和气温走势

    MCP 服务

    Amap Maps(获取天气信息)、QuickChart(制作图表)

    说明

    MCP 是一种协议框架,允许您将外部工具(如本例中的 Amap Maps 和 QuickChart)接入到智能体应用中,作为大模型可调用的工具。请前往MCP 简介了解更多信息。

    本例使用的 MCP 服务限时免费。

    image

  2. 测试效果:在对话框中输入“请你查询杭州的气温变化趋势”,智能体将输出一份气温折线图。

工作流应用

  1. 创建应用:前往应用管理,创建一个新的任务型(或对话型)工作流应用。

  2. 配置开始节点:删除默认的 city 和 date 参数,在本例中不会使用。

    image

  3. 配置大模型节点:拖入一个大模型节点。连接开始节点和大模型节点。除以下配置外,其他配置保持不变。

    配置项

    配置内容

    模型配置

    通义千问-Max

    参数配置

    最长回复长度

    8192

    开启搜索

    开启

    搜索策略

    效果增强版

    强制开启搜索

    开启

    搜索扩展

    开启

    System Prompt

    你是一个天气分析助手,你的任务是查询某个城市的实时天气和气温走势。

    User Prompt

    输入‘/’呼出变量菜单,选择"系统变量/query"

    image

  4. 配置结束节点:连接大模型节点和结束节点。除以下配置外,其他配置保持不变。

    配置项

    配置内容

    输出模式

    文本输出

    文本框

    输入‘/’呼出变量菜单,选择"大模型1/result"

    image

  5. 测试效果:在测试窗(或对话框)中输入“查询杭州气温变化趋势”,工作流将输出一份文字预报。

步骤二:发布应用为组件

您可以在发布应用的同时发布组件。此外,对于已经发布的应用,您也可以在组件管理面板将其发布为组件。

发布应用为组件

  1. 发布应用:前往智能体或工作流应用的编辑界面,点击发布应用

  2. 发布组件:在发布应用时选择发布应用组件

    image

    也可以随时在发布渠道里创建组件。

    image

在管理面板发布组件

控制台提供了组件管理,您可以点击创建组件来将已有的智能体发布为组件,您也可以查看、修改或删除应用组件。

image

步骤三:配置组件名称和参数

在发布时,您需要为组件设置合适的名称、描述和参数设置,以便接入智能体或工作流应用。

为了标准化接入方式,组件预设了以下系统参数:

  • query:用于传递用户输入的文本。例如:“请你帮我查询杭州今天的天气预报”。

  • imageList:用于传递用户输入的图像公网地址列表。仅在组件使用视觉理解模型时有效。

说明

预设的系统参数无法删除。如果您不需要某个预设参数,请在配置参数时隐藏该参数(将是否可见设置为否)。

填写组件名称和描述

  • 组件名称:

    描述组件功能的名称。(填写示例:天气分析智能体)

  • 组件描述

    组件的功能简介。(填写示例:用于分析城市的天气信息)

    • 接入智能体时,大模型会根据组件描述和上下文,自动判断是否调用该组件。

    • 接入工作流时,该描述仅用于说明组件功能,不影响工作流的运行。

设置入参

配置项

用途

填写示例

输入信息

参数名称

参数的原始名称,不能修改。

query

imageList

别名

为避免参数名称相同,您需要给参数起别名。调用组件时,调用者只能看到参数的别名。

userQuery

imageList

参数描述

参数的内容描述。

  • 当组件接入智能体,且传参方式为模型识别时,大模型会根据参数描述,自动填入参数内容。

  • 其他情况下,该描述仅起到说明作用。

用自然语言表述的查询指令

用户上传的图片链接

是否可见

组件是否对外透出此参数,用于隐藏不需要的参数。例如,组件使用了文本模型,就需要隐藏图像输入参数。

传参方式

业务透传

  • 接入智能体时,由组件的使用者提供。

  • 接入工作流时,由上游节点提供。

模型识别

  • 接入智能体时,由大模型根据参数描述,从上下文中自动推断并填充。

  • 接入工作流时,即使参数的传参方式设置为模型识别,应用也不会自动推断参数值。您必须业务透传一样,从上游节点明确地为该参数提供输入值。

模型识别

模型识别

image

步骤四:接入组件到智能体/工作流应用

智能体应用

组件可以作为工具接入智能体。在此场景下,智能体将根据用户问题自动使用组件。

如果接入的组件包含需要业务透传的参数,您可以在测试时手动填入入参变量配置,或者在 API 调用时通过 biz_param参数传入。
  1. 接入组件:前往应用管理,创建一个新的智能体应用。智能体的配置如下:

    配置项

    配置内容

    模型

    通义千问-Max-Latest

    提示词

    你是一个智能体。请持续进行处理,直到用户的疑问完全解决后,再结束你的回合并将控制权交还给用户。只有当你确信问题已得到解决时,才可终止你的回合。

    如果你对用户请求所涉及的文件内容或代码库结构不确定,请使用你的工具来读取文件并收集相关信息:切勿猜测或编造答案。

    在每次调用函数之前,你必须进行详尽的规划,并对先前函数调用的结果进行深入的反思。切勿仅通过调用函数来完成整个过程,因为这可能会削弱你解决问题和进行有洞察力思考的能力。

    智能体

    天气分析智能体

    image

    image

  2. 测试效果:在对话框中输入“请你查询杭州天气预报”,智能体将调用组件输出一份天气预报,表明组件已成功接入智能体。

工作流应用

组件可以作为组件节点接入工作流。在此场景下,您需要手动为组件传入符合要求的参数,并将组件的输出结果传递到下一个节点。

  1. 创建应用:前往应用管理,创建一个新的任务型(或对话型)工作流应用。

  2. 配置开始节点:删除默认的 city 和 date 参数,在本例中不会使用。

    image

  3. 配置组件节点:拖入一个组件节点。选择之前创建的智能体或工作流组件。连接开始节点和组件节点。除以下配置外,其他配置保持不变。

    配置项

    用途

    配置内容

    输入

    传入需要组件处理的内容

    系统变量/query

    流式输出

    开启后,组件生成的内容将流式返回

    开启

    image

  4. 配置结束节点:连接组件节点和结束节点。除以下配置外,其他配置保持不变。

    配置项

    配置内容

    输出模式

    文本输出

    文本框

    输入‘/’呼出变量菜单,选择"组件1/result"

    image

  5. 测试效果:在测试窗(或对话框)中输入“查询杭州气温变化趋势”,工作流将输出一份天气预报,表明组件已成功接入工作流。

注意事项

  1. 组件自动更新:应用发布为组件后,如果应用重新发布,那么该组件也会自动更新。

  2. 避免嵌套调用:对于 A 调用 B,B 调用 A 的情况,应用会进入重复调用状态,导致功能不可用。

  3. 避免多级调用:对于 A 调用 B,B 调用 C 的情况,应用有最长运行时间限制,多级调用容易产生超时错误。