Branch Aggregator（分支聚合器）

节点概述

节点英文名: Branch Aggregator
节点中文名称: 分支聚合器
支持场景: Chatflow Agent（支持）, Workflow Agent（支持）

功能说明

Branch Aggregator 节点通过分支聚合，将多个输入源或节点输出的变量汇聚为一个变量（如 array[string]），供后续节点使用。它能够将来自不同分支的数据进行整合，实现数据的汇聚和统一处理。

节点展示内容

1. 基本信息展示

• 图标: 节点专用图标
• 名称: 节点名称
• 输入变量: 显示节点 logo+ 变量名
• 注释: 用户添加的说明文字

2. 操作按钮

• 更多按钮: 点击后展示右键菜单内容

节点编辑区域

1. 模块状态

Branch Aggregator 节点分为两种大状态（由编辑面板中的「聚合分组」开关切换）：

a. 不分组状态

• 变量类型: 由选择的第一个变量决定了变量的类型（「变量赋值」区域右上角展示类型标识，如 ARRAY[STRING]）
• 添加变量按钮:
  • 当没有选择变量时，此时展现出全部的变量
  • 当选择了变量时，根据变量的类型筛选变量，添加变量
• 删除变量: 点击后删除变量
• 变量列表: 展示节点名称/变量名称

b. 分组状态

• 开启方式: 打开「聚合分组」开关后，变量赋值区切换为分组形态
• 分组管理: 每个分组 (如 Group 1) 单独添加需要赋值的变量
• 分组配置: 点击「+ 添加分组」创建多个分组
• 分组变量: 每个分组可以包含多个变量
• 输出变量: 每个分组产生一个独立的输出变量 Group N.output(any 类型),供下游分别引用

2. 下一步配置

• 支持添加下一个节点

运行逻辑

Branch Aggregator 节点的运行逻辑由后端实现，确保分支聚合的正确性。

右键操作

右键菜单包含以下选项：

1. 更改节点: 修改节点类型
2. 拷贝: 复制节点
3. 复制: 复制节点内容
4. 删除: 删除节点
5. 帮助链接: 跳转到帮助文档
6. 运行节点: 测试运行当前节点

测试运行

• 支持状态: 不支持测试运行
• 更改节点: 支持更改节点类型
• 复制功能: 支持复制、剪贴、删除操作

使用场景

1. 数据汇聚

• 多源数据: 将来自多个数据源的信息汇聚
• 分支结果: 整合不同分支的处理结果
• 并行处理: 合并并行处理的数据
• 流程整合: 整合多个流程的输出

2. 数据合并

• 列表合并: 将多个分支的同类型输出汇聚为一个列表
• 同类变量聚合: 将多个分支的同类型变量收敛为一个变量引用

3. 结果整合

• 报告生成: 整合多个分析结果
• 数据汇总: 汇总统计数据
• 结果对比: 对比不同分支的结果
• 决策支持: 整合决策所需的数据

4. 流程控制

• 条件分支: 处理条件分支的结果
• 循环结果: 整合循环处理的结果
• 异常处理: 整合异常处理的结果
• 状态管理: 管理流程状态

配置模式

1. 不分组模式

适用于简单的数据聚合场景：

配置步骤

1. 选择变量类型: 选择第一个变量，确定整体变量类型
2. 添加变量: 根据变量类型筛选和添加变量
3. 管理变量: 删除不需要的变量
4. 查看列表: 查看节点名称和变量名称

2. 分组模式

适用于复杂的数据聚合场景：

配置步骤

1. 创建分组: 创建多个分组
2. 分组配置: 为每个分组单独添加变量
3. 分组管理: 管理分组的变量
4. 分组整合: 整合不同分组的数据

最佳实践

1. 变量选择

• 类型一致: 选择相同类型的变量进行聚合
• 数据质量: 确保输入数据的质量
• 命名规范: 使用清晰的变量命名
• 数量控制: 合理控制变量数量

2. 分组设计

• 逻辑清晰: 按照业务逻辑进行分组
• 结构合理: 设计合理的分组结构
• 易于维护: 保持分组结构易于维护
• 可扩展性: 考虑后续扩展需求

3. 数据整合

• 格式统一: 保持数据格式的统一
• 类型转换: 必要时进行类型转换
• 错误处理: 添加适当的错误处理
• 性能优化: 考虑聚合性能

4. 结果输出

• 结构清晰: 保持输出结构清晰
• 信息完整: 确保输出信息完整
• 格式标准: 使用标准的输出格式
• 易于使用: 确保输出易于后续使用

配置步骤

1. 基础配置

1. 选择聚合模式（分组或不分组）
2. 配置输入变量
3. 设置变量类型

2. 变量管理

1. 添加需要的变量
2. 配置变量属性
3. 管理变量列表

3. 分组配置（分组模式）

1. 创建分组
2. 为分组添加变量
3. 配置分组属性

4. 测试验证

1. 检查配置正确性
2. 验证聚合结果
3. 调整配置参数

常见问题

Q: 如何选择聚合模式？

A: 根据数据复杂度和业务需求选择，简单场景用不分组模式，复杂场景用分组模式。

Q: 变量类型如何确定？

A: 变量类型由第一个选择的变量决定，后续添加的变量需要与第一个变量类型一致。

Q: 可以添加多少个变量？

A: 没有明确限制，但建议根据实际需求合理控制变量数量。

Q: 如何管理分组？

A: 可以创建多个分组，每个分组独立管理变量，最后统一聚合。

Q: 聚合结果如何输出？

A: 聚合结果会按照配置的格式输出，供后续节点使用。

注意事项

1. 类型一致性: 确保聚合的变量类型一致
2. 数据质量: 确保输入数据的质量和完整性
3. 性能考虑: 考虑大量数据聚合的性能影响
4. 错误处理: 添加适当的错误处理机制
5. 结果验证: 验证聚合结果的正确性