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. 結果驗證: 驗證聚合結果的正確性