ステップ実行
ワークフローやチャットフローアプリケーションは通常、複数のノードで構成され、それぞれのノードは相互に関連しています。アプリ全体が正常に動作するためには、各ノードの入出力が期待通りであることを確認する必要があります。
ノードデバッグ機能は、開発者がアプリケーションが設計通りに機能しているかを検証し、潜在的な問題を早期に発見して解決し、本番環境でのエラーを防ぐのに役立ちます。
ノードのデバッグには、単一ステップデバッグと段階的実行の2つの方法があります。
単一ステップデバッグ
方法の概要
単一ステップデバッグを使用すると、ワークフロー内の特定のノードを独立してテストすることができます。これにより、開発者はアプリケーションに新しいノードを追加する際にその機能を検証したり、特定のノードのエラーを診断したり、異なる入力に対するノードの応答をテストしたりすることができます。
操作手順
- ワークフローの編集画面でデバッグしたいノードを選択する
- ノードの設定ページで入力変数を入力する
- 実行ボタンをクリックしてノードを実行する
- ノードの出力結果と実行状態を確認する
例
ワークフロー内にHTTPノードを追加した場合、そのノードがAPIレスポンスを正しく取得して処理できるかを検証するために、単一ステップデバッグ機能を使用してノードの実際の動作状態をシミュレートし、下流ノードにデータが正しく渡されることを確認できます。
デバッグが完了したら、「最終実行」ページで現在のノードの実行状態、入出力、メタデータ情報を確認できます。エラーが発生した場合は、エラーメッセージを通じて問題を迅速に診断し、単一ノードの異常が全体の実行失敗につながるのを防ぐことができます。
応答ノードと終了ノードは単一ステップデバッグをサポートしていません。
段階的実行
方法の概要
ワークフローの運用は、データが一つのノードから次のノードへ正しく流れることに依存しています。ワークフローが複雑な場合、このプロセスはエラーが発生しやすく、よくある問題には以下のようなものがあります：
- データ形式の不一致（例：テキストが数値を必要とするノードに渡される）
- 変数の設定ミス
- JSONデータの解析失敗
- 変数パスの参照エラー
段階的実行によるノードデバッグ方法は、開発者が複雑なワークフローアプリケーション内でエラーを素早く特定するのに役立ちます。
ノードをデバッグしているとき、ノードの出力変数は変数検査にキャッシュされます。開発者は「変数検査」内で直接変数を修正し、上流変数内のデータを迅速に変更して、異なる値が下流ノードに与える影響を確認できます。
この方法は、相互に依存する複数のノードをテストするのに適しています。
ノードを実行すると、システムは自動的に出力データを「変数検査」ビューに保存します。以下の方法で潜在的な問題を排除できます：
- 実際のデータを確認する：ノード出力のデータが期待通りかを比較する
- テストデータを修正する：ビュー内で直接変数値を修正し、後続ノードへの影響をテストする
- データフローを検証する：データが下流ノードに正しく伝達されることを確認する
操作手順
- デバッグモードでアプリケーションを実行する
- アプリケーション下部の「変数検査」をクリックし、変数キャッシュを確認する
- デバッグが必要なノードを特定し、どの変数を参照しているかを確認する
- 「変数検査」内でその変数の値を修正し、ノードを再実行する
- 実行結果を比較する
例
例えば、次のようなワークフローがあるとします：データ取得(Aノード) → データ処理(Bノード) → 結果表示(Cノード)。
Bノードの機能はAノードの出力データに完全に依存しており、異なるデータがBノードの実行状況に影響を与えます。
Aノードを実行した後の出力変数値は「変数検査」に保存されます。開発者は「変数検査」内のデータを修正し、Aノードを手動で再実行することなく、Bノードへの影響を検証できます。
段階的実行の過程で、局所的なワークフローの実行状況を観察し、結果に基づいてノードの設定、データフロー、処理ロジックをタイムリーに調整し、ワークフローの効率性と正確性を確保できます。
ノードの実行記録の確認
各ノードの実行完了後に操作記録が生成され、ノード詳細ページの「最終実行」をクリックして確認できます。
アプリケーション全体の実行履歴を確認する場合は、実行履歴を参照してください。