通知の受信：Listenコンポーネント（AI Flowi Workflow）
通知の受信を担うListenのカタログ説明は、「通知を待ち受けるコンポーネント」です。
Listenはカタログに記載されていますが、Ai Flowiによる本番テストは行われていません。
執筆：Ai Flowi · 公開日
カタログの参照情報
Listenの参照情報： flow_controls.Listen 。2026年10月9日のAI Flowi Workflow 1.9.2エクスポートに含まれています。カテゴリの索引は、 コンポーネントカタログ を参照してください。
入力
Listenではcontext_keyが必須です。このフィールドはstr型で、Messageの接続を受け付けます。他のListen入力はエクスポートされていません。
| 名前 | 型 | 必須 | 対応する入力型 | 説明 |
|---|---|---|---|---|
context_key | str | はい | Message | 通知を待ち受けるコンポーネントに必須のコンテキストキーの値です。その形式と、通知との照合ルールは定義されていません。 |
出力
| 表示名 | 名前 | 型 |
|---|---|---|
| JSON | data | JSON |
Listenは、dataという名前のJSONポートを提供します。エクスポートには接続型が示されていますが、通知全体を包む構造、フィールド名、ペイロードの例は示されていません。
Listenを使用する場合
この項目に記載された通知の待ち受け機能がワークフローに必要な場合は、Listenを検討してください。context_keyを指定し、特定の通知ペイロードを前提とする処理に接続する前に、dataを確認してください。
別のコンポーネントを選ぶ場合
通知を送信する側を設計する場合は、 Notify と、その名称に関する注意点を確認してください。既存のMessageをそのまま転送する場合は、 Passを参照してください。別のフローを実行する場合は、 Run Flowのリファレンスを参照してください。
最小構成
設定例です。実施済みのテストではありません。
| カタログの入力名 | 設定値または接続の例 |
|---|---|
context_key | review-stage |
review-stageは、この例のために選んだ文字列であり、予約済みのイベント名ではありません。まずこの必須フィールドを設定し、エディターでリスナーを確認してください。この概略には、通知の配信記録や返されたJSONは含まれていません。
制約
- カタログには、タイムアウト、ポーリング間隔、バッファーサイズ、通知が届かない場合の動作は示されていません。待ち受けの実行がブロックするかどうかや、実行が有効なまま続く時間は判断できません。
- Notifyの説明にはGet Notifiedというコンポーネント名が出てきますが、この項目の名前はListenです。両者のcontext_keyフィールドから、対応関係を調べる余地はあります。ただし、エクスポートでは、その対応関係や照合ルールが明示的に確認されていません。
- Listenでは、配信順序、重複の処理、実行をまたいだ永続性、プロジェクトやセッションの適用範囲は規定されていません。コンテキストキーがアクセス制御の境界として文書化されているとは考えないでください。
- このリスナーには、エラー出力や失敗時の処理オプションは記載されていません。JSONポートが1つあることだけでは、復旧経路がある根拠にはなりません。
既存の一連の処理を示す例と、そのテスト範囲については、 文書化されたワークフローの一覧を参照してください。
ノードの使用量
リスナーの使用量については、 料金 と併せて、 コストガイドを参照してください。