
# 主智能体场景：搭建手机银行助手多智能体应用
#### 前提条件
- 已完成[子场景1：搭建转账汇款工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0141.html)。
- 已完成[子场景2：搭建智能客服问答工作流](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0144.html)。
 
#### 创建多智能体应用
1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。

2. 单击左侧导航栏"开发中心 \> 智能体管理 "，选择"多智能体"页签，单击右上角"创建多智能体"。
3. 在"创建多智能体"页面，配置基础信息，具体参数说明请参考[表1]。
   
   图1创建多智能体   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389547.png "点击放大")
    表1基础信息参数说明 
   | 参数     | 配置示例                  | 说明                                                                                                                                        |
   |:---|:---|:---|
   | 名称     | 手机银行助手                | 多智能体应用的名称。由2\~64个字符组成，包含中英文、数字、下划线、中划线、空格，不能以空格开头或结尾。                                                                                     |
   | 描述     | 手机银行助手，支持转账汇款与智能客服问答。 | 多智能体的描述信息。由1\~1024个字符组成。                                                                                                                  |
   | 多智能体图标 | 使用默认图标                | 用户可通过单击![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389529.png)自动生成图标；单击默认图标按钮，可上传本地图片作为多智能体应用的自定义图标。 |
      
   
   
4. 单击"立即创建"。 
   创建后，进入"多智能体配置"页面，初始只有一个"多Agent控制器"节点。创建的多智能体应用显示在多智能体应用卡片列表中。
   
   
