# 创建并配置多智能体应用 多智能体应用根据用户意图，将请求路由分发至对应的子工作流或子智能体执行，实现多场景的统一调度。多智能体应用的更多介绍请参考[多智能体应用介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0103.html)。 本节介绍配置多智能体应用的流程。 #### 费用说明 不同套餐包允许创建的**应用数量限制** 不同，具体可参考[计费说明](https://support.huaweicloud.com/price-agentarts/agentarts_08_0002.html)。 #### 前提条件 - 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)。 - 已[发布并部署工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0053.html)。 #### 创建多智能体应用 创建多智能体的基础信息。 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏，选择"开发中心 \> 智能体管理"。 3. 选择"多智能体"页签，单击"创建多智能体"。 4. 在"创建多智能体"页面，配置基础信息，具体参数说明请参考[表1]。 图1创建多智能体 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549943.png "点击放大") 表1基础信息参数说明 | 参数 | 说明 | 示例 | |:---|:---|:---| | 名称 | 多智能体应用的名称。由2\~64个字符组成，包含中英文、数字、下划线、中划线、空格，不能以空格开头或结尾。 | 智能外呼 | | 描述 | 多智能体的描述信息。由1\~1024个字符组成。 | 智能外呼 | | 多智能体图标 | 系统默认多智能体应用图标，可通过单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390061.png)自动生成图标，也可以自定义图标。 1. 鼠标移动至系统默认图标上，单击鼠标左键。 2. 上传已准备好的应用图标。 支持jpg、jpeg、png、gif格式图片，且不大于200KB。 | 系统默认图标 | 5. 单击"立即创建"。 创建后，进入"多智能体配置"页面，初始只有一个"多Agent控制器"节点。创建的多智能体应用显示在多智能体应用卡片列表中。 #### 全局配置 在"多智能体配置"页面右上方，单击"全局配置"。 全局配置可配置输入参数和全局变量，这些都可以给工作流的输入参数使用。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/caution_3.0-zh-cn.png) 输入参数的值不可修改，全局变量的值可被子工作流的输出参数覆盖，请注意区分使用场景。 图2全局配置 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390057.png) 表2全局配置参数说明 | 参数 | 说明 | |:---|:---| | 输入参数 | 传给工作流的输入参数，且值不可修改。 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549955.png)，添加输入参数。 - 参数名称：由1\~64字符组成，包含字母、数字、下划线，不能以数字开头。 - 类型：类型支持String、Integer、Number、Boolean。默认值String。 - 描述：由0\~256个字符组成。 - 必填：根据需求去掉勾选。默认勾选。 - ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950324.png)：删除输入参数。 - ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950294.png)：输入参数默认值。 | | 全局变量 | 传给工作流的输入参数，工作流如果有相同名称和类型的输出参数会覆盖该值。 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549957.png)，添加全局变量。 - 参数名称：由1\~64字符组成，包含字母、数字、下划线，不能以数字开头。 - 类型：类型支持String、Integer、Number、Boolean。默认值String。 - 描述：由1\~256个字符组成。 - ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790468.png)：删除全局变量。 - ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950334.png)：全局变量默认值。 | #### 配置多Agent控制器 配置多智能体，实现特定业务能力。 1. 单击"多Agent控制器"卡片，在弹出页面配置参数信息。 图3配置多Agent控制器 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950298.png "点击放大") 2. （可选）配置模型。 此处的模型用于意图识别和路由调度，负责理解用户输入的意图并决定路由到哪条工作流或智能体。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/caution_3.0-zh-cn.png) "模型配置（可选）"与"意图识别"参数，至少填写一个。如果意图识别工作流或意图包未返回有效意图，则使用选择的模型进行意图识别。 AgentArts支持在下拉框中选择合适的模型，如DeepSeek-V4-Flash。已接入的模型服务详见[模型](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0182.html)。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) 模型的标签展示顺序从左到右依次是用户自定义标签、[接入模型服务](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0191.html)时的"选择标签"、"模型类型"。 - 接入模型时的"选择标签"： - ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687949630.png "点击放大")联网：表示该大模型具备联网搜索能力。 - ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389391.png)思考：表示该大模型具备思维推理能力。 - ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549261.png)工具：表示该大模型支持应用调用外部工具，例如，MCP服务、插件、知识库等。 - 限额体验：表示该平台预置大模型可以体验，会话轮数最大为20次。 - "模型类型"包含： - ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687949634.png)文本：表示该大模型是文本对话类型。 - ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549275.png)视觉：表示该大模型是图像理解类型。 - ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687789788.png)嵌入：表示该大模型是文本向量化类型。 - ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687789764.png)排序：表示该大模型是文本排序类型。 - 模型状态： - 未验证：表示该大模型未校验鉴权信息，不可使用。 - 成功：表示该大模型鉴权信息校验成功，可以使用。 - 失败：表示该大模型鉴权信息校验失败，不可使用。 在"模型配置"右侧，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549971.png)，显示如下参数： - **核采样** ： 核采样（Top-P）用于限制模型的选词范围。取值范围0.1\~1，默认值为0.5。 - 值接近0时，模型只从概率最高的前10%词汇中选择，输出更集中。 - 值接近1时，不做限制，输出更多样。 建议该参数和"生成随机性"只设置1个，避免同时调整后效果不可控。 - **生成随机性** ： 生成随机性（temperature）控制模型输出的随机性和创造性，取值范围0\~1，默认值为0.5。 - 数值越低（接近0）使输出更加确定和一致，适合基于事实的问答和售后客服场景。 - 数值越高（接近1）使输出更具多样性和创新性，适合创造性任务如小说创作。 建议该参数和"核采样"只设置1个，避免同时调整后效果不可控。 3. （可选）配置子工作流执行逻辑提示词。 为编排控制器定义调度逻辑的系统提示词。通过自然语言描述子工作流的执行顺序、优先级规则和协作逻辑，指导模型做出正确的路由决策。 示例： ``` 你是一个智能客服调度系统。根据用户输入判断意图，按以下规则路由到对应的子工作流。 1、如果用户询问订单相关问题，执行“订单查询”工作流。 2、如果用户要求退换货， 执行“退换货处理”工作流。 3、如果用户表达不满或投诉，执行“投诉处理”工作流。 4、如果无法判断意图，执行默认工作流。 ``` 用户可单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390085.png)图标直接引用提示词模板；也可以自行撰写提示词，撰写后可单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390079.png)图标对系统提示词进行智能优化；也可单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390055.png)图标保存到模板，在"组件库 \> 提示词"中可查看该模板。 4. 配置意图识别。 选择该多智能体的意图识别能力。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/caution_3.0-zh-cn.png) "模型配置（可选）"与"意图识别"参数，至少填写一个。优先调用意图识别工作流或意图包。 - **大模型识别模式**：由大模型对用户的输入进行意图理解并分类。选择此值时，"模型配置（可选）"需选择模型。 - **工作流识别模式** ：由开发者自行编排一个专门用来做意图识别场景的工作流进行处理，可以兼顾准确率和性能。 在"选择工作流"右侧，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390049.png)，选择意图识别工作流。意图识别工作流的开始节点的输入参数、结束节点的输出参数配置有特殊要求。 多智能体运行时，运行流程依次为：用户输入 -\> 意图识别工作流 -\> 根据意图识别工作流输出的intent_id执行任务。 意图识别工作流的开始节点的输入参数、结束节点的输出参数配置如下： - 开始节点必须配置如[图4]所示参数，参数名称和参数类型必须保持一致。 - messages：对话历史。 - role：角色。 - content：内容。 - intents：意图。 - id：意图序号，取值为从1开始的自然数。 - name：当id的取值为1时，表示没有明确意图或无法判断用户输入意图；当id的取值为非1时，表示对应的意图。 图4开始节点配置 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790438.png "点击放大") - 结束节点必须配置如[图5]所示参数，输出参数名称以及引用的值必须为integer类型。 intent_id：子工作流输出的意图结果。输出结果与多智能体中子智能体的对应关系请参考[意图识别输出结果说明]。 图5结束节点配置 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549945.png "点击放大") - **高精识别模式** ：开发者预先创建意图包，预设多类意图场景，系统结合配置能大幅提升海量意图的识别准确率。 在"选择意图包"下的下拉框中选择意图包。单击"立即创建"可以创建意图包，具体操作请参考[创建意图包](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0095.html#agentarts_05_0095__section111835148562)。 5. 配置子智能体。 每个子智能体对应一类用户意图或业务场景，多Agent控制器根据用户意图自动路由执行，调度逻辑可通过"执行逻辑提示词"灵活定义。 在子智能体右侧，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549933.png)，支持添加工作流、多智能体。 - 工作流：最多支持添加50个子工作流。 添加工作流后，设置子工作流的执行动作，支持的执行动作如下： - **继续** ：执行完该工作流后，继续执行后续流程。有两种场景： - **场景1：工作流间跳转后继续**。执行工作流A时，如果意图识别需要执行工作流B（且工作流B设为"继续"），则执行完工作流B后，返回工作流A，继续执行A中尚未完成的部分。 - **场景2：工作流自身执行完毕后继续**。如果工作流A自身设为"继续"，则执行完工作流A后，调用结束工作流结束当前任务。 - **终止**：执行完该工作流后，调用结束工作流结束当前任务。 - **等待输入**：执行完该工作流后，暂停并等待用户输入问题后再继续执行。 - 多智能体：在多智能体应用中，可以嵌套引用另一个多智能体应用，从而实现多层控制的效果。目前支持2级控制。最多支持添加50个智能体。 6. （可选）配置全局意图。 定义全局性的意图识别规则。无论当前正在执行哪条子工作流，一旦检测到匹配的全局意图，将立即触发对应的处理动作。适用于随时可能出现的跨场景指令（如"转人工"、"退出"、"切换话题"）。 在"全局意图"右侧，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950300.png)，输入意图名称、处理方式、意图的执行动作。 支持如下处理方式： - **直接应答**：配置一段文本，输出给用户。 - **流程跳转**：关联一个工作流完成对应意图需要执行的动作。 支持如下执行动作： - **继续**：按直接应答/工作流的执行结果，继续执行其他的子工作流。 - **终止**：按直接应答/工作流的执行结果，调用结束工作流结束任务。 - **等待输入**：按直接应答/工作流的执行结果，待用户输入问题后执行任务。 7. （可选）配置起始工作流。 无论用户意图识别到哪条子工作流，起始工作流始终最先执行。适用于用户身份验证、会话初始化、欢迎语生成等前置操作。 未配置时，系统根据选择的模型、子工作流执行逻辑提示词或意图识别进行意图判断。 执行顺序：起始工作流 → 子工作流（按意图路由）→ 结束工作流 配置起始工作流操作如下： 1. 在"起始工作流（可选）"右侧，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390071.png)，在"添加工作流"页面选择作为起始的工作流应用。 2. 单击"确定"。 如果选择的工作流需要删除，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549927.png)。 8. （可选）配置默认工作流。 当用户的输入无法匹配您配置的任何一个子工作流所定义的业务意图时，系统将自动执行此处指定的默认工作流，并随即结束当前任务。 未配置时，当遇到无法识别的用户问题时，系统将无响应或报错终止，影响用户体验。 配置默认工作流的操作如下： 1. 在"默认工作流（可选）"右侧，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790454.png)，在"添加工作流"页面选择作为默认的工作流应用。 2. 单击"确定"。 如果选择的工作流需要删除，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950316.png)。 3. 设置工作流的执行动作。 支持的执行动作如下： - **继续**：按该工作流的执行结果，继续执行其他的子工作流。 - **终止**：按该工作流的执行结果，调用结束工作流结束任务。 - **等待输入**：按该工作流的执行结果，待用户输入问题后执行任务。 9. （可选）配置结束工作流。 在所有子工作流执行完毕后固定执行的工作流。无论之前的意图路由经过了哪些子工作流，结束工作流始终最后执行。 适用于会话总结、满意度调查、数据清理等收尾操作。 执行顺序：起始工作流 → 子工作流（按意图路由）→ 结束工作流 - 配置结束工作流的操作如下： 1. 在"结束工作流（可选）"右侧，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390083.png)，在"添加工作流"页面选择作为结束的工作流应用。 2. 单击"确定"。 如果选择的工作流需要删除，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390087.png)。 10. 配置最大对话历史轮次。 编排模型在进行意图识别时，最多参考的历史对话轮数。历史对话轮次越多，意图识别时消耗的Token数越多，产生的费用越高。请根据业务复杂度合理设置。设为0表示不引用历史对话，仅基于当前输入判断意图。 设置历史对话次数，选择N，记录最近N条会话内容。例如，选择10，记录最近10条会话内容。取值范围0\~100，默认值为10。 11. 配置最大跳转次数。 在一次用户会话中，编排控制器最多允许在子工作流之间跳转的次数。**防止因意图识别不稳定导致工作流之间无限循环跳转**。达到最大跳转次数后，系统将执行默认工作流并结束任务。 只有业务工作流之间跳转才会计算次数，起始工作流、结束工作流不计算跳转次数。取值范围0\~30，默认值为9。 例如，一个多智能体应用含5个工作流，分别为工作流A（起始工作流或默认工作流）、工作流B、工作流C、工作流D、工作流E（结束工作流），根据用户问题先执行工作流A，根据工作流A的结果执行工作流B，根据工作流B的结果执行工作流C，再根据工作流C的结果执行工作流D，最后执行工作流E，相当于跳转了3次。 12. 配置完成后，单击"确定"。 设置后，进入"多智能体配置"页面。 - 在"多智能体配置"页面，显示多Agent控制器及添加的工作流、智能体及对应的工作流。 单击工作流卡片，用户可以自定义意图名称、意图描述。 单击智能体卡片，用户可以自定义意图名称、意图描述。 单击智能体对应的工作流卡片，显示意图名称、意图描述、输入输出信息。 在工作流或智能体卡片上，单击"![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549953.png) \> 工作流详情"或"![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950322.png) \> 智能体详情"，查看工作流或智能体详情。 在工作流或智能体卡片上，单击"![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549973.png) \> 复制工作流ID"或"![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790466.png) \> 复制智能体ID"，复制工作流或智能体ID。 - 在"多智能体配置"页面，可以调试、发布多智能体应用，调试与发布多智能体应用请参考[调试多智能体应用](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0107.html)、[部署多智能体应用为API](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0108.html)。 #### 意图识别输出结果说明 意图识别工作流的结束节点输出结果是由意图识别工作流产生，输出结果如下所示。[表3]所示的意图映射关系列表由多智能体的配置自动生成，从序号1开始递增。 输出结果示例： ``` { "intent_id": 5 } ``` 表3输出结果分类 | 任务的序号生成规则 | 说明 | 示例 | |:---|:---|:---| | 1 | 系统默认意图（不明意图）。当用户输入无法匹配任何已知配置，指向此分类。 当intent_id值为1时，不执行任何任务，输出提示"抱歉，未识别到您的意图，请重新输入"。 | - | | 2\~1+N | 全局意图。如果配置了全局意图，intent_id值在此范围内，则会执行对应的全局意图。 N为全局意图从上往下的序号。 | - 如果配置1个全局意图，当intent_id值为2时，执行这个全局意图。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549929.png "点击放大") - 如果配置2个全局意图，当intent_id值为3时，执行第2个全局意图。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390059.png "点击放大") | | （1+N）+1\~1+N+M | 子工作流意图。如果配置了子工作流，intent_id值在此范围内，则会执行对应的子工作流。 N为全局意图从上往下的序号。 M为子工作流从上往下的序号。 | - 如果不配置全局意图，配置1个子工作流，当intent_id值为2时，执行这个子工作流。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549935.png "点击放大") - 如果不配置全局意图，配置2个子工作流，当intent_id值为3时，执行第2个子工作流。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549947.png "点击放大") - 如果配置1个全局意图、1个子工作流，当intent_id值为3时，执行这个子工作流。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390063.png "点击放大") - 如果配置1个全局意图、2个子工作流，当intent_id值为3时，执行第2个子工作流。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390073.png "点击放大") | | （1+N+M）+1\~1+N+M+K | 子智能体意图。如果配置了子智能体，intent_id值在此范围内，则会执行对应的子智能体。 N为全局意图从上往下的序号。 M为子工作流从上往下的序号。 K为子智能体从上往下的序号。 | - 如果不配置全局意图、子工作流，配置1个子智能体，当intent_id值为2时，执行这个子智能体。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549967.png "点击放大") - 如果不配置全局意图、子工作流，配置2个子智能体，当intent_id值为3时，执行第2个子智能体。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790456.png "点击放大") - 如果不配置全局意图，配置1个子工作流、1个子智能体，当intent_id值为3时，执行这个子智能体。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790476.png "点击放大") - 如果不配置全局意图，配置1个子工作流、2个子智能体，当intent_id值为4时，执行第2个子智能体。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790460.png "点击放大") - 如果配置1个全局意图、1个子工作流、1个子智能体，当intent_id值为4时，执行这个子智能体。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950332.png "点击放大") - 如果配置1个全局意图、1个子工作流、2个子智能体，当intent_id值为5时，执行第2个子智能体。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790444.png "点击放大") | #### 相关操作 在"多智能体配置"页面，对画布的操作如下。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549941.png "点击放大") 表4画布操作 | 图标 | 说明 | |:---|:---| | ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390093.png) | 显示/隐藏缩略图。 | | ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950326.png) | 查看画布节点。 | | ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390091.png) | 缩小/放大画布内容。 | | ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790480.png)/![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950320.png) | 全局折叠/展开节点。 | | ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390065.png) | 画布内容居中显示。 | | ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950296.png) | 画布内容布局优化。 | #### 常见问题 - **Q1：意图识别准确率低，用户意图频繁路由错误，怎么办？** 排查步骤： 1. 检查"子工作流执行逻辑提示词"是否清晰描述了各意图的区分边界。 2. 如果使用大模型识别模式，尝试切换至"高精识别模式"并配置意图包。 3. 增加每个子工作流卡片上的意图描述，提供更多示例语句。 4. 适当降低最大对话历史轮次，减少历史干扰。 - **Q2：配置了默认工作流，但用户无意图时系统仍然无响应？** 检查默认工作流的执行动作是否设置为"终止"，如果设为"继续"，可能导致流程未正常结束。 - **Q3：intent_id计算后与实际路由不符？** 重新核对配置中全局意图、子工作流、子智能体的排列顺序。intent_id严格按照界面从上到下的顺序生成，调整顺序后映射关系随之变化。 - **Q4：工作流一直在子工作流之间循环跳转？** 降低最大跳转次数，并检查子工作流的执行动作设置，确认不需要继续流转的工作流已设置为"终止"。