- はじめに
- ベスト プラクティス
- 機能
- スキル
- CLI
- 例
- Advanced (カスタム)
- ヘルプ
A coding agent with UiPath skills installed brings conversational diagnostics to the UiPath platform. Describe a failure in plain English from any terminal on your machine — including the integrated terminal in UiPath Studio — and it triages the issue, ranks likely causes, tests each hypothesis against live platform data through uip, and tells you exactly what went wrong and how to fix it.
トラブルシューティング スキルは UiPath のスキル カタログに含まれており、 uip skills installを通じてコーディング エージェントにインストールされます。
動作のしくみ
診断セッションは、障害の種類に関係なく、同じ 4 段階のフローに従います。
- トリアージ — ユーザーの説明、ジョブまたはプロセスの識別子、またはエラー メッセージから、失敗の範囲を分類します。入力が曖昧な場合、スキルは明確な質問をします。
- 仮説の生成 — 関連するドメインプレイブックとトリアージ中に収集された証拠を利用して、考えられる原因のランク付けされたリストを作成します。
- 仮説の検定 — 一度に1つの仮説を確認または削除します。このスキルは、ログ、トレース、キュー アイテム、修復データ、構成、監査イベントを
uipを通じて取得し、証拠を収集します。 - 解決策 — 根本原因、エラーの原因となった一連のイベント、および具体的な修正を提示します。スキルは、何かを変更する前に明示的な承認を求めます。
ユーザーは、トリアージ中の範囲の明確化、仮説生成のための追加のコンテキストの提供、必要に応じてソース コードまたは構成ファイルの提供、推奨される修正の承認の 4 つの時点で関与できます。
今日診断できること
トラブルシューティング スキルは、次のドメインをカバーしています。あなたは問題を説明します。スキルは証拠をフェッチし、根本原因を返します。
| ドメイン | 診断できること | 質問の例 |
|---|---|---|
| RPA | 失敗したジョブ (SelectorNotFoundException、 TimeoutExceptionなど)、セレクターの不一致、キュー アイテムの失敗、Healing Agent のデータ分析 | 「今朝、InvoiceBot ジョブが失敗したのはなぜですか?」 |
| Orchestrator | スタックまたは失敗したジョブ、権限とロールの問題、デプロイとパブリッシュのエラー、キュー設定の問題 | 「ロボットがファイナンス キューからアイテムをピックアップしないのはなぜですか?」 |
| Maestro | エラーが発生したプロセス インスタンス、ステップレベルの障害、インシデント、エージェントまたは RPA が関与するマルチドメインの障害チェーン | 「承認プロセスのインスタンスが手順 3 でエラーになったのはなぜですか?」 |
| Agents | LLM step errors, context grounding and resource errors, input schema validation failures, guardrail violations, and Integration Service tool-call failures | "Why did my agent stop with a guardrail violation?" |
| Integration Service | Connection authentication and token-refresh failures, connector activity errors, missing required inputs, and triggers that don't fire or fail to execute | "Why is my Salesforce connection returning a 401?" |
他の UiPath ドメインのサポートは既に実施されていますが、まだ強化されています。より多くのドメインとより豊富な診断が進行中です。
スキルは、ユーザーが持っているものと同じアクセス権で動作します。サインインしているユーザーとして特定のログやフォルダーを読み取れない場合、スキルが読み取ることもできません。
前提条件
- エージェントに UiPath スキルがインストールされているインストールの手順については、「 インストールとセットアップ 」をご覧ください。
- ログイン中のセッション (
uip login) です。「インストールしてセットアップする」をご覧ください。
手順
「マシンごとに 1 回 インストールして設定する 」で説明されている設定を実行します。その後は、すべてのセッションでスキルを利用できるようになります。
マシン上の任意のターミナルまたは UiPath Studio の内蔵ターミナルからコーディング エージェントを起動し、 /uipath-troubleshoot を入力してスキルを明示的に呼び出すか、問題を直接記述して診断セッションを開始します (例: 「ジョブ abc-123 が失敗したのですが、どうしてですか?」
スキルのフォローアップ・プロンプトに応答します。わかりやすい質問に平易な英語で回答し、スキルが要求したらソース コード、構成ファイル、その他の成果物を共有します。
このスキルは、構造化された根本原因の概要(失敗したコンポーネント、失敗を生成した一連のイベント、ログとトレースからの裏付けとなる証拠、推奨される修正)を出力します。マシンまたはテナントで何かを変更する前に、スキルは明示的な承認を求めます。
次の例は、UiPath Studio の内蔵ターミナルから実行されるセッションを示しています。
効果的なセッションのためのヒント
スキルは、デバッグを手伝ってくれる同僚のように扱います。コンテキストとその逆により、結果が改善されます。
- 具体的に。ジョブ ID、プロセス名、キュー名、および正確なエラー メッセージにより、スキルはラウンドの明確化をスキップできます。
- 会話を続けてください。最初の推奨事項が観察したものと一致しない場合は、そのように言ってください。「それはそうではない」、「私はすでにそれをチェックした」、「もっと深く掘り下げる」などのフレーズは、調査を動かし続けます。
- 必要に応じてリダイレクトします。スキルが間違ったスレッドをたどっている場合は、修正します (例: 「問題は権限ではありません。昨日、仕事はうまくいった」。
- 要求されたらファイルを共有します。XAML、
project.json、構成ファイル、および同様の成果物により、診断品質が大幅に向上します。 - 期待値へのアクセスを一致させます。スキルは、サインインしている
uipセッションを使用して、権限を継承します。ログを表示できない場合は、スキルも表示できません。
参照
- スキルの概要 — より広範なスキルのメカニズム
- インストールとセットアップ — CLI スキルと UiPath スキルを Claude Code、Cursor、Codex CLI、Google Antigravity にインストールします
- 最新の状態に保つ — 日々のメンテナンス