ループ処理：Loopコンポーネント（AI Flowi Workflow）
ループ処理を行うLoopは、項目を1つずつ処理して結果をまとめます。表形式データのソースと、各項目に適用するステップの間に配置します。
Loopはカタログに記載されていますが、Ai Flowiによる本番環境でのテストは行われていません。このリファレンスでは、AI Flowi Workflow 1.9.2でエクスポートされた入力と出力を説明します。
執筆：Ai Flowi · 公開日
入力
| 名前 | 型 | 必須 | 接続可能な入力型 | 説明 |
|---|---|---|---|---|
data | other | いいえ | DataFrame, Table | 繰り返し処理の対象となるソースです。DataFrameまたはTableの出力を接続してください。この入力に接続可能な型として記載されているのは、この2つです。 |
説明ではDataまたはMessageオブジェクトに言及していますが、エクスポートされたdata入力に記載されているのはDataFrameとTableのみです。前段の接続を選ぶ際は表の入力型に従ってください。説明だけでは、DataやMessageの接続が可能とはいえません。
出力
| 名前 | 表示名 | 型 | 用途 |
|---|---|---|---|
item | Item | JSON | ループ内で処理する個々の項目です。 |
done | Done | Table | ループ処理の結果をまとめたもので、Tableとして出力されます。 |
Loopを使う場面
1つのコレクションを項目ごとに処理し、その結果をまとめる必要がある場合にLoopを使います。ItemポートはJSON、DoneポートはTableを出力します。必要なポートに合わせて後続の入力を選んでください。ソースが別の型の場合、Loopを設定する前に、Table出力が記載されている Type Convertを確認してください。
関連情報：バッチ推論とは：行の対応を保ち、部分的な結果を照合する。
別のコンポーネントを選ぶ場合
単一のJSONオブジェクトのフィールドを変更する場合は、 JSON Operationsを選びます。1つのメッセージを比較し、2つの経路に分岐させる場合は、 If-Elseを使います。フローをコンポーネントとして再利用することが目的なら、 Sub Flowを検討してください。再利用するだけなら、項目の繰り返し処理は必要ありません。
最小構成の例
設定例です。実施済みテストの記録ではありません
これは貼り付けて使うJSON値ではなく、接続の例です。Loopに対してエクスポートされている唯一の入力名を使っています。
data- 前段のDataFrameまたはTable出力を接続します。
項目ごとのJSONはItem、まとめられたTableはDoneで確認してください。エクスポートには戻り用の独立した入力や、ループバックの接続設定の全体が記載されていないため、この例でも補っていません。
制限事項
- data入力は任意とされています。この指定だけでは、ソースが空の場合や未接続の場合に何が返されるかは分かりません。
- カタログには、Loopの繰り返し回数の上限、処理順序の規則、同時実行の設定、再試行ポリシーは示されていません。これらの動作を前提にする前に、設定したフローで確認してください。
- 提供された公開中のテンプレートページには、ループ全体を通したテストの記録はありません。接続例は、実行の成功や使用量の実測を裏付けるものではありません。
関連コンポーネント
Sub Flow · JSON Operations · Type Convert · If-Else
ノードの使用量
プラン：Goは年払いで月額USD8から（月払いUSD10）、Plusは月額USD16から（月払いUSD20）、Pro 100は月額USD80から（月払いUSD100）、Pro 200は月額USD160から（月払いUSD200）、Pro 500は月額USD400から（月払いUSD500）。毎月5,000～250,000 Flowi Tokensが含まれ、追加購入も可能です。ノード実行1回につき1トークン。サードパーティのAPIとモデルの利用料金は含まれません。
参照元
コンポーネントカタログ: flow_controls.LoopComponent、AI Flowi Workflow 1.9.2、2026年10月9日エクスポート。