トラブルシューティング

UiPath Platform の障害を会話型で診断し、RPA、Orchestrator、Maestro、Agents、Integration Service の問題をターミナルからトリアージします。

UiPath スキルがインストールされたコーディング エージェントによって、会話型診断が 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 でエラーになったのはなぜですか?」
Agents	LLM ステップのエラー、コンテキスト グラウンディングとリソースのエラー、入力スキーマの検証の失敗、ガードレール違反、Integration Service のツール呼び出しの失敗	「なぜ私のエージェントはガードレール違反で停止したのですか?」
Integration Service	コネクションの認証とトークンの更新の失敗、コネクタ アクティビティのエラー、必須の入力の欠落、トリガーが起動しない、または実行に失敗する	「Salesforce 接続で 401 が返されるのはなぜですか?」

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

The skill operates with the same access the signed-in uip session has. If that identity cannot read certain logs or folders, the skill cannot read them either.

前提条件

1. エージェントに UiPath スキルがインストールされているインストールの手順については、「 インストールとセットアップ 」をご覧ください。
2. ログイン中のセッション (uip login) です。「インストールしてセットアップする」をご覧ください。

手順

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

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

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

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

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

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

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

• 具体的に。ジョブ ID、プロセス名、キュー名、および正確なエラー メッセージにより、スキルはラウンドの明確化をスキップできます。
• 会話を続けてください。最初の推奨事項が観察したものと一致しない場合は、そのように言ってください。「それはそうではない」、「私はすでにそれをチェックした」、「もっと深く掘り下げる」などのフレーズは、調査を動かし続けます。
• 必要に応じてリダイレクトします。スキルが間違ったスレッドをたどっている場合は、修正します (例: 「問題は権限ではありません。昨日、仕事はうまくいった」。
• 要求されたらファイルを共有します。XAML、 project.json、構成ファイル、および同様の成果物により、診断品質が大幅に向上します。
• Match access to expectations. The skill uses the signed-in uip session and inherits that identity's permissions. If the identity cannot view a log, the skill cannot either.

参照

• スキルの概要 — より広範なスキルのメカニズム
• インストールとセットアップ — CLI スキルと UiPath スキルを Claude Code、Cursor、Codex CLI、Google Antigravity にインストールします
• 最新の状態に保つ — 日々のメンテナンス