创建并配置多智能体
多智能体应用根据用户意图，将请求路由分发至对应的子工作流或子智能体执行，实现多场景的统一调度。多智能体应用的更多介绍请参考多智能体应用介绍。
本节介绍配置多智能体应用的流程。
前提条件
创建多智能体
创建多智能体基础信息。
- 登录AgentArts智能体平台。
- 在左侧导航栏，选择“开发中心 > 智能体管理 ”。
- 选择“多智能体”页签，单击“创建多智能体”。
- 在“创建多智能体”页面，配置基础信息，具体参数说明请参考表1。 图1 创建多智能体
- 单击“立即创建”。
创建后，进入“多智能体配置”页面，初始只有一个“多Agent控制器”节点。创建的多智能体应用显示在多智能体应用卡片列表中。
全局配置
在“多智能体配置”页面右上方，单击“全局配置”。
全局配置可配置输入参数和全局变量，这些都可以给工作流的输入参数使用。
输入参数的值不可修改，全局变量的值可被子工作流的输出参数覆盖，请注意区分使用场景。
| 参数 | 说明 |
|---|---|
| 输入参数 | 传给工作流的输入参数，且值不可修改。 单击
|
| 全局变量 | 传给工作流的输入参数，工作流如果有相同名称和类型的输出参数会覆盖该值。 单击
|
配置多Agent控制器
配置多智能体，实现特定业务能力。
- 单击“多Agent控制器”卡片，在弹出页面配置参数信息。 图3 配置多Agent控制器
- （可选）配置模型。
此处的模型用于意图识别和路由调度，负责理解用户输入的意图并决定路由到哪条工作流或智能体。
“模型配置（可选）”与“意图识别”参数，至少填写一个。如果意图识别工作流或意图包未返回有效意图，则使用选择的模型进行意图识别。
AgentArts支持在下拉框中选择合适的模型，如Kimi-K2。已接入的模型服务详见模型。
模型的标签展示顺序从左到右依次是用户自定义标签、接入模型服务时的“选择标签”、“模型类型”。
- 接入模型时的“选择标签”：
联网：表示该大模型具备联网搜索能力。
思考：表示该大模型具备思维推理能力。
工具：表示该大模型支持应用调用外部工具，例如，MCP服务、插件、知识库等。- default-import：表示该大模型是系统默认模型。
- 免费：表示该平台预置大模型可免费使用。
- 体验：表示该平台预置大模型可以体验，会话轮数最大为20次。
- “模型类型”包含：
文本：表示该大模型是文本对话类型。
视觉：表示该大模型是图像理解类型。
嵌入：表示该大模型是文本向量化类型。
排序：表示该大模型是文本排序类型。
- 模型状态：
- 未验证：表示该大模型未校验鉴权信息，不可使用。
- 成功：表示该大模型鉴权信息校验成功，可以使用。
- 失败：表示该大模型鉴权信息校验失败，不可使用。
在“模型配置”右侧，单击
，显示如下参数： - 核采样：
核采样（Top-P）用于限制模型的选词范围。 取值范围0~1，默认值为0.5。
- 值接近0时，模型只从概率最高的前10%词汇中选择，输出更集中。
- 值接近1时，不做限制，输出更多样。
建议该参数和“生成随机性”只设置1个，避免同时调整后效果不可控。
- 生成随机性：
生成随机性（temperature）控制模型输出的随机性和创造性，取值范围0.01~1，默认值为0.5。
- 数值越高（接近1）使输出更具多样性和创新性，适合创造性任务如小说创作。
- 数值越低（接近0）使输出更加确定和一致，适合基于事实的问答和售后客服场景。
建议该参数和“核采样”只设置1个，避免同时调整后效果不可控。
- 接入模型时的“选择标签”：
- （可选）配置子工作流执行逻辑提示词。
为编排控制器定义调度逻辑的系统提示词。通过自然语言描述子工作流的执行顺序、优先级规则和协作逻辑，指导模型做出正确的路由决策。
示例：你是一个智能客服调度系统。根据用户输入判断意图，按以下规则路由到对应的子工作流。 1、如果用户询问订单相关问题，执行“订单查询”工作流。 2、如果用户要求退换货， 执行“退换货处理”工作流。 3、如果用户表达不满或投诉，执行“投诉处理”工作流。 4、如果无法判断意图，执行默认工作流。
用户可单击
图标直接引用提示词模板；也可以自行撰写提示词，撰写后可单击
图标对系统提示词进行智能优化；也可单击
图标保存到模板，在“组件库 > 提示词”中可查看该模板。 - 配置意图识别。
选择该多智能体的意图识别能力。
“模型配置（可选）”与“意图识别”参数，至少填写一个。优先调用意图识别工作流或意图包。
- 大模型识别模式：由大模型对用户的输入进行意图理解并分类。选择此值时，“模型配置（可选）”需选择模型。
- 工作流识别模式：由开发者自行编排一个专门用来做意图识别场景的工作流进行处理，可以兼顾准确率和性能。
在“选择工作流”右侧，单击
，选择意图识别工作流。意图识别工作流的开始节点的输入参数、结束节点的输出参数配置有特殊要求。多智能体运行时，运行流程依次为：用户query -> 意图识别工作流 -> 根据意图识别工作流输出的intent_id执行任务。
意图识别工作流的开始节点的输入参数、结束节点的输出参数配置如下：- 开始节点必须配置如图4所示参数，参数名称和参数类型必须保持一致。
- messages：对话历史。
- role：角色。
- content：内容。
- intents：意图。
- id：意图序号，取值为从1开始的自然数。
- name：当id的取值为1时，表示没有明确意图或无法判断用户输入意图；当id的取值为非1时，表示对应的意图。
- messages：对话历史。
- 结束节点必须配置如图5所示参数，输出参数名称以及引用的值必须为integer类型。
intent_id：子工作流输出的意图结果。输出结果与多智能体中子智能体的对应关系请参考意图识别输出结果说明。
- 开始节点必须配置如图4所示参数，参数名称和参数类型必须保持一致。
- 高精识别模式：开发者预先创建意图包，预设多类意图场景，系统结合配置能大幅提升海量意图的识别准确率。
在“选择意图包”下的下拉框中选择意图包。单击“立即创建”可以创建意图包，具体操作请参考创建意图包。
- 配置子智能体。
每个子智能体对应一类用户意图或业务场景，多Agent控制器根据用户意图自动路由执行，调度逻辑可通过“执行逻辑提示词”灵活定义。
在子智能体右侧，单击
，支持添加工作流、多智能体。- 工作流：最多支持添加50个子工作流。
- 多智能体：在多智能体应用中，可以嵌套引用另一个多智能体应用，从而实现多层控制的效果。目前支持2级控制。最多支持添加50个智能体。
- （可选）配置全局意图。
定义全局性的意图识别规则。无论当前正在执行哪条子工作流，一旦检测到匹配的全局意图，将立即触发对应的处理动作。适用于随时可能出现的跨场景指令（如“转人工”、“退出”、“切换话题”）。
在“全局意图”右侧，单击
，输入意图名称、处理方式、意图的执行动作。支持如下处理方式：- 直接应答：配置一段文本，输出给用户。
- 流程跳转：关联一个工作流完成对应意图需要执行的动作。
支持如下执行动作：- 继续：按直接应答/工作流的执行结果，继续执行其他的子工作流。
- 终止：按直接应答/工作流的执行结果，调用结束工作流结束任务。
- 等待输入：按直接应答/工作流的执行结果，待用户输入问题后执行任务。
- （可选）配置起始工作流。
无论用户意图识别到哪条子工作流，起始工作流始终最先执行。适用于用户身份验证、会话初始化、欢迎语生成等前置操作。
未配置时，系统根据选择的模型、子工作流执行逻辑提示词或意图识别进行意图判断。
执行顺序：起始工作流 → 子工作流（按意图路由）→ 结束工作流
- （可选）配置默认工作流。
当用户的输入无法匹配您配置的任何一个子工作流所定义的业务意图时，系统将自动执行此处指定的默认工作流，并随即结束当前任务。
未配置时，当遇到无法识别的用户问题时，系统将无响应或报错终止，影响用户体验。
- （可选）配置结束工作流。
在所有子工作流执行完毕后固定执行的工作流。无论之前的意图路由经过了哪些子工作流，结束工作流始终最后执行。
适用于会话总结、满意度调查、数据清理等收尾操作。
执行顺序：起始工作流 → 子工作流（按意图路由）→ 结束工作流
- 配置最大对话历史轮次。
编排模型在进行意图识别时，最多参考的历史对话轮数。历史对话轮次越多，意图识别时消耗的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次。
- 配置完成后，单击“确定”。
设置后，进入“多智能体配置”页面。
- 在“多智能体配置”页面，显示多Agent控制器及添加的工作流、智能体及对应的工作流。
单击智能体卡片，用户可以自定义意图名称、意图描述。
单击智能体对应的工作流卡片，显示意图名称、意图描述、输入输出信息。
在工作流或智能体卡片上，单击“
> 工作流详情”或“
> 智能体详情”，查看工作流或智能体详情。在工作流或智能体卡片上，单击“
> 复制工作流ID”或“
> 复制智能体ID”，复制工作流或智能体ID。 - 在“多智能体配置”页面，可以调试、发布多智能体应用，调试与发布多智能体应用请参考调试多智能体应用、部署多智能体应用为API。
- 在“多智能体配置”页面，显示多Agent控制器及添加的工作流、智能体及对应的工作流。
意图识别输出结果说明
意图识别工作流的结束节点输出结果是由意图识别工作流产生，输出结果如下所示。表3所示的意图映射关系列表由多智能体的配置自动生成，从序号1开始递增。
输出结果示例：
{
"intent_id": 5
} | 任务的序号生成规则 | 说明 | 示例 |
|---|---|---|
| 1 | 系统默认意图（不明意图）。当用户输入无法匹配任何已知配置，指向此分类。 当intent_id值为1时，不执行任何任务，输出为空。 | - |
| 2~1+N | 全局意图。如果配置了全局意图，intent_id值在此范围内，则会执行对应的全局意图。 N为全局意图从上往下的序号。 | |
| （1+N）+1~1+N+M | 子工作流意图。如果配置了子工作流，intent_id值在此范围内，则会执行对应的子工作流。 N为全局意图从上往下的序号。 M为子工作流从上往下的序号。 | |
| （1+N+M）+1~1+N+M+K | 子智能体意图。如果配置了子智能体，intent_id值在此范围内，则会执行对应的子智能体。 N为全局意图从上往下的序号。 M为子工作流从上往下的序号。 K为子智能体从上往下的序号。 |
|
相关操作
在“多智能体配置”页面，对画布的操作如下。
| 图标 | 说明 |
|---|---|
|
| 显示/隐藏缩略图。 |
|
| 查看画布节点。 |
|
| 缩小/放大画布内容。 |
|
| 全局折叠/展开节点。 |
|
| 画布内容居中显示。 |
|
| 画布内容布局优化。 |
在多智能体应用卡片列表中，支持的其他操作请参考表5。
| 操作 | 说明 |
|---|---|
| 编辑多智能体应用信息 | 单击待编辑的多智能体应用卡片，进入“多智能体配置”页面，在名称右侧单击 如果配置的子智能体有新版本，在对应的卡片上单击 |
| 渠道管理 | 鼠标移动至已发布的多智能体应用卡片上，单击“渠道管理”，进入渠道管理页面，具体发布操作请参见部署多智能体应用为API。 |
| 获取多智能体应用的调用路径 | 鼠标移动至待获取调用路径的多智能体应用卡片上，单击“调用路径”，在“调用路径”页面，单击“复制路径”。 |
| 复制多智能体应用的ID | 鼠标移动至待复制ID的多智能体应用卡片上，单击“复制ID”。 |
| 删除多智能体应用 | 警告： 如果该多智能体已被引用，删除时将展示引用关系。删除会导致引用方运行异常，且不可恢复。 鼠标移动至待删除的多智能体应用卡片上，单击“更多 > 删除”。 |
| 查看智能体运行时数据 |
|
常见问题
- Q1：意图识别准确率低，用户意图频繁路由错误，怎么办？
排查步骤：
- 检查“子工作流执行逻辑提示词”是否清晰描述了各意图的区分边界。
- 若使用大模型识别模式，尝试切换至“高精识别模式”并配置意图包。
- 增加每个子工作流卡片上的意图描述，提供更多示例语句。
- 适当降低最大对话历史轮次，减少历史干扰。
- Q2：配置了默认工作流，但用户无意图时系统仍然无响应？
检查默认工作流的执行动作是否设置为“终止”，若设为“继续”，可能导致流程未正常结束。
- Q3：intent_id计算后与实际路由不符？
重新核对配置中全局意图、子工作流、子智能体的排列顺序。intent_id严格按照界面从上到下的顺序生成，调整顺序后映射关系随之变化。
- Q4：工作流一直在子工作流之间循环跳转？
降低最大跳转次数，并检查子工作流的执行动作设置，确认不需要继续流转的工作流已设置为“终止”。