5. 配置多Agent控制器。 
   在"多Agent控制器"卡片上，单击鼠标左键，在弹出的页面配置参数信息，多Agent控制器参数说明请参考[图2]和[表2]。
   图2配置多Agent控制器   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549421.png "点击放大")
    表2多Agent控制器参数说明 
   | 参数                | 示例                                                                                                                                                                                                            | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   |:---|:---|:---|
   | 模型配置（可选）          | DeepSeek-V4-Flash                                                                                                                                                                                             | 此处的模型用于意图识别和路由调度，负责理解用户输入的意图并决定路由到哪条工作流或智能体。 注意： "模型配置（可选）"与"意图识别"参数，至少填写一个。如果意图识别工作流或意图包未返回有效意图，则使用选择的模型进行意图识别。 AgentArts支持在下拉框中选择合适的模型。 在"模型配置"右侧，单击![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549423.png)，显示如下参数： - **核采样** ： 核采样（Top-P）用于限制模型的选词范围。 取值范围0\~1，默认值为0.5。 - 值接近0时，模型只从概率最高的前10%词汇中选择，输出更集中。  - 值接近1时，不做限制，输出更多样。   建议该参数和"生成随机性"只设置1个，避免同时调整后效果不可控。   - **生成随机性** ： 生成随机性（temperature）控制模型输出的随机性和创造性，取值范围0.01\~1，默认值为0.5。 - 数值越高（接近1）使输出更具多样性和创新性，适合创造性任务如小说创作。  - 数值越低（接近0）使输出更加确定和一致，适合基于事实的问答和售后客服场景。   建议该参数和"核采样"只设置1个，避免同时调整后效果不可控。    |
   | 子工作流执行逻辑提示词       | ``` 你是一个智能多工作流控制器，具备精准分析用户意图和上下文理解能力，能够快速从所配置的业务工作流中智能匹配最合适的工作流。若无法选出匹配的工作流，则返回"none_exist"。对于非转账类业务请求，默认走客服问答流程。请确保响应准确高效。 ```                                                                               | 为编排控制器定义调度逻辑的系统提示词。通过自然语言描述子工作流的执行顺序、优先级规则和协作逻辑，指导模型做出正确的路由决策。 示例： ``` 你是一个智能客服调度系统。根据用户输入判断意图，按以下规则路由到对应的子工作流。 1、如果用户询问订单相关问题，执行“订单查询”工作流。 2、如果用户要求退换货， 执行“退换货处理”工作流。 3、如果用户表达不满或投诉，执行“投诉处理”工作流。 4、如果无法判断意图，执行默认工作流。 ``` 用户可单击![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389531.png)图标直接引用提示词模板；也可以自行撰写提示词，撰写后可单击![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549415.png)图标对系统提示词进行智能优化；也可单击![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687789938.png)图标保存到模板，在"组件库 \> 提示词"中可查看该模板。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   | 意图识别              | 大模型识别模式                                                                                                                                                                                                       | 选择该多智能体的意图识别能力。"模型配置"与"意图识别"参数，至少填写一个。优先调用意图识别工作流或意图包。 - **大模型识别模式** ：由大模型对用户的输入进行意图理解并分类。 选择此值时，"模型配置（可选）"需选择模型。   - **工作流识别模式** ：由开发者自行编排一个专门用来做意图识别场景的工作流进行处理，可以兼顾准确率和性能。 在"选择工作流"右侧，单击![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389541.png)，选择意图识别工作流。意图识别工作流的开始节点的输入参数、结束节点的输出参数配置有特殊要求，具体见后文。 多智能体运行时，运行流程依次为：用户query -\> 意图识别工作流 -\> 根据意图识别工作流输出的intent_id执行任务。   - **高精识别模式** ：开发者预先创建意图包，预设多类意图场景，系统结合配置能大幅提升海量意图的识别准确率。 在"选择意图包"下的下拉框中选择意图包。单击"立即创建"可以创建意图包。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   | 子智能体              | - 客服问答，继续  - 转账汇款，等待输入   | 每个子智能体对应一类用户意图或业务场景，多Agent控制器根据用户意图自动路由执行，调度逻辑可通过"执行逻辑提示词"灵活定义。 在子智能体右侧，单击![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949774.png)，支持添加工作流、多智能体。 - 工作流：最多支持添加50个子工作流。 添加工作流后，设置子工作流的执行动作，支持的执行动作如下： - **继续** ：执行完该工作流后，继续执行后续流程。有两种场景： **场景1：工作流间跳转后继续**。执行工作流A时，如果意图识别需要执行工作流B（且工作流B设为"继续"），则执行完工作流B后，返回工作流A，继续执行A中尚未完成的部分。 **场景2：工作流自身执行完毕后继续**。如果工作流A自身设为"继续"，则执行完工作流A后，调用结束工作流结束当前任务。   - **终止**：执行完该工作流后，调用结束工作流结束当前任务。  - **等待输入**：执行完该工作流后，暂停并等待用户输入问题后再继续执行。     - 多智能体：在多智能体应用中，可以嵌套引用另一个多智能体应用，从而实现多层控制的效果。目前支持2级控制。最多支持添加50个智能体。                                                                                                                                                          |
   | 全局意图              | 默认即可                                                                                                                                                                                                          | 定义全局性的意图识别规则。无论当前正在执行哪条子工作流，一旦检测到匹配的全局意图，将立即触发对应的处理动作。适用于随时可能出现的跨场景指令（如"转人工"、"退出"、"切换话题"）。 在"全局意图"右侧，单击![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389543.png)，输入意图名称、处理方式、意图的执行动作。 支持如下处理方式： - **直接应答**：配置一段文本，输出给用户。  - **流程跳转**：关联一个工作流完成对应意图需要执行的动作。   支持如下执行动作： - **继续**：按直接应答/工作流的执行结果，继续执行其他的子工作流。  - **终止**：按直接应答/工作流的执行结果，调用结束工作流结束任务。  - **等待输入**：按直接应答/工作流的执行结果，待用户输入问题后执行任务。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   | 高级配置 \> 起始工作流（可选） | 默认即可                                                                                                                                                                                                          | 在用户输入进入意图路由之前，首先执行此处指定的工作流。适用于需要预处理用户输入、收集初始信息等场景。 执行顺序：起始工作流 → 子工作流（按意图路由）→ 结束工作流                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   | 高级配置 \> 默认工作流（可选） | 默认即可                                                                                                                                                                                                          | 当用户的输入无法匹配您配置的任何一个子工作流所定义的业务意图时，系统将自动执行此处指定的默认工作流，并随即结束当前任务。 未配置时，当遇到无法识别的用户问题时，系统将无响应或报错终止，影响用户体验。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | 高级配置 \> 结束工作流（可选） | 默认即可                                                                                                                                                                                                          | 在所有子工作流执行完毕后固定执行的工作流。无论之前的意图路由经过了哪些子工作流，结束工作流始终最后执行。 适用于会话总结、满意度调查、数据清理等收尾操作。 执行顺序：起始工作流 → 子工作流（按意图路由）→ 结束工作流                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   | 高级配置 \> 最大对话历史轮次  | 默认即可                                                                                                                                                                                                          | 编排模型在进行意图识别时，最多参考的历史对话轮数。轮数越多，模型对上下文的理解越充分，但Token消耗也越高。设为0表示不引用历史对话，仅基于当前输入判断意图。 设置历史对话次数，选择N，记录最近N条会话内容。例如，选择10，记录最近10条会话内容。取值范围0\~100，默认值为10。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   | 高级配置 \> 最大跳转次数    | 默认即可                                                                                                                                                                                                          | 在一次用户会话中，编排控制器最多允许在子工作流之间跳转的次数。**防止因意图识别不稳定导致工作流之间无限循环跳转**。达到最大跳转次数后，系统将执行默认工作流并结束任务。 只有业务工作流之间跳转才会计算次数，起始工作流、结束工作流不计算跳转次数。取值范围0\~30，默认值为9。 例如，一个多智能体应用含5个工作流，分别为工作流A（起始工作流或默认工作流）、工作流B、工作流C、工作流D、工作流E（结束工作流），根据用户问题先执行工作流A，根据工作流A的结果执行工作流B，根据工作流B的结果执行工作流C，再根据工作流C的结果执行工作流D，最后执行工作流E，相当于跳转了3次。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
      
   
   
6. 单击"确定"。配置完成后如[图3]所示。
   
   图3手机银行助手多智能体   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949786.png "点击放大")
   
   
 
#### 调试多智能体应用
1. 编排多智能体应用后，在"多智能体配置"界面单击右上角![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949770.png)。
2. 在对话框中直接与智能体进行交互，实时观察其执行过程和响应效果，并根据需要对配置进行优化和调整。 
   检查节点设置是否有误，常见节点报错可参考[开发常见报错](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0228.html)和[常见问题](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0001.html)进行解决。
   图4效果展示1   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002687949442.png "点击放大")
   图5效果展示2   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717549093.png "点击放大")
   
   
 
#### 提交版本
1. 智能体试运行成功后，在"多智能体配置"页面，单击右上角"提交版本"。
2. 输入版本名称与描述，如[图6]所示，单击"确定"。
   
   这里以未部署至实例为例。
   图6提交版本   
   ![](https://support.huaweicloud.com/bestpractice-agentarts/zh-cn_image_0000002717389785.png)
   
   
3. 发布完成后，在"多智能体"页面的卡片上，显示"已提交"。
 
#### 相关文档
多智能体创建完成后，如果需要通过API调用，则需要将提交的版本部署至实例，具体操作请参考[部署多智能体应用为API](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0108.html)。
