UiPath for Coding Agents のトラブルシューティング

トラブルシューティング用のエージェントのコーディングにより、UiPath Platform で会話型診断を利用できます。マシン上の任意のターミナル (UiPath Studio に内蔵されているターミナルを含む) で障害が発生したことを平易な英語で説明します。スキルによって問題をトリアージし、考えられる原因をランク付けし、 uipを通じてプラットフォームのライブ データに対して各仮説を検証して、問題の原因とその修正方法を正確に説明します。

トラブルシューティング スキルは UiPath のスキル カタログに含まれており、 uip skills installを通じてコーディング エージェントにインストールされます。

動作のしくみ

診断セッションは、障害の種類に関係なく、同じ 4 段階のフローに従います。

1. トリアージ — ユーザーの説明、ジョブまたはプロセスの識別子、またはエラー メッセージから、失敗の範囲を分類します。入力が曖昧な場合、スキルは明確な質問をします。
2. 仮説の生成 — 関連するドメインプレイブックとトリアージ中に収集された証拠を利用して、考えられる原因のランク付けされたリストを作成します。
3. 仮説の検定 — 一度に1つの仮説を確認または削除します。このスキルは、ログ、トレース、キュー アイテム、修復データ、構成、監査イベントを uip を通じて取得し、証拠を収集します。
4. 解決策 — 根本原因、エラーの原因となった一連のイベント、および具体的な修正を提示します。スキルは、何かを変更する前に明示的な承認を求めます。

ユーザーは、トリアージ中の範囲の明確化、仮説生成のための追加のコンテキストの提供、必要に応じてソース コードまたは構成ファイルの提供、推奨される修正の承認の 4 つの時点で関与できます。

今日診断できること

トラブルシューティング スキルは、次のドメインをカバーしています。あなたは問題を説明します。スキルは証拠をフェッチし、根本原因を返します。

ドメイン	診断できること	質問の例
RPA	失敗したジョブ (SelectorNotFoundException、 TimeoutExceptionなど)、セレクターの不一致、キュー アイテムの失敗、Healing Agent のデータ分析	「今朝、InvoiceBot ジョブが失敗したのはなぜですか?」
Orchestrator	スタックまたは失敗したジョブ、権限とロールの問題、デプロイとパブリッシュのエラー、キュー設定の問題	「ロボットがファイナンス キューからアイテムをピックアップしないのはなぜですか?」
Maestro	エラーが発生したプロセス インスタンス、ステップレベルの障害、インシデント、エージェントまたは RPA が関与するマルチドメインの障害チェーン	「承認プロセスのインスタンスが手順 3 でエラーになったのはなぜですか?」

他の UiPath ドメインのサポートは既に実施されていますが、まだ強化されています。より多くのドメインとより豊富な診断が進行中です。

スキルは、ユーザーが持っているものと同じアクセス権で動作します。サインインしているユーザーとして特定のログやフォルダーを読み取れない場合、スキルが読み取ることもできません。

前提条件

1. エージェントに UiPath スキルがインストールされているエージェントごとのインストール コマンドについて詳しくは、「 UiPath CLI をコーディング エージェントとともに使用する 」をご覧ください。
2. ログイン中のセッション (uip login) です。「 認証」をご覧ください。

手順

「 UiPath CLI をマシンごとに 1 回コーディング エージェントと使用する 」で説明されている設定を実行します。その後は、すべてのセッションでスキルを利用できるようになります。

マシン上の任意のターミナルまたは UiPath Studio の内蔵ターミナルからコーディング エージェントを起動し、 /uipath-troubleshoot を入力してスキルを明示的に呼び出すか、問題を直接記述して診断セッションを開始します (例: 「ジョブ abc-123 が失敗したのですが、どうしたの?」

スキルのフォローアップ・プロンプトに応答します。わかりやすい質問に平易な英語で回答し、スキルが要求したらソース コード、構成ファイル、その他の成果物を共有します。

このスキルは、構造化された根本原因の概要(失敗したコンポーネント、失敗を生成した一連のイベント、ログとトレースからの裏付けとなる証拠、推奨される修正)を出力します。マシンまたはテナントで何かを変更する前に、スキルは明示的な承認を求めます。

次の例は、UiPath Studio の内蔵ターミナルから実行されるセッションを示しています。

効果的なセッションのためのヒント

スキルは、デバッグを手伝ってくれる同僚のように扱います。コンテキストとその逆により、結果が改善されます。

• 具体的に。ジョブ ID、プロセス名、キュー名、および正確なエラー メッセージにより、スキルはラウンドの明確化をスキップできます。
• 会話を続けてください。最初の推奨事項が観察したものと一致しない場合は、そのように言ってください。「それはそうではない」、「私はすでにそれをチェックした」、「もっと深く掘り下げる」などのフレーズは、調査を動かし続けます。
• 必要に応じてリダイレクトします。スキルが間違ったスレッドをたどっている場合は、修正します (例: 「問題は権限ではありません。昨日はジョブが正常に実行されました」など)。
• 要求されたらファイルを共有します。XAML、 project.json、構成ファイル、および同様の成果物により、診断品質が大幅に向上します。
• 期待値へのアクセスを一致させます。スキルは、サインインしている uip セッションを使用して、権限を継承します。ログを表示できない場合は、スキルも表示できません。

参照

• スキル — より広範なスキルのメカニズム
• UiPath CLI をコーディング エージェントと使用する — UiPath のスキル カタログを Claude Code、Cursor、GitHub Copilot、Gemini CLI、Codex、OpenCode にインストールする
• ツールとスキルの管理 — 日常のメンテナンス