变量提取器节点
用于从一段用户输入中精确提取后续节点所需的变量，自动区分成功/失败分支并输出对应变量。
一、应用场景
- 表单意图解析：从自然语言描述中提取姓名、金额、日期等关键信息，驱动后续审批或填报节点。
- 口语命令拆解：将口语命令拆成结构化字段（操作、对象、参数），供工具或子流程调用。
- 投诉归档：从投诉文本中抽取产品、问题类型、紧急程度，写入数据库或知识库。
- 对话上下文抽取：从聊天记录中抓取地点、时间、人名等实体，供后续检索或回复节点使用。
二、添加变量提取器节点
- 在画布上点击前一节点右侧的
，在节点列表中选择 变量提取器。
- 拖动至合适位置，与前序节点连线输入锚点，与后续节点分别连接 成功 与 失败 两个输出锚点。
三、节点配置详解
1. 输入变量
- 仅支持上游节点的
string类型变量； - 用于提供给大模型进行变量提取的文本内容；
2. 模型选择
- 选择用于提取的 大模型。
- 模型未选择时无法保存，通过校验会提示“必须选择模型”。
3. 提取变量配置
- 至少添加 1 个变量，最多 10 个；名称需唯一。
- 点击“新增变量”打开弹窗，字段如下：
- 名称：必填；输出字段名。
- 类型：下拉
string / number / boolean。 - 描述：可选，提示模型如何理解该变量的作用。
- 必填：开关；开启后需要填写 失败提示（用于必填变量缺失时的提示文案）。
4. 输出变量
- 动态输出：每个提取变量都会生成同名输出字段，类型与配置一致，可在下游节点通过
{{变量名}}引用（仅限成功分支）。 - 固定输出（仅失败分支可用）：
failVarName：失败的变量名（必填变量未命中时写入）。failMessage：失败提示文案（来自“失败提示”或默认提示）。
- UI 中会突出显示这两个固定输出，并注明仅在连接到“失败”分支后可被消费。
5. 分支与校验
- 节点有 1 个输入锚点、2 个输出锚点：成功、失败；两条分支都必须连接后续节点，否则校验会报错。
- 校验规则：输入变量未选、类型非 string、未选模型、未添加变量、变量名重复、必填未填失败提示、成功/失败分支未连线都会被拦截。
四、示例
- 输入示例：“帮我订 3 张明晚北京到上海的高铁票，二等座。”
- 变量配置：
人数(number, 必填)、出发地(string, 必填)、目的地(string, 必填)、车次日期(string)。 - 成功时模型应返回：
{"人数":3,"出发地":"北京","目的地":"上海","车次日期":"明晚"}，下游可用{{人数}}等变量。
五、注意事项
- 变量来源限制：输入变量必须来自当前节点之前的串行节点，不能引用并行或后续节点输出。
- 输出可见性：
failVarName/failMessage仅在失败分支连线后可用，成功分支不可引用。 - 命名规范：变量名请避免空格和特殊字符，保持与下游节点引用一致。