# 意图识别
意图识别节点主要是让应用理解用户自然语言表达的意图或目的，可用于需要对用户问题进行分类，或者提供综合类功能有不同分支处理的场景。
通过对用户输入进行推理分析，匹配预定义的意图关键字类别，并根据匹配结果引导至相应的处理流程，该节点通常位于工作流的前置位置。
意图识别节点支持普通模式或高级模式运行。
- 普通模式：适用于对少量意图进行分类的场景，当意图数量小于或等于20时，选择意图识别节点。
- 高级模式：适用于对大量可归类意图进行分类的场景，当意图数量大于20时，选择[高级意图识别](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0070.html)。
#### 配置意图识别节点
**模型配置：**
选择要使用的模型。意图识别属于逻辑推理任务，建议选择推理能力强的模型，如Kimi-K2，而非生成型模型。
你还可以单击![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569424329.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"：当前对话的轮次数计数。
    

- 输入：支持输入指定内容，适用于调试测试场景。
**意图配置：**
用户意图的分类选项，支持设置多个分类。默认两个分支，用户可以单击"添加意图"添加多个意图分支，意图数量最多为20个。当所有预设意图均不匹配时会走到"其他意图"分支，这是兜底分支，通常连接到通用大模型节点，处理闲聊或未定义问题。
意图输入框中输入意图描述，是意图识别节点**最重要**的配置区域，决定了模型能否准确理解用户意图。配置质量越高，识别准确率越高。
好的意图描述应清晰定义边界以及包含关键要素，意图描述示例如[表1]所示。
 表1意图描述示例 
| 分类     | 描述内容                                  | 理由                   |
|:---|:---|:---|
| 好的意图描述 | 用户询问某个城市或地区的天气情况，包括当前天气、未来天气预报、气温、下雨等 | 列出具体场景和常见关键词         |
| 差的意图描述 | 查天气                                   | 过于简短，大模型无法理解该意图的完整范围 |
   
**高级配置：**
高级配置，可使用默认的提示词。当意图识别效果没有达到预期时，可以调整提示词优化效果。例如可以在提示词中补充"用户提问飞机时，识别为预订机票功能。"，提升"预订机票"意图识别成功率。
- **提示词：** 提供进阶开发者修改提示词，如果不配置将会使用系统默认值。提示词的撰写可能影响到意图识别节点的准确性。当意图识别效果没有达到预期时，可以调整提示词优化效果。例如可以在提示词中补充"用户提问飞机时，识别为预订机票功能。"，提升"预订机票"意图识别成功率。同时支持单击![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538384644.png)快速插入输入参数，或在输入框中键入' {' 快速引用参数。
- **历史对话轮次：**选择是否打开历史对话引用功能，默认为0即不会引用对话历史，配置N轮即可记录N轮对话的内容。
- **辅助识别：**
  开启辅助识别后，优先通过知识库分类样例的精确匹配进行意图识别，提升意图识别节点的分类能力。
  - 意图样例知识库：开启辅助识别，用户需要先创建分类样例知识库，向知识库上传意图FAQ，并选择配置该知识库。
  
  - 过滤标签：可填写意图样例知识库上传FAQ时打的标签值，表示在该标签范围内进行FAQ检索匹配。如果不填写，则默认在整个知识库范围下做FAQ检索匹配。
  
  - 匹配阈值：当分类样例的匹配度低于设置阈值时，会采用默认的大模型进行意图识别分类。阈值范围为0到1。
    
**输出参数：**
节点的输出参数，可作为变量被后续节点引用。
- classification_id，每个意图的ID。根据意图匹配中配置的意图，从上到下依次排序，第一个意图的ID为1。若未命中已配置的任何意图，则ID为0，执行**其他意图**分支。
- name，意图的描述。
 
#### 相关操作
- 单击节点名称，可修改节点名称。
- 单击![](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)图标，可查看文档信息。
 
#### 示例
以提供综合功能，对用户问题进行不同分支处理的工作流为例，通过意图识别节点对用户输入进行分类，流转至不同的功能模块进行处理。
比如提供翻译功能的工作流，节点配置如下：
图1配置示例   
![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569344355.png)
**意图识别节点：**
工作流将用户问题分为翻译、闲聊两个类别，节点的意图配置添加意图1的类别描述为"文本翻译"，类别后面连接翻译插件节点，实现翻译功能。
意图2的类别描述为"用户闲聊"，类别后面连接大模型节点，实现闲聊功能。
默认的其他意图类别后面连接消息节点，在消息节点中配置默认回复内容，实现未识别意图场景下的兜底回复。
#### 常见问题
表2常见问题 
| 问题现象             | 可能原因                                                                                                                                                                                                                                                                                                                 | 解决方案                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|
| 用户表达明确，但分到了错误的意图 | 1. 目标意图的描述不够具体。  2. 另一个意图的描述覆盖面过宽。                                                                                             | 1. 在正确意图的描述中添加该表达的关键词。  2. 在错误意图的描述中明确排除（"不包含XX场景"）。                                                                             |
| 同一输入多次运行结果不同     | 温度设置过高。                                                                                                                                                                                                                                                                                                              | 将温度降至0.1-0.2。                                                                                                                                                                                                                                                                                                              |
| 始终走"其他意图"        | 1. 意图描述与用户表达差异过大。  2. 输入参数未正确引用。                                                                                                    | 1. 优化意图描述，增加同义表达。  2. 检查input是否正确引用了开始节点的输入参数{{query}}。                                                                              |
| 辅助识别未生效          | 1. 知识库未绑定。  2. FAQ的"答案"与意图名称不一致。  3. 匹配阈值设置过高。   | 1. 确认已选择知识库。  2. 确保FAQ答案与意图名称完全相同（含大小写）。  3. 适当降低阈值。   |
| 输入参数下拉列表为空       | 节点未连接前置节点。                                                                                                                                                                                                                                                                                                           | 确保意图识别节点已连线到开始节点或其他上游节点。                                                                                                                                                                                                                                                                                                   |
| 意图数量超过20个无法添加    | 系统上限为20个。                                                                                                                                                                                                                                                                                                            | 考虑[高级意图识别节点](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0070.html)，高级意图识别支持20个以上意图。                                                                                                                                                                                                                |