デバッグの基本

キャンバス上でワークフローをデバッグする: デバッグ実行を開始して、結果を読み取って、失敗を見つけ、モックを使用してワークフローの部分をテストします。

デバッグは、ワークフローを構築したキャンバスと同じキャンバスで行われます。個別のデバッグ ビューはありません。デバッグ実行はキャンバスから開始され、キャンバスの下のパネルに結果が表示され、問題が発生するとキャンバスで変更が加えられます。

デバッグ セッションを開始する

Run Debug (▶) in the bottom toolbar of the canvas starts a debug run, in every tool. If the trigger has inputs, a dialog asks for their values. In Studio Web, Debug at the top left of the toolbar does the same. A panel appears below the canvas, and the execution trace fills in as each node runs.

[デバッグを停止] を選択すると実行が明示的に終了し、ワークフローに変更を加えると実行も終了します。フロー キャンバスには 、デバッグ コントロールとキャンバスの下にあるパネルの全容が記述されています。

結果を読み取る

キャンバスの下にある [ 実行 ] タブは 3 つの部分で構成されており、それぞれが異なる質問に回答します。

• デバッグ実行: 実行のリストです。各実行の名前、期間、期間が表示されます。
• 実行トレース: 実行されたすべてのノードが、タイミング、成功または失敗インジケーターとともに表示されます。トレースでノードを選択すると、そのノードがキャンバス上で強調表示され、ノード上でホバーすると、そのノードの開始日時と終了日時が表示されます。
• 詳細: 実行の場合、[ 変数]、[ インシデント]、および [メタデータ ] タブ。ノードの場合、ノードが受け取った入力と生成した出力。

[ インシデント ] タブには、実行のエラーがノード別にグループ化されて表示されます。各インシデントでは、失敗したノードの名前とエラー メッセージが含まれます。予期しない停止は、最初にそこで確認するのが最善です。

[ 変数 ] タブには、ランタイム変数の値が [ 入力 ] (ワークフローに渡される値)、 [出力 ] (ワークフローで生成された値)、 および [変数 ] (ワークフロー内の変数) の 3 つのセクションに表示されます。トレースでノードを選択すると、その時点でのステートが表示されます。[ 変数をフィルター ] フィールドでは、値を名前で検索します。

失敗を特定する

デバッグの実行後、キャンバス上の各ノードに成功または失敗のインジケーターが表示されます。失敗したノードは実行トレースでもマークされ、[ インシデント ] タブにエラー メッセージが表示されます。

エラー オブジェクトには、 message フィールド (人間が判読できる説明) と detail フィールド (技術的原因) が含まれます。[ message ] フィールドにはユーザーに表示される失敗の概要が表示されるので、ここから始めることができます。

モック ノードを使用する

静的モックでは、ワークフローの一部を単独でテストします。静的モックを持つノードは実行されず、モックされたデータはその後のノードに渡されます。これは、以前のノードの動作が遅い場合、ローカルで利用できない資格情報が必要な場合、または外部システムに依存している場合に便利です。ノードをダブルクリックすると開くノードの展開ビューの [ 出力 ] 列にモード メニューがあります。[静的モック] は実際の応答を、ノードが期待するデータに置き換えます。[生成] では LLM に応答を生成させます。出力モックは 両方を記述します。

一度に複数のノードをモックすると、デバッグ実行でワークフローの特定のセクションに的を絞ることができます。

ヒント

• 実行トレースが最初、インシデントが 2 番目: トレースには実行全体が表示され、インシデントには発生した実行のみが表示されます。
• 変数値からデータの不一致が明らかになる: ノードが受信したデータと次のノードが予期していたデータを比較します。
• 外部の依存関係をモックすると、反復処理を高速化できます。API を呼び出すノードや RPA プロセスをトリガーするノードをモックすると、外部システムを待つことなくロジックをデバッグできます。
• 小規模な反復処理の方が高速です。デバッグ サイクルごとに 1 回の修正の方が、すべてを 1 回のパスで修正するよりも効率的です。
• ノード名をわかりやすくすると、トレースが読みやすくなります。トレースとインシデントはノード名を参照し、ノードの動作を説明する名前を使用すると、トレースをスキャンしやすくなります。

次のステップ

• フロー キャンバス: デバッグ コントロールとキャンバスの下にあるパネル。
• エラー処理: ノードにエラー ブランチを設定します。
• 変数とデータ フロー: ノード間で変数がどのように動作するか。
• コミュニティ: UiPath フォーラムで質問したり、他のビルダーとワークフローを共有したりできます。