> ## 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.

# Agents にイテレーションを追加する

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

## 概要

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

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

キーワードや URL のリスト内の各項目に対して LLM プロンプトを実行する場合など、Agent が複数の値に対して繰り返しアクションを実行する必要がある場合は、Iteration ノードを使用します。例としては次のようなものがあります。

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

## Iteration ノードを追加する

Agent Editor で **+** アイコンをクリックし、**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 ノードの設定には、リストを渡すことと、各イテレーションで実行されるステップを構築することの 2 つが必要です。このノードには、より広範な Agent ビルダーをモデルにした独自の自己完結型エディターが含まれています。

<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 ノードには、Agent の入力としてリストが必要です。リスト入力を設定するには、入力ノードを選択して新しい入力を追加し、ドロップダウンから **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 ノードの出力は、デフォルトでその中にある最後のノードの出力になります。

### イテレーションのステップを追加する

Agent エディターにノードを追加するのと同じ方法で、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 ノードの要件

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

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