# 高级意图识别 高级意图识别节点是普通[意图识别节点](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0069.html)的**增强版本** ，专为需要管理**20个以上意图** 的复杂场景设计。它通过**意图包** 集中管理大量意图分类，并使用**子工作流**为每个意图分支提供独立的处理逻辑，实现主工作流的模块化编排。 表1意图识别和高级意图识别节点差异 | 特性 | 意图识别节点 | 高级意图识别节点 | |:---|:---|:---| | 适用规模 | \<=20个轻量级意图 | \>20个企业级海量意图 | | 维护方式 | 节点内直接编辑 | 意图包统一管理 | | 执行逻辑 | 节点后直接连线分支 | 映射子工作流 | | 典型场景 | 简单问答、指令跳转（如3\~5个意图的客服引导） | 海量意图分类（如银行客服50+意图、综合政务100+意图、全功能电商助手80+意图） | ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) 当意图数量在20个左右时，如未来有扩展需求，建议直接选用高级意图识别节点，避免后续迁移成本。 #### 运作机制 高级意图识别节点的执行流程如下： 1. **接收** **输入**：接收用户输入文本，通过input参数传入。 2. **模型推理**：调用所配置的大模型，基于绑定的意图包中所有意图分类进行推理。 3. **输出分类**：输出分类结果（classification_id和name）。 4. **调度子工作流**：意图动作配置节点根据分类结果，调度对应的子工作流执行。 5. **结果回传** ：子工作流执行完成后，结果回传至主工作流继续执行。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) 意图动作配置是高级意图识别节点的配套节点，在高级意图识别节点保存后自动生成。它负责根据分类结果将请求路由到对应的子工作流，是主工作流与子工作流之间的桥梁。 #### 计费说明 - 高级意图识别节点每次执行都会调用大模型进行推理，产生Token消耗费用。意图数量越多，单次推理消耗的Token越高。 - 意图动作配置节点调度子工作流时，子工作流中的节点也会产生相应的执行费用。 #### 创建意图包 在配置高级意图识别节点前，必须先创建意图包。意图包是意图分类的"集中管理容器"，独立于工作流存在，可被多个工作流复用。创建意图包的操作请参见[创建意图包](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0095.html#agentarts_05_0095__section111835148562)。 #### 配置高级意图识别节点 配置高级意图识别节点的详细参数说明如下： #### 模型配置 选择要使用的模型。意图识别属于逻辑推理任务，建议选择推理能力强的模型，而非创意生成型模型。 您还可以单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390081.png)图标，调整模型配置。模型配置的详细说明可参考[选择并配置模型](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0017.html)。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/caution_3.0-zh-cn.png) 意图分类要求输出具有高度确定性，避免发散性结果，建议将"生成随机性"配置项设置为0。如需处理语义边界模糊的场景，可适当调至0.1\~0.2。 #### 输入参数 输入参数固定为1个，参数名称为input，且不可修改，类型是字符串，表示待进行意图识别的用户文本。 设置参数值时，支持"引用"和"输入"两种方式。 - 引用：支持引用三类参数源，工作流前置节点的输出参数、全局配置中的记忆变量（需预先设置），以及系统参数。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) - 最常见的配置：引用"开始"节点的输入参数"query"，即直接对用户输入进行意图分类。 - 进阶用法：引用"大模型"节点的输出参数"raw_output"，先用大模型节点对用户输入进行预处理/标准化，再进行意图识别。 系统参数列举如下： - "conversation_history"：存储当前对话的历史消息记录。 - "current_time"：获取当前的系统时间戳或时间字符串。 - "user_id"：识别当前用户的唯一标识符。 - "conversation_id"：当前工作流的唯一对话标识。 - "dialogue_count"：当前对话的轮次数计数。 - 输入：支持输入指定内容，适用于调试测试场景。 #### 意图配置 配置意图包后，节点将使用该意图包中的所有意图分类作为大模型推理的候选项。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/caution_3.0-zh-cn.png) 一个高级意图识别节点只能绑定1个意图包。若需管理更多意图，请在意图包中增加分类，或拆分为多级意图识别架构。 意图配置步骤如下： 1. 单击"请选择意图包进行配置"。您可以选择已配置的意图包，或单击"立即创建"创建一个新的意图包，可参见[意图管理](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0095.html)。 图1选择意图 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950016.png "点击放大") 2. **为意图配置工作流** 。为每个意图分支配置对应的处理逻辑。配置完成后单击"下一步"。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) 如需为所有意图配置相同工作流，可打开"为所有意图配置相同工作流"开关。 图2配置处理逻辑 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950012.png "点击放大") 3. **配置工作流的输入参数** 。配置完成后，单击"确定"。 图3配置输入参数 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389773.png "点击放大") #### 高级配置 高级配置默认使用系统提示词，也可自定义修改以优化意图识别效果。 - **提示词：** 如果不配置将会使用系统默认值。提示词的撰写直接影响意图识别节点的准确性。当意图识别效果没有达到预期时，可以调整提示词优化效果。例如可以在提示词中补充"用户提问飞机时，识别为预订机票功能。"，提升"预订机票"意图识别成功率。同时支持单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790168.png)快速插入输入参数，或在输入框中键入"{{}}" 快速引用参数。 - **历史对话轮次：**选择是否打开历史对话引用功能，默认为0即不会引用对话历史，配置N轮即可记录N轮对话的内容。 #### 输出参数 节点的输出参数，可作为变量被后续节点引用。 表2输出参数说明 | 参数名 | 类型 | 说明 | 示例值 | |:---|:---|:---|:---| | classification_id | Integer | 意图ID。根据意图配置中的顺序，从上到下依次排序，第一个意图ID为1；未命中任何已配置意图时ID为0，执行**其他意图**分支。 | 1 | | name | String | 意图描述名称。 | 文本翻译 | #### 配置意图动作配置节点 当高级意图识别节点绑定意图包并保存后，系统会自动生成一个意图动作配置节点。该节点为意图包中的每个意图分类创建一个出口分支，您需要为每个分支配置对应的子工作流。 1. 在画布中找到自动生成的"意图动作配置"节点。 2. **配置子工作流** 。单击意图动作配置节点，为每个意图配置分支对应的处理逻辑。配置完成后单击"下一步"。 图4配置处理逻辑 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549659.png "点击放大") 3. **配置子工作流的输入参数** 。配置完成后，单击"确定"。 图5配置输入参数 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389769.png "点击放大") 4. 连接意图动作配置节点和其他节点。 #### 相关操作 - 单击节点名称，可修改节点名称。 - 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549909.png)图标，可对节点进行重命名、复制、删除或更换节点；也可以将节点连接到结束节点。 - 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790412.png)图标，可对节点进行测试。 - 单击名称下面的节点说明，可修改节点的描述信息。 - 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549911.png)图标，可查看文档信息。 #### 常见问题 表3常见问题 | 问题现象 | 可能原因 | 解决方案 | |:---|:---|:---| | 意图包下拉列表为空 | 未在"配置管理\>意图管理"中创建意图包。 | 先创建意图包并添加意图分类，然后回到节点配置中刷新选择。 | | 意图动作配置节点未自动生成 | 高级意图识别节点未绑定意图包或未保存。 | 确认已选择意图包，并单击"确定"保存节点配置。 | | 用户输入被分到错误意图 | 1. 目标意图的示例不够丰富。 2. 另一个意图的示例覆盖面过宽。 3. 生成随机性过高。 | 1. 为正确意图添加更多样化的示例。 2. 缩小错误意图的示例范围。 3. 将生成随机性降至0.1或更低。 | | 始终走"其他意图"兜底 | 1. 意图示例与用户实际表达差异过大。 2. 输入参数未正确引用。 | 1. 用真实用户表达更新意图示例。 2. 确认input已引用开始节点的输入参数{{query}}。 | | 子工作流收不到主工作流的变量 | 意图动作配置节点未配置输入参数映射 | 在意图动作配置节点中为每个分支显式配置参数映射。 | | 子工作流执行完但主工作流无输出 | 子工作流的结束节点未定义输出参数。 | 在子工作流的结束节点中配置输出参数。 | | 同一输入多次测试结果不同 | 生成随机性设置过高（大量意图场景更敏感）。 | 将生成随机性降至0.05-0.1。 | | 意图数量很多时响应变慢 | 大模型需要处理大量候选意图的描述。 | 1. 考虑分层分类减少单次推理的候选项。 2. 选择推理速度更快的模型。 |