变量聚合器节点

定义

【变量聚合器】节点用于将多个分支节点的输出变量合并为一个统一变量，方便下游节点使用。
它在多分支结构中尤其重要，可实现对不同路径的结果统一管理，避免下游节点重复配置。

d60ea5be1a2745a996abad22497f37f6

功能说明

在包含条件分支、问题分类、或多路径输出的流程中，不同分支可能输出结构相同但来源不同的变量。
通过变量聚合器节点，可以将这些变量聚合成一个统一输出，从而让后续节点（如 LLM、结束节点）只需引用一个变量即可。

主要用途

• 整合 分类节点 或 条件分支节点 的多路输出；
• 汇总多个 知识检索节点 的检索结果；
• 统一不同分支下的结果结构，便于下游 LLM 使用；
• 让复杂分支的流程在下游恢复为单一路径执行。

应用场景

1. 问题分类后的多路聚合

图片

假设“问题分类器节点”将用户问题分为「请假」与「报销」两类。
两条分支分别经过不同的知识检索节点获取结果。
若不聚合，下游节点需要分别配置两条路径的 LLM 节点与结束节点。

通过添加 变量聚合器节点，可以将两路知识检索结果汇总为一个统一变量 result，下游只需配置一次 LLM 节点即可。

2. IF/ELSE 条件分支后的聚合

图片

在条件分支场景中，不同条件路径可能产生不同结果（如文本内容或对象数据）。
使用变量聚合器可在条件汇合处，将两条路径的输出统一合并，简化后续节点配置。 这样无论流程走哪条路径，下游节点都能使用统一变量 result 访问结果。

数据类型要求

变量聚合器支持以下数据类型的聚合：

数据类型	示例说明
String	文本内容（如回答、提示词、摘要等）
Number	数值结果（如计算、统计输出）
File	文件对象（如上传文档或图片）
Object	结构化对象（如 JSON 响应）
Array	数组（如检索结果列表）

注意

• 变量聚合器只能聚合同一种数据类型。
• 若第一个输入变量为 String，系统会自动限制后续连线只能添加同类型变量。

聚合分组

开启 聚合分组 后，可在同一个节点中配置多组聚合，每组聚合同类型变量。
例如：

分组	聚合类型	来源变量	输出变量
组1	String	summary_1, summary_2	summary_result
组2	Array	retrieval_1.result, retrieval_2.result	merged_result

这让同一节点能同时合并多组数据，减少节点数量并保持结构清晰。

输出变量

聚合完成后，变量聚合器会输出一个统一变量，可直接传递给下游节点。

输出名称	类型	说明
result（默认）	同输入类型	聚合后的结果，可被下游节点引用

提示

可在节点设置中自定义输出变量名，建议命名清晰（如 merged_text、final_output）。

示例：制度问答应用

假设系统根据问题自动判断所属分类，并调用对应知识库检索。
最终需要统一让 LLM 输出答复：

开始节点（sys.query）
↓
问题分类器节点（报销 / 请假）
↓
知识检索节点（两个分支）
↓
变量聚合器（聚合检索结果）
↓
LLM 节点（使用 result 生成回答）
↓
直接回复节点

这样，无论用户问的是「请假流程」还是「报销标准」，LLM 节点都能通过相同变量 result 获取上下文，输出统一格式的回复。

小结

变量聚合器节点 是多分支逻辑中的关键组件，能让复杂流程重新“汇合”为单一路径。
通过它，可以：

• 合并不同分支的输出；
• 统一变量引用；
• 减少下游节点重复配置；
• 优化工作流结构清晰度。

在设计多分支智能体或复杂自动化流程时，变量聚合器是确保数据流简洁与一致性的核心节点。