意图识别（Intent Recognition）指的是让智能体理解用户通过自然语言表达的意图或目的。意图识别是智能助手的典型能力，例如用户在对话中输入“我想查看今天的 AI 新闻”，其中“查看新闻”为用户意图，也就是用户希望智能体执行的操作。扣子编程的低代码工作流支持意图识别节点对用户意图进行归类，无需再通过大模型节点配合选择器节点实现意图识别，使工作流运行更加高效。

意图识别节点可用于以下场景：

客户服务：识别用户问题的类型，并转交各类知识库处理，对于知识库中未匹配的问题，转交人工客服处理。
医疗咨询：对用户咨询的医学问题进行归类，非医学问题的咨询则拒绝回复。
综合类智能体：对于功能多样的智能体，可以先由意图识别节点对用户咨询进行初步分类，转交各个 Agent 分支处理。

意图识别节点支持极速模式或完整模式运行。

极速模式：以较快的速度对用户意图进行分类，适用于关注工作流运行效率的场景。极速模式不支持设置系统提示词。
完整模式：意图识别效果优先，响应速度可能较长，适用于需要复杂逻辑判断的场景，例如剧情类游戏中根据情节发展切换剧情。完整模式往往需要选择意图识别能力较强的模型，并配合细致、严谨的提示词。

极速模式

极速模式下，意图识别节点配置如下：

配置项	说明
模型	选择执行意图识别的大模型，支持设置模型在此节点中的生成多样性、输入及输出设置等参数配置，使模型效果更符合你的预期。具体配置，请参考设置模型。意图识别节点中的模型仅支持通过 Chat API 调用，不支持 Responses API 调用。
输入	指定需要做意图识别判断的内容。输入参数默认为 query，可引用前置节点的输出参数，或输入指定内容。该参数通常引用开始节点中的用户输入。在对话流中，意图识别节点支持开启智能体对话历史，并设置会话轮数：对话历史：开启后模型在识别意图时会参考上下文信息，进行综合判断。会话轮数：设置带入模型上下文的对话历史轮数。轮数越多，多轮对话的相关性越高，但消耗的 Token 也越多。
意图匹配	用户意图的分类选项，支持设置多个分类，极速模式下最多可设置 10 个意图。对于匹配到这些分类的意图，处理流程会流转到对应的后续节点，若意图未匹配到此处定义的任何分类，则流转到兜底策略。极速模式下不支持配置系统提示词，来指定模型分类的提示词，请确保你配置的各个意图名称之间应有明确的区分度，减少交叉语义，以便模型正确分类。
输出	节点的输出参数，可作为变量被后续节点引用。输出参数固定为： classificationId：每个意图的 ID。根据意图匹配中配置的意图，从上到下依次排序，第一个意图的 ID 为 1。若未命中已配置的任何意图，则 ID 为 0，执行其他分支。 reason：分类的原因和依据，由模型自动生成。

对话流中的意图识别节点极速模式配置示例如下：

完整模式

完整模式下，意图识别节点配置如下：

配置项	说明
模型	选择执行意图识别的大模型，支持设置模型在此节点中的生成多样性、输入及输出设置等参数配置，使模型效果更符合你的预期。具体配置，请参考设置模型。意图识别节点中的模型仅支持通过 Chat API 调用，不支持 Responses API 调用。
输入	指定需要做意图识别判断的内容。输入参数默认为 query，可引用前置节点的输出参数，或输入指定内容。该参数通常引用开始节点中的用户输入。在对话流中，意图识别节点支持开启智能体对话历史，并设置会话轮数：对话历史：开启后模型在识别意图时会参考上下文信息，进行综合判断。会话轮数：设置带入模型上下文的对话历史轮数。轮数越多，多轮对话的相关性越高，但消耗的 Token 也越多。
意图匹配	用户意图的分类选项，支持设置多个分类，完整模式下最多可设置 50 个意图。对于匹配到这些分类的意图，处理流程会流转到对应的后续节点，若意图未匹配到此处定义的任何分类，则流转到兜底策略。
系统提示词	追加的系统提示词。扣子编程已指定一系列提示词，用于指导大模型合理识别用户意图并分类，你也可以追加提示词、提供各个分类的用户输入示例，使模型分类更精准。
输出	节点的输出参数，可作为变量被后续节点引用。输出参数固定为： classificationId：每个意图的 ID。根据意图匹配中配置的意图，从上到下依次排序，第一个意图的 ID 为 1。若未命中已配置的任何意图，则 ID 为 0，执行其他分支。 reason：分类的原因和依据，由模型自动生成。

