トラブルシューティング

画面コンテキスト エラー、macOS および Windows での権限の問題、接続やツールとの連携の失敗など、一般的な Delegate の問題に対する解決策です。

このページは、Delegate で発生した問題を解決するための唯一のリファレンスです。

設定とインストール

アプリケーションが表示されない

• 画面コンテキストが有効化されていることを確認します (ウィンドウ下部のトグル)
• システム設定 (macOS) で画面録画/アクセシビリティ権限が付与されているか、UAC (ユーザー アカウント制御) に同意 (Windows) されていることを確認します
• 権限の付与後にDelegateを再起動します

DelegateはWebサイトにアクセスできないと言います

• インターネット接続を確認する
• 一部の企業ネットワークでは特定の AI サービスがブロックされます。このような疑いがある場合は、IT 部門にお問い合わせください
• 別の Web サイトを試して、問題を切り分けます

ブラウザー拡張機能が検出されない

• ブラウザーに拡張機能がインストールされ、有効化されていることを確認します
• Chrome の場合: chrome://extensions → Delegate が一覧表示され、有効化されている必要があります
• インストール後、ブラウザーを再起動します
• 必要に応じて、[設定] からセットアップ ウィザードを再実行します

サインインできません

• UiPath アカウントの資格情報を確認します
• 組織で SSO (シングル サインオン) を使用している場合は、企業ネットワークまたは VPN を使用していることを確認します
• テナントが正しく選択されていることを確認します

タスクとプロンプト

Delegateは私が何を望んでいるのか理解していませんでした

• 要求を小さいステップに分割します
• 目標と形式をより明確にします
• 目的の出力の例を提供します

それは私が予想していなかったことをし始めました

• Esc キーを押して停止します
• 「何をしようとしているのですか?」と尋ねて、その理由を理解します
• より明確な指示でリダイレクトしてください

タスクに時間がかかりすぎています

• バックグラウンド モード (低速ですがブロック解除) になっているかどうかを確認します。
• ステータスの最新情報を尋ねる: 「どうしてこんなに時間がかかるの?」
• 複雑なタスクの場合は、小さいチャンクに分割することを検討してください

確認を求め続けます

• ガイド付きモードを使用している - これは安全上の理由によることです
• 信頼できる反復的なワークフローを自律型モードに切り替える
• 確認をトリガーする条件を調整する場合は、「セキュリティ設定」を確認してください

セキュリティと権限

Delegateは許可がないと言う

1. [設定] → [セキュリティ] →、関連するツール カテゴリが有効化されていることを確認してください。
2. ツールまたはコネクタの特定の操作については、「ツールの権限」をご覧ください。
3. 対象のアプリまたはサイトが [UI Automation] の [ブロックされているアプリ/Web サイト] 内にあるか、またはパスが [保護されたファイル] のカテゴリと一致しているかを確認します。
4. 一時的に慎重モードに切り替えて、具体的な拒否を確認してみてください。

アクションを承認しましたが、失敗しました

1. OS レベルの権限 (macOS のプライバシー設定、Windows UAC) を確認します。
2. アプリケーションまたはサイトが UI Automation の [ブロックされているアプリ/Web サイト] に含まれていないことを確認します。
3. ファイル パスが [保護されたファイル] のカテゴリと一致するかどうかを確認します。
4. エラー メッセージを確認します。別の問題 (ネットワーク、認証など) を示している可能性があります。

ブロックされているサイトを許可したい

1. [設定] → [セキュリティ] → [UI Automation] を開き、[ブロックされた Web サイト] にチェックを入れます — サイトが個別にリストされている場合、またはカテゴリ (銀行、支払い、暗号、パスワード マネージャー、政府機関、医療) の一部として追加されている場合は、サイトを削除します。
2. 設定がロックされていて、組織によって管理されていると表示されている場合は、代わりに管理者にお問い合わせください。この設定は Automation Ops を通じて適用され、ローカルで変更することはできません。

すでに付与している権限をスキルが要求し続ける

1. スキルが以前とは 異なる 権限を要求していないか確認します。
2. スキルのマニフェストが実際に使用しているものと一致していることを確認します。
3. 一部の権限はセッション スコープであるため、再承認が必要です。
4. [設定] → [権限] → [許可されたエージェント] を確認して、関連するエージェントが有効化されていることを確認します。

