循環節點

定義

循環節點用於在工作流程中重複執行一組節點。

當一個任務需要對多個物件執行相同處理邏輯時，可以使用循環節點。你可以在循環節點內部新增子節點，系統會依照指定的循環規則，多次執行這些子節點。

常見場景包括：

• 對一組客戶逐一產生跟進郵件
• 對一組裝置逐一產生使用報告
• 對一組訂單逐筆判斷狀態
• 對一組文件逐篇總結
• 對多行文字逐行處理
• 分頁查詢資料，並逐頁處理結果

循環節點單次執行最多支援 60 次。如果需要處理的資料超過 60 項，建議先拆分資料，或在前置節點中控制本次處理數量。

循環模式

循環節點支援三種循環模式：指定次數、遍歷集合、逐行遍歷。

指定次數

指定次數表示按照設定次數重複執行循環。

例如將循環次數設定為 5，循環內部節點會執行 5 次。

該模式適合固定執行次數的場景，例如固定產生 5 則內容，或固定執行 3 次檢查。

在指定次數模式下，目前循環的 Item 會隨循環次數變化：第 1 次循環時，Item 為 1；第 2 次循環時，Item 為 2，依此類推。

遍歷集合

遍歷集合用於處理陣列類型的資料。

該陣列通常來自前置節點的輸出變數。例如，前置節點可能先查詢出一組客戶、一組裝置、一組訂單，或解析出一個清單。循環節點選擇這個陣列變數後，會依照陣列元素的順序逐一執行循環。

陣列中有多少個元素，通常就會執行多少次循環，但單次循環最多支援 60 次。

例如，前置節點輸出一個客戶清單：

[
  {
    "name": "Alice",
    "email": "alice@example.com"
  },
  {
    "name": "Bob",
    "email": "bob@example.com"
  }
]

循環節點選擇該客戶清單作為輸入變數後，會執行 2 次循環：

• 第 1 次循環：Item 是 Alice 的客戶資訊。
• 第 2 次循環：Item 是 Bob 的客戶資訊。

在循環內部，大模型節點可以引用目前循環的 Item，為目前客戶產生郵件內容、分析客戶需求，或執行其他處理邏輯。

逐行遍歷

逐行遍歷用於處理多行文字。

系統會將文字依行拆分，每一行作為一個循環元素，執行一次循環。

例如輸入內容為：

a@example.com
b@example.com
c@example.com

循環節點會執行 3 次，每次處理一行電子郵件地址。

在逐行遍歷模式下，目前循環的 Item 是目前這一行文字。

該模式適合處理一行一個物件的資料，例如郵件清單、關鍵字清單、任務清單等。

循環內建變數

在循環節點內部，子節點可以使用循環提供的內建變數。

Item 是循環中最常用的變數，表示目前這一輪正在處理的資料。

不同循環模式下，Item 的含義不同：

• 指定次數：第 1 次循環時，Item 為 1；第 2 次循環時，Item 為 2，依此類推。
• 遍歷集合：Item 是陣列中的目前元素。
• 逐行遍歷：Item 是目前這一行文字。

Counter 表示目前循環進行到第幾輪。

Continue 是布林類型變數，用於表示目前循環是否繼續。

循環結果輸出

循環內部的節點每一輪都可能產生結果。

如果希望在循環結束後統一使用這些結果，可以在「循環結果輸出」中設定需要蒐集的變數。

例如：

• 每輪產生一封郵件，循環結束後得到郵件清單。
• 每輪分析一個裝置，循環結束後得到裝置分析結果清單。
• 每輪總結一篇文件，循環結束後取得所有摘要。

設定循環結果輸出後，系統會把每一輪中指定變數的結果彙總為陣列，供循環節點後續的節點繼續使用。

結束目前循環

循環內部支援新增「結束循環」節點，用於提前結束整個循環。

當流程執行到「結束循環」節點時，即使原本還有未執行完的循環次數或未遍歷完的資料，循環也會立即結束，不再繼續執行後續輪次。

該節點常與條件判斷節點搭配使用，用於在滿足某個條件時提前停止循環。

例如，在分頁查詢資料時，可以先設定一個較大的循環次數，用於逐頁請求資料。每一輪循環查詢一頁結果，並判斷目前頁是否已經是最後一頁。

• 如果還不是最後一頁，繼續下一輪循環。
• 如果已經是最後一頁，則進入「結束循環」，提前結束循環。

這樣即使循環次數還沒有達到上限，系統也不會繼續執行後續無意義的分頁查詢。

錯誤回應方法

循環節點支援設定錯誤回應方法，用於決定某一輪循環出錯時如何處理。

如果每一輪任務都很關鍵，建議使用「錯誤時終止」。
如果是批次處理任務，允許部分物件失敗，可以使用「移除錯誤輸出」。

輸出變數

循環節點會輸出以下變數：

其中，自訂輸出變數來自「循環結果輸出」設定。

例如，在循環內部用大模型節點產生郵件內容，並將該內容設定為循環結果輸出。循環結束後，循環節點會輸出一個郵件內容陣列，每個元素對應一輪循環產生的結果。

範例

假設銷售團隊需要給一組客戶產生跟進郵件。

流程可以這樣設計：

1. 前置節點輸出一個客戶清單，例如客戶名稱、電子郵件與跟進背景。
2. 循環節點選擇「遍歷集合」模式，並將客戶清單作為輸入變數。
3. 循環每次取出一位客戶，目前客戶資訊會作為循環內建變數 Item。
4. 循環內部新增大模型節點，讓大模型根據目前 Item 產生對應客戶的郵件內容。
5. 在「循環結果輸出」中蒐集每一輪產生的郵件。
6. 循環結束後，得到一組客戶郵件草稿。

在這個情境中，循環節點負責逐一取出客戶資訊；循環內部的大模型節點負責處理目前客戶；循環結果輸出負責將每一輪產生的郵件彙總起來，方便後續繼續傳送、審核或儲存。

常見問題解答

Q1: 如何將其他節點添加到迭代節點中？

在迭代節點內點擊「+ 添加」；循環內的節點可以自由拖放。

Q2: 這與使用代碼執行節點進行循環有什麼不同？

使用代碼執行節點進行循環操作需要編寫代碼，這對於沒有編程背景的人來說不太合適。迭代節點支持多種循環方法，使用起來更方便。