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