コネクション

Integration Service: 接続に失敗したか、認証エラー

原因

• OAuth トークンの有効期限切れ
• ソース サービスでのパスワードの変更
• 組織ポリシーがサードパーティのアクセスを取り消されました
• 付与されている権限が不十分です。

Solutions (ソリューション)

1. [設定] → [接続] → [再接続] に移動します。
2. 失敗した場合は、コネクションを取り消して再作成してください。
3. サービス独自のサードパーティ アプリの設定を確認します。
4. ソース アプリケーションで必要な権限が付与されていることを確認します。

Integration Service: [サービス] のコネクションが見つかりません

原因: 接続されていないサービスを使用するようDelegateに依頼しました

Solutions (ソリューション)

1. [設定] → [コネクション] でコネクションを作成します。
2. または、そのサービスを必要としない別のアプローチを指定します。

Integration Service: 権限が不十分です

原因: コネクションは存在しますが、要求されたアクションに必要なスコープがありません

Solutions (ソリューション)

1. 切断して再接続し、プロンプトが表示されたら追加の権限を付与します。
2. 組織のポリシーによって範囲が制限されているかどうか、IT 管理者に確認してください。

MCP: MCP サーバーに接続できませんでした

原因

• リモート サーバーがダウンしているか、リモート サーバーにアクセスできません
• ローカル プロセスの開始に失敗しました
• ネットワーク/ファイアウォールによって接続がブロックされている
• URL または設定が無効です。

Solutions (ソリューション)

1. サーバーが実行中 (ローカルの場合) またはアクセス可能 (リモートの場合) であることを確認します。
2. URL/コマンドにタイプミスがないか確認してください。
3. エンドポイントを手動でテストします (curl、ブラウザー)。
4. ファイアウォールの設定を確認します。
5. ローカル プロセス ログで起動エラーを確認します。

MCP: サーバーは接続されていますが、ツールがない

原因: サーバーは実行中ですが、ツールが登録されていないか、ツールが初期化できませんでした

Solutions (ソリューション)

1. 必要な構成については、サーバーのドキュメントをご覧ください。
2. 環境変数が正しく設定されていることを確認します。
3. MCP サーバーを再起動します。
4. サーバー ログで初期化エラーがないか確認します。

MCP: ツールの呼び出しに失敗したか、MCP エラーです

原因: サーバーは要求を受信しましたが、実行に失敗しました

Solutions (ソリューション)

1. ツール カードで特定のエラー メッセージを確認します。
2. ツールに必要なパラメーターが指定されていることを確認します。
3. 基になるリソース (ファイル、データベース、API) にアクセスできるかどうかを確認します。
4. MCP サーバーのログでエラーの詳細情報を確認します。

ルーチン

ルーチンが見つかりません。

原因: ルーチンが削除されたか、LocalSkills フォルダーが移動されました

Solutions (ソリューション)

1. ルーチンが [設定] → [ルーチン] にあるかどうかを確認します。
2. インポートした場合は、元のファイルから再インポートします。
3. [設定] → [スキル & Marketplace] で LocalSkills フォルダー パスを確認します。

必須の値が入力されていません。

原因: ルーチンは、指定されていないパラメーターを予期しています

Solutions (ソリューション)

1. 実行時には、プロンプトで指定されたすべての入力を入力します。
2. スケジュールを設定する場合は、すべての必須入力に固定値が設定されていることを確認します。
3. ルーチンを編集して、入力を既定値で任意にします。

ステップ X でルーチンが失敗しました

原因: ルーチン内のアクションを完了できませんでした

Solutions (ソリューション)

1. ツール カードでエラー メッセージを確認します。
2. 必要なコネクションがアクティブであることを確認します ([設定] → [コネクション])。
3. 入力ファイルが存在し、アクセス可能であることを確認します。
4. 対象のアプリケーションがインストールされているかどうかを確認します。
5. ガイド付きモードで実行して、失敗する場所を正確に確認します。

スケジュールされたルーチンが実行されませんでした

