> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflows に反復処理を追加する

> Workflow でリストをループし、各項目に対して同じステップを実行します

## 概要

Iteration ノードは、Workflow 内でリストをループし、各項目に対して同じ一連のステップを自動的に実行します。

デフォルトでは、Workflow は 1 つの入力を処理し、1 つの出力を生成します。Iteration ノードはこれを拡張し、同じプロセスをリスト全体に適用することで、1 回の Workflow の実行で複数の入力を受け取り、複数の出力を生成します。

キーワードや URL のリストの各項目に対して LLM プロンプトを実行するなど、Workflow で複数の値にわたって同じアクションを繰り返す必要がある場合は、Iteration ノードを使用します。例:

* URL のリストを分析してコンテンツと構成に共通するテーマを特定し、それに応じて自社のコンテンツを最適化する。
* 複数のアンサーエンジン、リージョン、トピックにわたってプロンプトの回答を収集し、ブランドや製品のメンションを一括分析してトレンドを明らかにする。
* Reddit スレッドのリストを反復処理し、主要なナラティブや繰り返し現れるテーマに関する整理されたレポートを生成する。

## Iteration ノードを追加する

Workflow Builder で **+** アイコンを選択し、**Iteration** を選択します。または、ノード選択メニューから **Iteration** をワークフローにドラッグします。

<img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/agents/how-tos/add-iterations-1.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=e27ce5af180c5721a5fe148b19f6e95e" alt="iterations-1.png" width="3180" height="1760" data-path="images/agents/how-tos/add-iterations-1.png" />

Iteration には、入力として項目のリストが必要です。ノードは各項目を順番にループし、現在の項目を変数としてループ内のステップに渡します。

## Iteration ノードを設定する

Iteration ノードの設定には、リストを渡すことと、各反復で実行されるステップを構築することの 2 つが必要です。このノードには、Workflow Builder 全体をモデルにした独立したエディターが含まれています。

<img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/agents/how-tos/add-iterations-2.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=98f7f07319d8529b582fcaa9fe40842d" alt="Iterations_3.png" width="3180" height="1660" data-path="images/agents/how-tos/add-iterations-2.png" />

### リスト入力を反復処理する

Iteration ノードには、Workflow の入力としてリストが必要です。リスト入力を設定するには、入力ノードを選択して新しい入力を追加し、ドロップダウンから **List** を選択します。

<img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/agents/how-tos/add-iterations-3.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=a08f95d8f6866ef8cad9bcb46ac429f0" alt="Iterations_2.png" width="3180" height="1660" data-path="images/agents/how-tos/add-iterations-3.png" />

### Iteration ノードを設定する

ノードを選択してノード設定メニューを開き、反復処理の対象となる値としてリスト入力を選択します。

Iteration ノードの出力は、デフォルトでその中の最後のノードの出力になります。

### 反復処理のステップを追加する

Workflow Builder にノードを追加するのと同じ方法で、Iteration ノードにノードを追加します。Iteration エディターで **+** アイコンを選択してノードを選択するか、ノード選択メニューからノードをドラッグします。

<Tip>各ステップは、リストのすべての項目に対して繰り返されます。1 回だけ実行すべきノードは、Iteration エディターの外に配置してください。</Tip>

### 出力を構造化する

Prompt LLM ノードを使用する場合は、最終結果をマッピングするための出力フィールドを追加します。LLM プロンプトで、各フィールドにどの情報を入れるかを指定します。たとえば、「*各 URL を* `urls` *出力フィールドで返してください。*」のように指定します。次に、同じフィールドをノード設定で構造化出力フィールドとして追加します。

<img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/agents/how-tos/add-iterations-4.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=e7053239f50b1ea112f7912b2ee43b6b" alt="Screen Shot 2026-04-26 at 8.24.04 PM.png" width="2560" height="1438" data-path="images/agents/how-tos/add-iterations-4.png" />

## Iteration ノードの要件

Workflow が想定どおりに実行されるようにするには、いくつかの要件があります。

* 入力として使用するリスト変数は存在している必要があり、リストタイプを使用して Workflow の入力として作成されている必要があります。
* 現在の項目の変数は、ループ内のステップでのみアクセスでき、Iteration ノードの外のステップでは参照できません。
* ループ内のステップは、リストの項目ごとに 1 回実行されます。
* Workflow の実行を完了するには、Iteration ノードが End ステップまたは追加のステップに接続されている必要があります。
