デバッグ ツール

デバッグ ツールを使用すると、ネストされたタスクを含む複雑なオートメーションのトラブルシューティングを行うことができます。 親および親に属する個々の子 Bots をデバッグして、問題の詳細を迅速に特定して解決します。 各子オートメーションを個別に調べて、オートメーションのすべての部分が正しく機能していることを確認することで、効率的で信頼性の高いオートメーション プロセスを実現できます。

デバッグ ツールの使用

[オートメーション] ページで、デバッグする Bot を選択して編集します。 デバッグ ツールには、[アシスタント] ユーティリティから、または Bot エディターからアクセスすることができます。

デバッグ ツールへのアクセス

からデバッグ ツールを呼び出してBot エディター次の操作を実行できます。
  • アクション 内でBotや変数を追加、更新、削除することができます。 デバッグ プロセスがまだ始まっていない限り、Bot の編集を続けることができます。
  • デバッグを開始すると、Botの Bot エディター 名の下に紫色のヘッダー バーが表示され、「Now debugging」の後にデバッグ中の現在の Bot 名が表示されます。
  • ヘッダー バーには、Bots の階層型スタック リストも、[コール スタック] に表示されるのと同じように表示されます。 Bots のこのスタック リストから、特定の Bot に移動し、どの行にステップ インして現在の子 Bot にアクセスしたかを確認できます。 ヘッダー バーにはリンクも表示され、現在の Bot から離れた場合でも、そのリンクをクリックすれば、現在の Bot に移動してデバッグを続けることができます。
  • ヘッダー バーの下には、[アシスタント] に表示されものと同じデバッグ コントロールが表示され、素早くアクセスしてデバッグを制御できます。
  • の左側にある [アクション] パネルは自動的に折り畳まれます。Bot エディター これにより、水平領域が増え、デバッグ中に アクションに追加されたBot エディターを表示できるようになります。 デバッグが停止すると、[アクション] パネルが再び展開します。
注:
  • デバッガーを起動しても、デバッグは開始されません。
  • デバッグを開始する前に、Bots の検証エラーを修正するようにしてください。
  • [フロー] ビューおよび [リスト] ビューで Bot をデバッグすることができます。 ただし、アクションを見やすくするために、Bot[リスト] ビューで をデバッグすることをお勧めします。
、API エディター、またはテンプレート エディターから [アシスタント] ユーティリティを開き、特定の位置に移動すると、エディターを終了しても、エディターは Bot エディター[アシスタント] ユーティリティの最後の位置を保持します。 以下の場合でも、[アシスタント] ユーティリティのデフォルトの位置は、エディターを終了する前の最後に移動した位置に対応します。
  • ユーザー セッションがタイムアウトした場合、またはブラウザが突然閉じられた場合。
  • 別のブラウザからエディターを開いた場合、または同じユーザー資格情報を使用して別のセッションにログインした場合。

これにより、[アシスタント] の操作性が向上し、エディター内で を開くたびに [アクションアシスタント] をエディターの右側に移動してBot パネルを表示する必要がなくなりました。

デバッグ コントロール

注:
  • ステップ インできる子 Bots の数に制限はありません。
  • 子 Bot のデバッグ機能は、Bot エージェント (バージョン 22.60.23 以降) およびタスク Bot パッケージ (バージョン 2.8.0-20230530-152744 以降) でサポートされています。
アクション アイコン キーボード ショートカット 説明
デバッグ開始 スタートボタン F6 [デバッグ開始] を使用してデバッグ プロセスを開始します。
次のアクションへのステップ ステップオーバーボタン F7 [次のアクションへのステップ] を使用して、一度に 1 つのアクションをデバッグします。 現在のアクションをデバッグした後で、[次のアクションへのステップ] を使用して、次のアクションに順番に移動することができます。
次のブレークポイントに進む [次のブレークポイントに進む] ボタン F6 [次のブレークポイントに進む] を使用して、次のブレークポイントに直接移動します。 [次のブレークポイントに進む] は、現在のアクションを実行した後、次のブレークポイントに移動して一時停止します。
注: デバッグ中は、[デバッグを開始] のアイコンが [次のブレークポイントに進む] に変わります。
現在のアクションにステップ イン ステップインボタン F8 [現在のアクションにステップ イン] を使用して、デバッグのために子 Bot プロセスにステップ インします。 [現在のアクションにステップ イン] は、Bot TaskBot > 実行 を使用して子 アクション を呼び出している場合にのみ有効になります。
現在の Bot からステップ アウト ステップアウトボタン Shift + F8 デバッグ後に [現在の Bot からステップ アウト] を使用して、子 Bot からステップ アウトし、ステップ インした場所から Bot の次の行で一時停止します。
注: [現在の Bot からステップ アウト] は、子 Bot にステップ インした後にのみ有効になります。
デバッグ停止 ストップボタン Shift + F6 [デバッグ停止] を使用して、デバッグ プロセスを停止します。

コール スタック

コール スタックは、Bots が呼び出される順序を簡単に判断し、1 つの Bot から次の Bot にすばやく移動できるようにします。 コール スタックは、親子両方の Bots を含む、現在アクティブなオートメーションを、行番号とそれらが存在するフォルダーとともに一覧表示します。 現在アクティブな Bot が強調され、リストの一番上に表示されます。

