意图识别

前提条件

已完成工作流搭建，如果未搭建工作流，请参考搭建工作流。

节点说明

意图识别节点通过对用户输入进行推理分析，匹配预定义的意图关键字类别，并根据匹配结果引导至相应的处理流程，该节点通常位于工作流的前置位置。

意图识别节点支持普通模式或高级模式运行。

• 普通模式：适用于对少量意图进行分类的场景。
• 高级模式：适用于对大量可归类意图进行分类的场景。

配置意图识别节点

1. 登录Versatile智能体平台，在左侧导航栏“个人空间”区域，选择进入所需空间。

   如果已选择团队空间，界面显示为实际的团队空间名称，而非“个人空间”。

   图1 选择团队空间
   

2. 在左侧导航栏选择“开发中心 > 应用管理 > 工作流应用”，单击您创建的工作流。
3. 单击“添加节点”并选择“意图识别”节点。
4. 通过单击该节点打开节点配置页面。
5. 参照图2和表1，完成意图识别节点的配置。
   

   • 单击图标，可修改意图识别节点名称，修改完成后单击名称旁边的进行保存。
   • 单击图标，可重命名意图识别节点名称，复制一个意图识别节点或删除意图识别节点。
   • 单击图标，可对意图识别节点进行测试。

   表1 意图识别节点配置说明

   配置类型	参数名称	参数说明	配置示例
   模型配置	模型选择	用于配置进行意图识别的大模型，可选择平台已接入的任一模型。	/
   	温度	当单击图标时，可进行该参数设置。 用于控制生成结果的随机性。调高温度，会使得模型的输出更具多样性和创新性；降低温度，会使输出内容更加遵循指令要求，但同时也会减少模型输出的多样性。	0.5
   	核采样	当单击图标时，可进行该参数设置。 模型在输出时会从概率最高的词汇开始选择，直到这些词汇的总概率累积达到核采样值，核采样值可以限制模型选择这些高概率的词汇，从而控制输出内容的多样性。建议不要与温度同时调整。	0.5
   	最大回复长度	当单击图标时，可进行该参数设置。 控制模型输出的Tokens长度上限。通常100Tokens约等于150个中文汉字。	131072
   参数配置	输入参数	参数名称：默认名称input，为固定值，不可编辑。 类型、值：支持“引用”和“输入”两种类型。 引用：支持用户选择工作流中已包含的前置节点的输出变量值和全局配置中的记忆变量。 输入：支持用户自定义取值。	一般选择“引用”开始节点的输入参数“query”，即对用户输入进行意图识别。
   意图配置	意图1	用于配置相关意图关键字信息，用户可以添加意图，意图类别默认为意图1、意图2...，意图数量最多为20个。 在意图输入框中输入意图描述信息，描述信息为针对该类别的描述语句或者关键词，也将作为大模型进行推理和分类的依据。	意图的设置和工作流中定义的处理流程相关，例如一个旅游助手工作流，提供天气查询、预订机票、预订酒店等能力，根据用户输入执行上述任一功能。按照对应能力定义意图关键字“天气查询”、“预订机票”、“预订酒店”。
   	其他意图	用于控制用户输入意图无法识别的场景，如果推理分析后无法匹配预定义的意图分类，会默认走其他意图对应分支执行后续流程。	其他意图主要用于处理上述定义意图无法匹配时的兜底逻辑，例如意图无法识别时需要返回一个兜底回复，可以在其他意图后接一个消息节点，消息节点中定义兜底回复的内容。定义意图无法识别时，触发“其他意图”分支，执行消息节点返回兜底消息。
   高级配置	提示词	高级可选配置项，提供进阶开发者修改提示词，如果不配置将会使用系统默认值。提示词的撰写可能影响到意图识别节点的准确性。	高级配置，可使用默认的提示词。当意图识别效果没有达到预期时，可以调整提示词优化效果。例如可以在提示词中补充“用户提问飞机时，识别为预订机票功能。”，提升“预订机票”意图识别成功率。
   	历史对话轮次	选择是否打开历史对话引用功能，默认为0即不会引用对话历史，配置N轮即可记录N轮对话的内容。	-
   	辅助识别	开启辅助识别后，优先通过知识库分类样例的精确匹配进行意图识别，提升意图识别节点的分类能力。 意图样例知识库：开启辅助识别，用户需要先创建分类样例知识库，向知识库上传意图FAQ，并选择配置该知识库。 过滤标签：可填写意图样例知识库上传FAQ时打的标签值，表示在该标签范围内进行FAQ检索匹配。如果不填写，则默认在整个知识库范围下做FAQ检索匹配。 匹配阈值：当分类样例的匹配度低于设置阈值时，会采用默认的大模型进行意图识别分类。阈值范围为0到1。	创建“词语分类”样例知识库，上传多对FAQ： 问题：三国演义；答案：文学作品 问题：光刻机；答案：科技 在意图识别节点配置意图为“文学作品”、“科技”，辅助识别选择“词语分类”知识库，匹配阈值设置0.9。
   参数配置	输出参数	输出参数为判断节点最后一轮的输出。	-

   图2 意图识别节点配置示例1
   
   图3 意图识别节点配置示例2
   

6. 节点配置完成后，单击“确定”。
7. 连接意图识别节点和其他节点。

示例

以提供综合功能，对用户问题进行不同分支处理的工作流为例，通过意图识别节点对用户输入进行分类，流转至不同的功能模块进行处理。

比如提供翻译功能的工作流，节点配置如下：

图4 配置示例

意图识别节点：

工作流将用户问题分为翻译、闲聊两个类别，节点的意图配置添加意图1的类别描述为“文本翻译”，类别后面连接翻译插件节点，实现翻译功能。

意图2的类别描述为“用户闲聊”，类别后面连接大模型节点，实现闲聊功能。

默认的其他意图类别后面连接消息节点，在消息节点中配置默认回复内容，实现未识别意图场景下的兜底回复。