出力モック

テスト実行中にノードの実際のアクションを実行せずに下流のロジックをテストするための Flow の出力モック。

出力モックを使用すると、ノードの実際のアクションを実際に実行することなく、テスト実行中に任意のノードに固定出力を定義できます。これは、実際のアクションが遅い場合やコストがかかる場合、またはデバッグ実行中に利用できない外部依存関係が必要な場合に、下流のロジックをテストするのに役立ちます。

モックのしくみ

ノードでモックを有効にすると、Flow はテスト実行中にノードの実際の実行をスキップし、モックされた出力値を直接挿入します。下流のすべてのノードは、ノードが正常に実行されたかのようにモックされた値を受け取ります。

モックはテスト実行中にのみ適用されます。パブリッシュ済みの運用環境のワークフローではアクティブになりません。

モックを設定する

1. キャンバス上でモックするノードを選択します。
2. 設定パネルで、[ モック出力 ] セクションを開きます。
3. モックのトグルを有効化します。
4. 挿入する出力値を入力します。ノードの出力スキーマに一致する有効な JSON を使用してください。

結果: ノードがモックされます。次回のテスト実行時に、フローは実際の実行をスキップし、代わりに値を下流に挿入します。

共通のユースケース

• 人間のノード — 実際の承認者を待たずに、承認または却下された応答をシミュレートします。
• HTTP 要求ノード — エラー応答を含む特定の API 応答をシミュレートし、エラー処理パスをテストします。
• エージェント ノード — AI エージェントの出力をシミュレートして、ワークフローでエージェントのさまざまな応答がどのように処理されるかをテストします。
• サブフロー ノード — 子ワークフローの出力をシミュレートして、親ワークフローを単独でテストします。

モックをリセットする

実際に実行されるワークフローを実行するには、テストを実行する前に、モックされた各ノードでモック トグルを無効化します。モックは、パブリッシュされたワークフロー定義の一部としては保存されません。

よくある間違い

• モックが有効な状態でのパブリッシュ — モックはパブリッシュ時に自動的に無効化されるため、運用環境でのリスクはありません。ただし、最終的なテスト実行の前にモックを無効にするのを忘れた場合は、実際の実行ではなく、偽のデータに対してテストしていることになります。
• ノードの出力スキーマと一致しないモック データを入力する — モックされた JSON が下流のノードが予期する形状と一致しない場合、実際のデータでは発生しない実行時エラーが下流で発生します。スキーマと完全に一致します。
• 一度にあまりにも多くのノードをモックする — 6 番目のノードをテストするために 5 つのノードをモックした場合、合格したテストではあまり多くがわかりません。実際に関心のある部分のテストを妨げているノードのみをモックします。

関連ページ

• 効果的にデバッグする
• 評価
• 人間のノード
• エージェント ノード