原因: スケジュール サービスが実行されていないか、権限に問題があります

Solutions (ソリューション)

1. 実行ステータスの [設定] → [ルーチン] → [スケジュール済み] を確認します。
2. Delegateがスケジュールされた時刻に実行されていたことを確認。
3. マシンがスリープ状態だったかどうかを確認します (スケジュールはスリープ中に実行されない場合があります)。
4. 実行履歴でエラー メッセージを確認します。
5. 接続がまだ有効である (期限切れになっていない) ことを確認します。

ストアとスキル

アイテムがインストールされない

原因

• ネットワーク接続の問題
• ディスク容量が不足している
• 破損したダウンロード
• 非対応のDelegateバージョン

Solutions (ソリューション)

1. インターネット接続を確認します。
2. ディスク領域を解放します (LocalSkills ディレクトリを確認)。
3. インストールを再試行します。
4. Delegateが最新かどうかを確認します。
5. 問題が解決しない場合は、発行元にお問い合わせください。

インストールされたスキルが表示されない

原因

• スキルが無効化されている
• enabledSkills リストに追加されていません
• Delegateの再起動が必要

Solutions (ソリューション)

1. スキル→表示され、有効化されている→、[設定] [スキル & Marketplace] を確認します。
2. Restart Delegate.
3. LocalSkills フォルダーでスキル ファイルを確認します。

使おうとスキルが失敗する

原因

• 必要なコネクションが見つからない
• 必要な権限がない
• 古いスキル バージョン
• アプリケーションのバージョンの不一致

Solutions (ソリューション)

1. 前提条件については、スキルのドキュメントを確認します。
2. [設定] → [コネクション] で必要なコネクションを作成します。
3. [設定] → [セキュリティ] で、必要なツールのカテゴリを有効化します。
4. スキルを最新バージョンに更新します。
5. 対象のアプリケーションのバージョンがサポートされているかどうかを確認します。

カスタム フィードが読み込まれない

原因

• フィードの URL が無効です。
• フィード サーバーがダウンしました。
• フィードの形式が間違っている
• ネットワーク/ファイアウォールのブロック

Solutions (ソリューション)

1. URL が正しく、ブラウザーでアクセスできることを確認します。
2. フィードの形式を UiPath の仕様に照らして確認してください。
3. フィード管理者に問い合わせる
4. 企業のファイアウォールの設定を確認します。

設定

設定の変更は有効になりません

原因: 一部の設定では、アプリの再起動が必要です。[セキュリティ] と [権限] タブの設定は、[設定] UI からのみ変更できます。ファイルを直接編集することによっては変更できません。

Solutions (ソリューション)

1. Delegateを再起動して、設定が有効になったかどうかを確認します。
2. この設定が [セキュリティ] タブまたは [権限] タブにある場合は、ファイルを直接編集するのではなく、[設定] UI を使用します。
3. settings.json手動で編集する場合は、正しいファイル パスが編集されていることを確認します。

設定ファイルが破損しています

原因: settings.json の JSON 構文が無効です。多くの場合、手動編集エラーが原因です。Delegate は自動的に既定の設定にフォールバックします。

Solutions (ソリューション)

1. Close Delegate.
2. を削除したり、名前を変更 settings.json。
3. Restart Delegate — 新しい既定値が作成されます。
4. 設定を再設定します。

設定が見つかりません。

原因: 設定が予期したタブと異なるタブにあるか、[設定] UI からしか利用できない可能性があります。

Solutions (ソリューション)

1. この設定が [セキュリティ] タブにあるかどうかを確認します (UI のみ)。
2. Verify your Delegate version — some settings are version-specific.

セキュリティで保護された設定が保存されない

原因: OS レベルのセキュリティにより、暗号化された設定ストア (macOS キーチェーンまたは Windows Data Protection API (DPAPI)) にアクセスできません。

Solutions (ソリューション)

1. OS レベルのセキュリティ権限を確認します。
2. macOS: キーチェーンのロックが解除されていることを確認します。
3. Windows: ユーザー プロファイルが適切に読み込まれていることを確認します。
4. Restart Delegate.
5. 問題が解決しない場合は、UiPath サポートにお問い合わせください。