コール スタックを使用すると、エラーの発生元からのパスを追跡して、エラーがどのように発生したかを把握できます。 これは、特にマルチレベルのネストによる複雑なオートメーションにおいて、問題の原因を特定するのに役立ちます。

ステップ インすると、子 Bot はコール スタックに追加されます。 子 Bot からステップ アウトするか、子 Bot のデバッグを完了すると、その Bot はコール スタックから削除されます。 親 Bot がすぐに現在の Bot になり、デバッグ対象となります。

コール スタックで選択した Bot に応じて、監視対象の変数 には、選択した の変数 が表示されますBot。 [監視対象の変数] リストから変数を選択し、現在の値を監視できます。

コールスタック ビュー

ブレークポイント

デバッグにおけるブレークポイントは、プログラムや自動化の実行を特定のポイントで一時停止することを可能にするツールです。 これにより、監視されている変数や実行フローを含むアプリケーションの現在の状態を検査でき、自動化が期待通りに動作することを確認できます。

ブレークポイントのコントロール

親と子のBotsでブレークポイントを有効にすると、Botの実行中にデバッグ プロセスを一時停止して、監視対象の変数の値やオートメーションの現在の状態を検査できます。 特定のアクションを一時停止してトラブルシューティングを行うには、その特定のアクションにブレークポイントを挿入することができます。 これは、複数のタスクや子自動化にまたがる複雑で長時間実行されるプロセスに役立ちます。

ブレークポイントを有効および無効にする方法を学ぶために、以下の表を確認してください。
アクション アイコンとキーボード ショートカット 説明
ブレークポイントを有効化

[ブレークポイントを有効にする] ボタン

F9

 ブレークポイントを挿入するには、特定のコード行で縦の 3 点リーダーをクリックし、[ブレークポイントを有効化] を選択します。

または、特定の行番号をクリックして、ブレークポイントを有効にすることもできます。 これにより、行番号の上にブレークポイント アイコンが表示されます。

注: 特定のコード行に対してブレークポイントを有効にすると、デバッグ ツールはその行をハイライトし、コード行の右側に一時停止ボタンを表示します。
ブレークポイントを無効化

[ブレークポイントを無効化] ボタン

F9

 ブレークポイントを無効にするには、特定のコード行で縦の 3 点リーダーをクリックし、[ブレークポイントを無効化] を選択します。 ブレークポイントが非アクティブになります。 また、特定の行番号の上にあるブレークポイント アイコンをクリックして、ブレークポイントを無効にすることもできます。
すべてのブレークポイントを消去

[すべてのブレークポイントを消去] ボタン

Shift + F9

 すべてのブレークポイントを消去するには、[すべてのブレーク ポイントを消去] アイコンをクリックします。

デバッグのためのブレークポイントの使い方

ブレークポイントを有効にすると、デバッグ中の特定のアクションがハイライトされ、そこに一時停止記号が表示されます。 デバッグ ツールを一時停止するブレークポイントを追加した後で、[次のブレークポイントに進む]、[次のアクションへのステップ]、[現在のアクションにステップ イン]、またはデバッグ プロセスの [停止] を選択することができます。

デバッグ中に特定の Bot に追加されたブレークポイントは自動的に保存され、オートメーションを閉じて再度開いたり、異なるデバッグセッション間を切り替えたりしてもすべてのブレークポイントが保持されることが保証されます。
注:
  • 特定の Bot をチェックインしても、Bot の新しいバージョンは作成されません。なぜなら、それはもはや変更されていないからです。
  • Botをコピーしてもブレークポイントはコピーされません。

ライン2にブレークポイントが追加されました

デバッグ中にその場でブレークポイントを設定できます。 例えば、既存の子 の親 Bot のステータBotスを確認したい場Bot合は、コールスタック を介してその に移動し、必要に応じて親 Bot の中にブレークポイントを追加できます。 ブレークポイントを有効にした後、次のブレークポイントに続く オプションをクリックすると、Bot は次のブレークポイントで一時停止します。これは、あなたが追加したばかりのものです。

特定の Bots でブレークポイントを有効にし、自動化をデバッグしながらその動作を観察するシナリオを探ってみましょう。
  1. クライアントオンボーディングのプロセスを自動化していると考え、このプロセスのために3つのBotsを作成しました。具体的には、クライアントデータコレクター Bot があり、これには検証プロセス Bot が含まれ、さらにウェルカムコミュニケーター Bot が含まれています。
  2. Welcome Communicator Bot内でデバッグを一時停止したい場所にブレークポイントを有効にします。
  3. [デバッグ開始] アイコンをクリックします。

    Botは自動的にウェルカムコミュニケーター Botに入り、設定されたブレークポイントで一時停止します。

  4. ウェルカムコミュニケーター Botから出てください。

    自動化は直接クライアントデータコレクター Botで一時停止することに気付くでしょう。

    注: どの特定の Bot からステップアウトする場合でも、Bot は親の Bot から入った行の直後の行で理想的には一時停止するべきです。 しかし、このシナリオでは、ウェルカムコミュニケーター Botに明示的にステップインしたわけではなく、ブレークポイントのために自動的に入ったのです。
  5. 同様に、ウェルカムコミュニケーターの最後の行からステップオーバーを実行すると、は直接BotクライアンBotトデータコレクターで一時停止します Bot。

デバッグ ツールの詳細については、「Leveraging code analysis and debug tool to improve and optimize your automation development」を参照してください。