意图识别节点

意图识别节点调用大模型理解自然语言输入，把请求分配到预设意图分支。它适合客服分流、业务办理入口、功能型 Agent 路由等无法仅靠固定条件稳定判断的场景。

例如，可以把用户请求划分为“售前产品咨询”“售后故障处理”和“账号与订单服务”；无法可靠归类的输入进入固定的“其他意图”分支。

工作方式

节点接收 query，逐项比较意图说明，并返回命中的编号。意图项从上到下按 1、2、3……编号；未命中时返回 0。

模式	可配置内容	输出特点	适合场景
极速模式	隐藏模型和系统提示词，由平台使用预设模型配置完成分类	返回 classificationId，reason 固定为空字符串	意图边界清晰、需要快速搭建的简单分类
完整模式	可选择模型、调整模型参数并填写系统提示词	返回 classificationId 和模型生成的分类原因	领域规则复杂、需要控制模型或补充判定边界

新建节点默认使用完整模式。切换模式会重置固定输出；从完整模式切到极速模式还会清空系统提示词。切换前请先复制仍需保留的内容。

极速模式的分支数量

极速模式在画布上只生成前 5 个意图的可连接分支。即使配置区还能继续添加意图，超过 5 个的意图也无法在画布中连接后续节点，因此极速模式应控制在 5 个意图以内；更多类别请使用完整模式，或先拆成多级分类。

配置步骤

1. 选择极速模式或完整模式。
2. 为 query 引用开始节点的用户输入，或上游节点处理后的文本。
3. 按业务边界添加意图说明，并检查各意图是否互斥。
4. 使用完整模式时，选择模型并按需补充系统提示词。
5. 将每个意图分支和“其他意图”分支连接到对应后续节点。
6. 配置超时、重试次数后，用正常、模糊和越界输入分别试运行。

完整模式会显示模型与系统提示词配置：

极速模式隐藏模型与系统提示词，只保留分类所需的核心配置：

输入

节点固定使用必填输入 query，变量名不可修改或删除。

query 支持固定文本和变量引用。实际工作流通常引用开始节点中的用户输入；如果上游已经完成文本清洗、转写或内容提取，也可以引用对应输出。

建议只传入与本次分类有关的内容。大量无关上下文会增加 Token 消耗，也可能干扰分类结果。节点以 query 作为分类输入；普通工作流配置无需手工新增会话历史字段。

意图匹配

节点至少保留一个意图项。每个意图项都会生成一个独立分支，“其他意图”是固定兜底分支，不能删除。

意图说明不能只写“售后”“咨询”这类内部标签。应同时交代包含范围、排除范围和容易混淆的边界。例如：

意图	推荐说明
售前产品咨询	询问功能、版本、价格、试用或购买建议
售后故障处理	反馈无法使用、运行报错、性能异常或需要排查
账号与订单服务	登录、权限、账单、发票、退款或订单状态

编写时遵循以下原则：

• 类别尽量互斥，不要让两个意图同时覆盖同一种表达。
• 使用用户真实说法，而不是只写系统内部名称。
• 对容易混淆的类别写清正例、反例和排除条件。
• 无法确定时允许进入“其他意图”，不要要求模型强行匹配。

模型与系统提示词

只有完整模式显示模型和系统提示词。

模型配置用于选择可用模型并调整模型参数。系统提示词会追加到平台的分类指令中，适合补充领域术语、优先级和特殊边界，例如：

仅根据用户当前诉求分类。功能、价格和试用归入售前；
已经购买后的报错和不可用归入售后；登录、权限、账单、
发票、退款和订单状态归入账号与订单。无法确定时返回
其他意图，不要强行匹配。

不要要求模型在系统提示词中回答用户问题或生成长文；该节点只负责分类和分支选择。

输出与分支

节点固定提供两个只读输出：

输出	类型	说明
classificationId	Integer	命中意图的顺序编号。第一个意图为 1；未命中时为 0，并进入“其他意图”。
reason	String	完整模式返回模型给出的分类原因；极速模式固定返回空字符串。

每个意图分支都应连接对应的后续处理节点。“其他意图”建议连接澄清提问、通用答复、人工处理或明确的兜底流程。命中未连接的分支时，该路径不会继续执行后续业务节点。

异常处理

节点提供以下异常处理配置：

配置	说明
整体执行超时	默认 60 秒。界面可输入 0.1～60 秒，但节点定义和运行时的有效下限为 1 秒，建议配置 1～60 秒。
重试次数	可选择不重试、重试 1 次、2 次或 3 次。重试会再次调用模型，应同时考虑时延和模型消耗。
异常处理方式	固定为“中断流程”。

中断流程

模型调用超时、限流、网络失败或返回无法解析的分类结果时，节点会按重试次数再次调用；仍失败则中断当前路径。

配置建议

配置完成后，至少准备三组输入：

1. 明确命中：每个意图各准备 2～3 个典型表达，确认分支编号正确。
2. 容易混淆：使用同时提到两个业务词的表达，检查意图说明能否消除歧义。
3. 不属于任何类别：确认进入“其他意图”，而不是被强行归类。

完整模式还应检查 reason 是否与实际命中分支一致。极速模式的 reason 为空属于正常行为，后续节点不要依赖该字段做判断。

常见问题

为什么极速模式看不到模型和系统提示词？

极速模式仍会调用模型，但模型选择和提示词不在配置面板中展示；需要选择模型或增加领域规则时，应切换到完整模式。

为什么切换模式后系统提示词不见了？

从完整模式切换到极速模式会清空系统提示词，同时重置固定输出。频繁切换模式前应先复制需要保留的提示词。

为什么新增的第 6 个极速意图没有可连接端口？

极速模式只在节点卡片上生成前 5 个意图分支。请减少意图数量、改用完整模式，或拆成两级意图识别。

为什么选择其他异常处理方式后又变回中断流程？

意图识别节点的异常处理方式固定为“中断流程”。