当工作流中需要为输出添加统一格式、将数据组装成JSON对象、或汇总多分支结果避免空值报错时，变量处理节点通过格式化、组合和聚合功能，使数据按期望形式流转到下游节点。
当需要为大模型输出添加格式化标记、为消息添加前缀或后缀，或组合多个变量和文本内容时，可以通过模板语法和变量引用，来组合变量和文本内容，实现格式化输出。
当需要将工作流中的多个变量格式化为JSON对象，用于API调用、数据存储或系统集成时，可以使用变量处理节点进行格式转换。
没有使用聚合分组：当工作流中有多个分支（如条件判断节点、意图分类节点），每次执行时只会运行其中一个分支，其他分支的输出为空值。如果直接将多个分支的输出变量作为下游节点的输入，下游节点（如大模型节点）会因为读取到空值而导致执行失败，因此必须为每一个分支都连接相同的后续处理节点（如大模型节点）。
使用聚合分组：可以将所有分支的输出变量添加到同一分组，自动选择执行分支产生的有效值输出，统一传递给下游节点，无需为每个分支重复连接相同的后续处理节点。
点击输出模式下拉框，可选择目标模式。变量处理节点支持三种输出模式。
在编辑框中直接输入待处理的内容，或通过输入“/”插入前置节点或会话变量，例如：
输出格式化的JSON类型，将输入的变量转换为JSON格式。
聚合分组模式用于从多个变量中选择一个有效值输出。节点会按照预设的策略，从分组内的多个变量中选择一个非空的值输出。
默认关闭。仅在API调用应用时生效，用于决定是否输出本节点内容。该功能即将下线。
本节点的输出结果存储在输出变量中，可作为变量被后续节点引用。
文本输出模式下，输出变量名为result，类型为String，值为模板内容处理后的文本结果。
变量名
String
输出变量名与配置的变量名一致，值为该变量的实际值。
聚合分组模式下，每个分组对应一个输出变量，变量名与分组名对应（如Group1、Group2等），类型为String，值为分组策略选择的有效值。
不可以。JSON输出模式生成的是单层键值对结构，所有值的类型均为String。如果需要嵌套结构（如包含数组或子对象的JSON），建议在下游节点中进行二次处理。
使用示例
文本输出模式
当需要为大模型输出添加格式化标记、为消息添加前缀或后缀，或组合多个变量和文本内容时，可以通过模板语法和变量引用，来组合变量和文本内容，实现格式化输出。
JSON 输出模式
当需要将工作流中的多个变量格式化为JSON对象，用于API调用、数据存储或系统集成时，可以使用变量处理节点进行格式转换。
聚合分组模式
没有使用聚合分组：当工作流中有多个分支（如条件判断节点、意图分类节点），每次执行时只会运行其中一个分支，其他分支的输出为空值。如果直接将多个分支的输出变量作为下游节点的输入，下游节点（如大模型节点）会因为读取到空值而导致执行失败，因此必须为每一个分支都连接相同的后续处理节点（如大模型节点）。
使用聚合分组：可以将所有分支的输出变量添加到同一分组，自动选择执行分支产生的有效值输出，统一传递给下游节点，无需为每个分支重复连接相同的后续处理节点。
接入节点
方式一：通过加号按钮添加
- 点击画布上任意节点末尾的加号按钮。
- 在弹出的节点列表中选择变量处理节点。
- 节点自动添加到画布并与上游节点建立连线。
方式二：拖拽节点
- 在左侧节点库中找到变量处理节点。
- 将节点拖拽到画布上的目标位置。
- 手动将节点连接到上游节点（拖拽上游节点的输出端到变量处理节点的输入端）。
核心配置
输出模式
点击输出模式下拉框，可选择目标模式。变量处理节点支持三种输出模式。
文本输出
在编辑框中直接输入待处理的内容，或通过输入“/”插入前置节点或会话变量，例如：
- 简单变量引用：插入变量开始节点/query，输出用户输入的内容
-
格式化输出：在变量前后添加文本，例如您好！您的问题是：
{{开始节点/query}}，我会尽快为您解答。 -
多变量组合：组合多个变量和文本，例如用户
{{开始节点/name}}的问题{{开始节点/query}}已处理完成，结果：{{大模型节点/result}}。
JSON输出
输出格式化的JSON类型，将输入的变量转换为JSON格式。
| 列名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 变量名 | String | 是 | JSON对象的键名，用于标识输出JSON中的字段。支持字母、数字、下划线，不能为空，不能包含特殊字符。建议使用有意义的名称（如name、question、answer）。 |
| 引用方式 | 选项 | 是 | 输入：可在变量值中直接输入文本内容。引用：可在变量值中引用上游节点的输出变量或内置变量。 |
| 值 | String | 是 | 引用方式为输入时直接输入文本内容；引用方式为引用时输入 / 触发变量选择菜单，选择要引用的变量。 |
聚合分组
聚合分组模式用于从多个变量中选择一个有效值输出。节点会按照预设的策略，从分组内的多个变量中选择一个非空的值输出。
| 选项 | 说明 | 示例 |
|---|---|---|
| 返回每个分组中第一个非空的值 | 默认选项，按变量顺序返回第一个有值的变量。适用于条件判断节点多分支聚合场景，无论哪个分支执行都能获取到有效的变量值。 | 分组中有var1（空）、var2（“值2”）、var3（“值3”），输出“值2”。 |
| 返回每个分组中最后一个非空的值 | 按变量顺序返回最后一个有值的变量。适用于需要获取最新值的场景。 | 分组中有var1（“值1”）、var2（空）、var3（“值3”），输出“值2”。 |
结果返回
默认关闭。仅在API调用应用时生效，用于决定是否输出本节点内容。该功能即将下线。
输出变量
本节点的输出结果存储在输出变量中，可作为变量被后续节点引用。
文本输出
文本输出模式下，输出变量名为result，类型为String，值为模板内容处理后的文本结果。
| 变量名 | 类型 | 说明 |
|---|---|---|
| result | String | 模板内容处理后的文本结果，包含变量引用和静态文本的组合内容。 |
JSON输出
| 变量名 | 类型 | 说明 |
|---|---|---|
| result | Object | 包含整个JSON对象，结构为 {"变量名1":"值1","变量名2":"值2",...}。 |
聚合分组
聚合分组模式下，每个分组对应一个输出变量，变量名与分组名对应（如Group1、Group2等），类型为String，值为分组策略选择的有效值。
| 变量名 | 类型 | 说明 |
|---|---|---|
| Group1 | String | 第一个分组的输出变量，值为分组策略选择的有效值（第一个或最后一个非空值）。 |
| Group2 | String | 第二个分组的输出变量（当存在多个分组时），值为分组策略选择的有效值。 |
常见用法
| 配合节点 | 输出模式 | 常见用法 |
|---|---|---|
| 大模型节点 → | 变量处理节点 | 文本输出 |
| 格式化大模型输出内容，为回复添加前缀、后缀或组合多个变量。 | 大模型节点 → | 变量处理节点 |
| → API节点 | JSON输出 | 将大模型提取的多个字段打包成JSON对象，供API节点调用。适用于需要结构化数据传递的场景。 |
| 变量处理节点 | → HTTP节点 | JSON输出 |
| 将多个变量格式化为JSON格式，传递给HTTP接口进行外部系统集成或数据存储。 | 条件判断节点 → | 变量处理节点 |
| 聚合分组 | 在条件判断节点的多个分支后使用聚合分组模式，自动选择执行分支产生的有效值输出，避免下游节点接收到空值导致报错。 | 意图分类节点 → |
| 变量处理节点 | 聚合分组 | 在意图分类节点的多个分支后使用聚合分组模式，将不同意图处理结果统一聚合后传递给下游节点，确保工作流正常执行。 |
| 变量处理节点 | → 大模型节点 | 聚合分组 |