意图识别节点

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

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

工作方式

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

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

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

极速模式的分支数量

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

配置步骤

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

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

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

输入

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

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

建议只传入与本次分类有关的内容。大量无关上下文会增加 Token 消耗，也可能干扰分类结果。旧文档中的“对话历史”和“会话轮数”目前没有出现在节点配置面板中，不应作为当前可配置能力使用。

意图匹配

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

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

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

编写时遵循以下原则：

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

模型与系统提示词

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

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

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

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

输出与分支

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

输出	类型	说明
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 个意图分支。请减少意图数量、改用完整模式，或拆成两级意图识别。

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

当前意图识别节点只支持“中断流程”。其他选项来自通用异常处理界面，但尚未被该节点实现。