Automation 360

デバッグツール

PDF としてダウンロード

コンテンツ

デバッグツール

PDF としてダウンロード

最終更新日2024/10/24

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

デバッグツールの使用

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

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

からデバッグツールを呼び出してBot editor次の操作を実行できます。

actions 内でbotや変数を追加、更新、削除することができます。デバッグプロセスがまだ始まっていない限り、bot の編集を続けることができます。
デバッグを開始すると、botの Bot editor 名の下に紫色のヘッダーバーが表示され、「Now debugging」の後にデバッグ中の現在の bot 名が表示されます。
ヘッダーバーには、bots の階層型スタックリストも、[コールスタック] に表示されるのと同じように表示されます。 bots のこのスタックリストから、特定の bot に移動し、どの行にステップインして現在の子 bot にアクセスしたかを確認できます。ヘッダーバーにはリンクも表示され、現在の bot から離れた場合でも、そのリンクをクリックすれば、現在の bot に移動してデバッグを続けることができます。
ヘッダーバーの下には、[アシスタント] に表示されものと同じデバッグコントロールが表示され、素早くアクセスしてデバッグを制御できます。
の左側にある [アクション] パネルは自動的に折り畳まれます。Bot editor これにより、水平領域が増え、デバッグ中に actionsに追加されたBot editorを表示できるようになります。デバッグが停止すると、[アクション] パネルが再び展開します。

注:

デバッガーを起動しても、デバッグは開始されません。
デバッグを開始する前に、bots の検証エラーを修正するようにしてください。
[フロー] ビューおよび [リスト] ビューで bot をデバッグすることができます。ただし、actionsを見やすくするために、bot[リスト] ビューでをデバッグすることをお勧めします。

、API エディター、またはテンプレートエディターから [アシスタント] ユーティリティを開き、特定の位置に移動すると、エディターを終了しても、エディターは Bot editor[アシスタント] ユーティリティの最後の位置を保持します。以下の場合でも、[アシスタント] ユーティリティのデフォルトの位置は、エディターを終了する前の最後に移動した位置に対応します。

ユーザーセッションがタイムアウトした場合、またはブラウザが突然閉じられた場合。
別のブラウザからエディターを開いた場合、または同じユーザー資格情報を使用して別のセッションにログインした場合。

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

デバッグコントロール

注:

ステップインできる子 bots の数に制限はありません。
子 bot のデバッグ機能は、Bot Agent (バージョン 22.60.23 以降) およびTask Bot package (バージョン 2.8.0-20230530-152744 以降) でサポートされています。


アクション	キーボードショートカット	説明
デバッグ開始	F6	[デバッグ開始] を使用してデバッグプロセスを開始します。
次のアクションへのステップ	F7	[次のアクションへのステップ] を使用して、一度に 1 つのactionをデバッグします。現在のactionをデバッグした後で、[次のアクションへのステップ] を使用して、次のactionに順番に移動することができます。
次のブレークポイントに進む	F6	[次のブレークポイントに進む] を使用して、次のブレークポイントに直接移動します。 [次のブレークポイントに進む] は、現在のactionを実行した後、次のブレークポイントに移動して一時停止します。注: デバッグ中は、[デバッグを開始] のアイコンが [次のブレークポイントに進む] に変わります。
現在のアクションにステップイン	F8	[現在のアクションにステップイン] を使用して、デバッグのために子 bot プロセスにステップインします。 [現在のアクションにステップイン] は、bot TaskBot > 実行を使用して子 action を呼び出している場合にのみ有効になります。
現在の 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の実行中にデバッグプロセスを一時停止して、監視対象の変数の値やオートメーションの現在の状態を検査できます。特定のactionを一時停止してトラブルシューティングを行うには、その特定のactionにブレークポイントを挿入することができます。これは、複数のタスクや子自動化にまたがる複雑で長時間実行されるプロセスに役立ちます。

ブレークポイントを有効および無効にする方法を学ぶために、以下の表を確認してください。


アクション	アイコンとキーボードショートカット	説明
ブレークポイントを有効化	F9	ブレークポイントを挿入するには、特定のコード行で縦の 3 点リーダーをクリックし、[ブレークポイントを有効化] を選択します。または、特定の行番号をクリックして、ブレークポイントを有効にすることもできます。これにより、行番号の上にブレークポイントアイコンが表示されます。注: 特定のコード行に対してブレークポイントを有効にすると、デバッグツールはその行をハイライトし、コード行の右側に一時停止ボタンを表示します。
ブレークポイントを無効化	F9	ブレークポイントを無効にするには、特定のコード行で縦の 3 点リーダーをクリックし、[ブレークポイントを無効化] を選択します。ブレークポイントが非アクティブになります。また、特定の行番号の上にあるブレークポイントアイコンをクリックして、ブレークポイントを無効にすることもできます。
すべてのブレークポイントを消去	Shift + F9	すべてのブレークポイントを消去するには、[すべてのブレークポイントを消去] アイコンをクリックします。

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

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

デバッグ中に特定の bot に追加されたブレークポイントは自動的に保存され、オートメーションを閉じて再度開いたり、異なるデバッグセッション間を切り替えたりしてもすべてのブレークポイントが保持されることが保証されます。

注:

特定の bot をチェックインしても、bot の新しいバージョンは作成されません。なぜなら、それはもはや変更されていないからです。
botをコピーしてもブレークポイントはコピーされません。

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

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

特定の bots でブレークポイントを有効にし、自動化をデバッグしながらその動作を観察するシナリオを探ってみましょう。

クライアントオンボーディングのプロセスを自動化していると考え、このプロセスのために3つのbotsを作成しました。具体的には、クライアントデータコレクター bot があり、これには検証プロセス bot が含まれ、さらにウェルカムコミュニケーター bot が含まれています。
Welcome Communicator bot内でデバッグを一時停止したい場所にブレークポイントを有効にします。
[デバッグ開始] アイコンをクリックします。
botは自動的にウェルカムコミュニケーター botに入り、設定されたブレークポイントで一時停止します。
ウェルカムコミュニケーター botから出てください。
自動化は直接クライアントデータコレクター botで一時停止することに気付くでしょう。

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