反復処理 - Dify Docs

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版を参照してください。

反復処理ノードは、各要素に対して同じワークフローステップを順次または並列で実行することで配列を処理します。単一操作では制限に達したり非効率となるバッチ処理タスクに使用します。

反復処理の動作原理#

このノードは配列入力を受け取り、配列の各要素に対して一度実行されるサブワークフローを作成します。各反復処理中、現在のアイテムとそのインデックスが変数として使用可能になり、内部ノードから参照できます。

コアコンポーネント：

パラメータ抽出器、コードノード、知識検索、または HTTP リクエストレスポンスなどの上流ノードから配列変数を接続します。

各反復処理では以下にアクセスできます：

順次処理 - アイテムが順序通りに一つずつ処理されます

ストリーミングサポート - 回答ノードを使用して結果を段階的に出力できます

リソース管理 - メモリ使用量が少なく、実行順序が予測可能です

最適な用途 - 順序が重要な場合やストリーミング出力を使用する場合

個々の配列要素の処理失敗をどう処理するかを設定します：

終了 - エラーが発生した時点で処理を停止し、エラーメッセージを返します

エラー時継続 - 失敗したアイテムをスキップして処理を継

失敗結果を除去 - 失敗したアイテムをスキップし、成功した結果のみを返します

入出力対応の例：

章立てを個別に処理して長いコンテンツを生成します：

ワークフローステップ：

Info

パラメータ抽出の効果は、モデルの能力と指示の品質に依存します。より強力なモデルを使用し、指示に例を含めることで結果を改善できます。

反復処理ノードは配列を出力しますが、最終使用時には変換が必要な場合があります：

def main(articleSections: list):    return {        "result": "\n".join(articleSections)    }

{{ articleSections | join("\n") }}

最大トークン数管理 - コンテンツが大規模言語モデルのコンテキストウィンドウを超える場合、翻訳、要約、または分析のために大きなテキストをチャンクに分割します。

バッチ処理 - 複数のドキュメントや API コールの処理など、複数のアイテムに同じ操作を効率的に適用します。

品質管理 - バッチ全体の失敗リスクを避けるために、アイテムを個別に処理して品質を維持し、エラーを適切に処理します。

段階的出力 - すべての処理完了を待つ代わりに、完了した結果をストリーミング配信します。

適切なモードの選択 - 順序処理やストリーミングには順次モードを、速度が必要な独立した操作には並列モードを使用します。

**適切なエラーハンド処理を停止するかスキップするかに基づいてエラーハンドリングを設定します。

内部ワークフローの最適化 - 反復処理のサブワークフローは複数回実行されるため、効率的に保ちます。

リソース使用量の監視 - 複雑な処理を伴う大きな配列は、特に並列モードで大量のリソースを消費する可能性があります。