ワークフローやチャットフローアプリケーションは通常、複数のノードで構成され、それぞれのノードは相互に関連しています。アプリ全体が正常に動作するためには、各ノードの入出力が期待通りであることを確認する必要があります。 ノードデバッグ機能は、開発者がアプリケーションが設計通りに機能しているかを検証し、潜在的な問題を早期に発見して解決し、本番環境でのエラーを防ぐのに役立ちます。 ノードのデバッグには、単一ステップデバッグと段階的実行の2つの方法があります。

​
単一ステップデバッグ

​
方法の概要

単一ステップデバッグを使用すると、ワークフロー内の特定のノードを独立してテストすることができます。これにより、開発者はアプリケーションに新しいノードを追加する際にその機能を検証したり、特定のノードのエラーを診断したり、異なる入力に対するノードの応答をテストしたりすることができます。

​
操作手順

  1. ワークフローの編集画面でデバッグしたいノードを選択する
  2. ノードの設定ページで入力変数を入力する
  3. 実行ボタンをクリックしてノードを実行する
  4. ノードの出力結果と実行状態を確認する

​
例

ワークフロー内にHTTPノードを追加した場合、そのノードがAPIレスポンスを正しく取得して処理できるかを検証するために、単一ステップデバッグ機能を使用してノードの実際の動作状態をシミュレートし、下流ノードにデータが正しく渡されることを確認できます。 デバッグが完了したら、「最終実行」ページで現在のノードの実行状態、入出力、メタデータ情報を確認できます。エラーが発生した場合は、エラーメッセージを通じて問題を迅速に診断し、単一ノードの異常が全体の実行失敗につながるのを防ぐことができます。
応答ノードと終了ノードは単一ステップデバッグをサポートしていません。

​
段階的実行

​
方法の概要

ワークフローの運用は、データが一つのノードから次のノードへ正しく流れることに依存しています。ワークフローが複雑な場合、このプロセスはエラーが発生しやすく、よくある問題には以下のようなものがあります：
  • データ形式の不一致（例：テキストが数値を必要とするノードに渡される）
  • 変数の設定ミス
  • JSONデータの解析失敗
  • 変数パスの参照エラー
段階的実行によるノードデバッグ方法は、開発者が複雑なワークフローアプリケーション内でエラーを素早く特定するのに役立ちます。 ノードをデバッグしているとき、ノードの出力変数は変数検査にキャッシュされます。開発者は「変数検査」内で直接変数を修正し、上流変数内のデータを迅速に変更して、異なる値が下流ノードに与える影響を確認できます。 この方法は、相互に依存する複数のノードをテストするのに適しています。 ノードを実行すると、システムは自動的に出力データを「変数検査」ビューに保存します。以下の方法で潜在的な問題を排除できます：
  1. 実際のデータを確認する：ノード出力のデータが期待通りかを比較する
  2. テストデータを修正する：ビュー内で直接変数値を修正し、後続ノードへの影響をテストする
  3. データフローを検証する：データが下流ノードに正しく伝達されることを確認する

​
操作手順

  1. デバッグモードでアプリケーションを実行する
  2. アプリケーション下部の「変数検査」をクリックし、変数キャッシュを確認する
  3. デバッグが必要なノードを特定し、どの変数を参照しているかを確認する
  4. 「変数検査」内でその変数の値を修正し、ノードを再実行する
  5. 実行結果を比較する

​
例

例えば、次のようなワークフローがあるとします：データ取得(Aノード) → データ処理(Bノード) → 結果表示(Cノード)。 Bノードの機能はAノードの出力データに完全に依存しており、異なるデータがBノードの実行状況に影響を与えます。 Aノードを実行した後の出力変数値は「変数検査」に保存されます。開発者は「変数検査」内のデータを修正し、Aノードを手動で再実行することなく、Bノードへの影響を検証できます。 段階的実行の過程で、局所的なワークフローの実行状況を観察し、結果に基づいてノードの設定、データフロー、処理ロジックをタイムリーに調整し、ワークフローの効率性と正確性を確保できます。

​
ノードの実行記録の確認

各ノードの実行完了後に操作記録が生成され、ノード詳細ページの「最終実行」をクリックして確認できます。 アプリケーション全体の実行履歴を確認する場合は、実行履歴を参照してください。
このページを編集する | 問題を報告する