翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# トラブルシューティング
以下のセクションでは、Amazon Quick デスクトップアプリケーションを使用する際に発生する可能性がある一般的な問題とその解決方法について説明します。
## インストールと起動の問題
macOS に「未確認の開発者」という警告が表示される
macOS が、Amazon Quick デスクトップアプリケーションが未確認の開発者からのものであるためにアプリケーションを開くことができない場合は、次の手順を使用してアプリケーションを許可します。
1. Mac で**システム設定**を開きます。
1. [**プライバシーとセキュリティ**] を選択します。
1. セキュリティセクションまでスクロールし、クイックに関するメッセージの横にある**「Open Anyway**」を選択します。
1. アプリケーションを開くことを確認します。
初回起動時に、アプリケーションを開くことを確認するようにオペレーティングシステムから求められる場合があります。**Open** を選択して続行します。
アプリケーションが起動しない
Amazon Quick デスクトップアプリケーションが起動しない場合は、次の手順を試してください。
1. コンピュータを再起動し、アプリケーションを再度開きます。
1. オペレーティングシステムが最小要件を満たしていることを確認します。
1. 十分なディスク容量があることを確認します。
1. 問題が解決しない場合は、 `~/.quickwork/` ディレクトリ (macOS) または `%USERPROFILE%\.quickwork\` ディレクトリ (Windows) を削除し、アプリケーションを再インストールします。
`~/.quickwork/` (macOS) または `%USERPROFILE%\.quickwork\` (Windows) ディレクトリを削除すると、会話、ナレッジグラフ、メモリ、保存された認証情報など、すべてのローカルデータが削除されます。このステップは最後の手段としてのみ使用します。
## 接続の問題
Slack または Outlook 接続が失敗する
Slack または Microsoft Outlook への接続が失敗した場合は、次の手順を試してください。
1. **設定** > **機能** > **接続でサービスを切断します**。
1. **サインイン**を選択し、認証フローを完了して、サービスを再接続します。
1. アカウントにサードパーティーサービスで必要なアクセス許可があることを確認します。
1. インターネット接続がアクティブで安定していることを確認します。
Microsoft Teams 接続が失敗する
Microsoft Teams への接続が失敗した場合、Slack または Outlook と同じステップに従います。組織の管理者がサードパーティーアプリケーションへのアクセスを制限していないことを確認します。
接続のステータスが「同期されていません」と表示される
接続のステータスが「非同期」である場合は、次の手順を試してください。
1. アクティブなインターネット接続があることを確認します。
1. **設定** > **機能** > **接続でサービスを切断して再接続します**。
1. 問題が解決しない場合は、サードパーティーサービスが停止している可能性があります。サービスのステータスページを確認します。
Google Workspace 接続が失敗する
Google サービス (Gmail、Google Calendar、Google Drive、Google Docs、Google Sheets、Google Slides、Google Meet、または Google Analytics) への接続が失敗する場合は、以下を確認します。
1. Google アカウントは、組織の管理ポリシーによって制限されません。
1. サインインフロー中に必要な OAuth アクセス許可を付与しました。
1. 正しい Google アカウントでサインインしています。
## パフォーマンスの問題
応答が遅い
クイックレスポンスが遅い場合は、次の手順を試してください。
1. **高速** AI モデルモードに切り替えて、応答を高速化します。チャット入力エリアでモデルセレクタを選択し、**高速**を選択します。
1. **思考労力**レベルを下げます。思考労力 (オフまたは低) を低くすると、応答が速くなります。
1. 未使用のアプリケーションを閉じて、システムリソースを解放します。
1. インターネット接続速度を確認します。AI モデルリクエストには、API Gateway へのネットワーク接続が必要です。
メモリ使用量が多い
Amazon Quick デスクトップアプリケーションが過剰なメモリを使用している場合は、次の手順を試してください。
1. **設定** > **マイコンピュータ**でインデックス付けされたフォルダの数を減らします。**セマンティック検索**はキーワード検索よりも多くのリソースを使用するため、セマンティック検索を無効にします。
1. **設定** > **カスタマイズ** > **パフォーマンス**で**最大並列タスク**スライダーを下げます。デフォルト値は 50 です。この値を減らすと、同時バックグラウンドオペレーションの数が制限されます。
1. アプリケーションを再起動して、キャッシュされたデータをクリアします。
1. **設定** > **マイコンピュータ** > 検索インデックス作成で**検索インデックス作成**の制限を調整します。**ストレージ制限**、**インデックス作成の最大ファイルサイズ**、または**インデックス作成スライダーの最大フォルダサイズ**を小さくします。
検索インデックス作成は、空きディスク容量が 8.0 GiB を下回ると自動的に一時停止します。
## ファイルアクセスの問題
クイックがファイルを見つけられない
Quick がチャットで参照するファイルを見つけられない場合は、以下を確認します。
1. ファイルの親フォルダは、**設定** > **マイコンピュータ** > **ローカルフォルダに追加されます**。Quick は、明示的にアクセス権を付与したフォルダ内のファイルにのみアクセスできます。
1. **\+ フォルダ**を追加 を選択して、追加のフォルダへのアクセスを許可します。
1. フォルダを追加すると、Quick はフォルダ内のファイルをすぐに読み取ることができます。検索のインデックス作成はバックグラウンドで行われます。
検索は結果を返しません
ファイル検索で結果が返されない場合は、次の手順を試してください。
1. **設定** > **マイコンピュータ** > **ローカル**フォルダのフォルダに対して**キーワード検索**がオンになっていることを確認します。フォルダを展開すると、インデックス作成の切り替えが表示されます。
1. インデックス作成ステータスを確認します。ファイルとエントリ数を含む**準備完了**ステータスは、インデックス作成が完了したことを確認します。
1. 最近新しいフォルダを追加した場合は、インデックス作成が完了するまで待ちます。ステータスには進行状況が表示されます。
1. **設定** > **マイコンピュータ** > **検索**インデックス作成で、**ファイルがインデックス作成の上限ファイルサイズ**以下であることを確認します。この制限を超えるファイルはインデックス作成中にスキップされますが、エージェントはファイルへの直接アクセスを通じて引き続き使用できます。
1. より広範な検索を行うには、 フォルダで**セマンティック検索**を有効にして自然言語クエリを許可します。
## ブラウザの自動化の問題
ブラウザの自動化が機能しない
Quick がウェブページを参照できない場合は、次の手順を試してください。
1. **設定** > **機能** > **システムで****ブラウザ自動化**が有効になっていることを確認します。
1. 「Chrome を使用」モードを使用する場合は、**設定** > **カスタマイズ** > **ブラウザ**で設定を確認します。Chrome を開き、`chrome://inspect/#remote-debugging` に移動します。**リモートデバッグを有効にする**を選択します。クイックに戻り、**接続のテスト**を選択して接続を確認します。
1. デフォルトモードを使用する場合、Quick はプロファイルのコピーを使用して別の Chrome インスタンスを起動します。Chrome がシステムにインストールされていることを確認します。
## スケジュールされたエージェントの問題
スケジュールされたエージェントが実行されなかった
スケジュールされたエージェントは、コンピュータ上でローカルで実行されます。エージェントがスケジュールされた時刻に実行されなかった場合は、以下を確認します。
1. コンピュータの電源が入っていて、スケジュールされた時間に目が覚めました。
1. Amazon Quick デスクトップアプリケーションが実行されていました。
1. エージェントは有効になっています。**設定** > **機能** > **スケジュールされたタスク**の切り替えを確認するか、上部のバーから **エージェント**パネルを開きます。
1. インターネット接続がアクティブでした。接続されたサービスまたは AI モデルにアクセスするエージェントには、ネットワーク接続が必要です。
エージェントの実行がスケジュールされているときにコンピュータがオフになっているか、アプリケーションが閉じられている場合、エージェントは次にスケジュールされている時刻まで実行されません。
エージェントは予期しない結果を生成します
スケジュールされたエージェントが予期しない結果を生成する場合は、次の手順を試してください。
1. **設定** > **機能** > **スケジュールされたタスク**を開き、エージェントを選択します。
1. **プロンプト**タブを確認して、エージェントの指示が正しいことを確認します。
1. **機能**タブをチェックして、正しい MCP サーバーがアタッチされていることを確認します。
1. **概要**タブの**モデル**の変更を検討してください。より複雑なエージェントタスクには**、バランス**型または**スマート**を使用します。
1. **実行**ボタン (再生アイコン) を選択して、エージェントを手動でトリガーし、結果を確認します。
## MCP サーバーの問題
MCP サーバーの接続に失敗する
MCP サーバーが接続に失敗した場合は、接続タイプに基づいて次のステップを試してください。
**ローカル MCP サーバー:**
1. コマンドが正しく、実行可能ファイルがシステムにインストールされていることを確認します。
1. 引数がスペース区切りで正しくフォーマットされていることを確認します。
1. サーバーの起動に 30 秒以上かかる場合は**、タイムアウト**値を増やします (5 秒から 300 秒に設定可能）。
1. 必要な**環境変数**が正しく設定されていることを確認します。
**リモート MCP サーバー:**
1. URL が正しく、サーバーが実行されていることを確認します。
1. 認証が必要な場合は、**トークン**値が有効なベアラートークンであることを確認します。
1. ネットワーク接続とファイアウォールの設定を確認します。
**インポートされた MCP サーバー:**
1. 設定ファイルパスが正しいことを確認します。
1. ソースアプリケーション (Kiro、Claude Code、AIM など) が正しくインストールされていることを確認します。
## 診断のエクスポート
トラブルシューティングのために診断情報を共有する必要がある場合は、アプリケーションから診断ログをエクスポートできます。
1. **設定** > **カスタマイズ**を開きます。
1. **トラブルシューティング**セクションまでスクロールします。
1. ドロップダウンから時間範囲 (**過去 2 時間など) **を選択します。
1. 診断ログをデスクトップに保存するには、診断**のエクスポート**を選択します。
## アプリケーションのリセット
他のトラブルシューティング手順で問題が解決しない場合は、すべてのデータをクリアしてアプリケーションをリセットできます。
**警告**
このアクションを元に戻すことはできません。会話、キャッシュされたメッセージ、ナレッジグラフ、保存された認証情報、ユーザー設定など、すべてのクイックデータを削除します。クリーンアップ後、アプリケーションは終了します。
1. **設定** > **カスタマイズ**を開きます。
1. **危険ゾーン**セクションまでスクロールします。
1. **すべてのデータをクリア**を選択します。
1. アクションを確認します。
1. macOS で を完全にアンインストールするには、ゴミ箱`Amazon Quick.app`にドラッグします。Windows で、**Settings** > **Apps** > **Installed apps** を開き、Amazon Quick を見つけ、**Uninstall** を選択します。
## 追加のヘルプの取得
上記のトラブルシューティング手順で問題が解決しない場合は、次のリソースを使用できます。
+ **診断をエクスポート**し、サポートチームと共有します。
+ **開発者メニュー** – 接続ステータスドット (右上隅の緑色のドット) を選択すると、高度な診断のためにミッションコントロール、メトリクスオーバーレイ、デバッグパネル、メモリパネルにアクセスできます。
+ エンタープライズアカウントの問題については、組織の IT 管理者にお問い合わせください。
+ 最新のガイダンスについては、Amazon Quick のドキュメントを参照してください。