对话流中的意图识别节点完整模式配置示例如下：

配置完成后，将意图识别节点与其他节点连接，形成完整的调用链路。

意图识别节点的每个意图分类，都需要与后续的处理节点相连接，否则意图命中此分类时无法触发后续的处理流程。例如在客服智能体中，产品咨询的分类可以流转至产品咨询知识库节点处理。
推荐为意图识别节点设置兜底策略，若意图未匹配到此处定义的任何分类，则流转到兜底策略处理。

异常处理

默认情况下，节点运行超时、运行异常时，工作流会中断，工作流调试界面或 API 中会返回错误信息。你也可以手动设置节点运行超时等异常情况下的处理方式，例如整体执行超时、是否重试、是否跳转异常分支等。

异常处理设置 说明

异常处理设置	说明
整体执行超时	整体执行超时是指节点运行的最大耗时，如果超过此时长，则判断为该节点运行超时。默认情况下，节点的超时时间为 60s，即 1 分钟。你也可以将其改为 0.1s~60s，灵活控制超时时间。
重试次数	节点运行超时或异常时，默认不重试，你也可以设置为重试 1 次。
异常处理方式	节点运行超时或异常时，默认中断工作流。你也可以手动修改此节点的异常处理方式：中断流程：工作流执行中断，不再运行后续节点。返回设定内容：发生异常后，工作流运行不会中断。开发者可自定义设置需要返回的输出字段内容，必须是输出中已定义的字段，且格式为合法的 JSON 格式。另外，节点还会返回输出参数 `isSuccess`、`errorBody`，传递节点异常的详细信息。执行异常流程：发生异常后，工作流运行不会中断，转而执行异常流程分析，开发者需要为新增的异常分支配置处理流程。异常信息会通过节点的输出参数 `isSuccess`、`errorBody` 返回。

整体执行超时

整体执行超时是指节点运行的最大耗时，如果超过此时长，则判断为该节点运行超时。

默认情况下，节点的超时时间为 60s，即 1 分钟。你也可以将其改为 0.1s~60s，灵活控制超时时间。

重试次数节点运行超时或异常时，默认不重试，你也可以设置为重试 1 次。

异常处理方式

节点运行超时或异常时，默认中断工作流。你也可以手动修改此节点的异常处理方式：

中断流程：工作流执行中断，不再运行后续节点。
返回设定内容：发生异常后，工作流运行不会中断。开发者可自定义设置需要返回的输出字段内容，必须是输出中已定义的字段，且格式为合法的 JSON 格式。另外，节点还会返回输出参数 isSuccess、errorBody，传递节点异常的详细信息。
执行异常流程：发生异常后，工作流运行不会中断，转而执行异常流程分析，开发者需要为新增的异常分支配置处理流程。异常信息会通过节点的输出参数 isSuccess、errorBody 返回。

示例

以客户服务类型的工作流为例，通过意图识别节点对用户问题进行归类，并流转至不同知识库处理，对于非售前或售后的咨询，统一转交人工处理。

核心节点如下：

意图识别节点：将用户问题分为售前咨询或售后问题，每个分类提供典型示例作为分类的依据，帮助模型更精准地识别用户意图。
知识库节点：售前和售后问题分别流转到售前知识库和售后知识库处理，并直接输入给结束节点。你也可以按需在知识库节点之后增加一个大模型节点，用于处理未命中知识库的问题。
文本处理节点：意图识别的兜底策略，对于未命中任何分类的意图，统一输出一段文案，指导用户提交工单或联系人工客服。

常见问题

意图分类不准确应如何处理？

意图识别的准确性受多个因素影响，例如模型性能、分类配置、提示词等。如果发现意图分类不符合预期，你可以参考以下建议提升意图识别节点分类的准确性：

调整分类：确保意图分类简洁明了，避免模糊不清或容易混淆的语义。分类之间应有明确的区分度，减少交叉语义，以降低分类混淆的可能性。例如，应避免“动物”和“动植物”这样的分类重叠。
选择完整模式：完整模式下可以设置提示词，提升意图分类效果。
填写系统提示词：提供具体的用户输入示例，帮助模型更准确地理解并执行分类任务。
切换模型：即使在分类和系统提示词都已优化的情况下，意图识别的准确性仍然不理想，建议尝试切换不同的模型，以找到最适合你需求的模型。

文档对您有帮助吗?