エージェント型開発を探求する -

Visual Studio Code での AI のトラブルシューティング

この記事では、VS Code で AI 関連の問題をトラブルシューティングするための診断ツールとテクニックについて説明します。これらのツールを使用して、ネットワーク接続、カスタマイズファイル、AI の応答に関する問題を特定してください。

GitHub Copilot のログを表示する

GitHub Copilot 拡張機能のログファイルは、Visual Studio Code 拡張機能の標準的なログ保存場所に格納されます。これらのログを使用して、接続の問題、拡張機能のエラー、予期しない動作を診断してください。

詳細なログを表示するには

  1. コマンドパレットを開きます（⇧⌘P (Windows, Linux Ctrl+Shift+P)）。
  2. Developer: Set Log Level を実行し、GitHub Copilot および GitHub Copilot Chat 拡張機能の値を Trace に設定します。
  3. Output: Show Output Channels を実行し、リストから GitHub Copilot または GitHub Copilot Chat を選択します。
  4. 出力パネルで、選択した拡張機能のログを表示します。

出力チャネルを切り替えるには、出力パネルの右上にあるドロップダウンメニューから GitHub Copilot または GitHub Copilot Chat を選択します。

ネットワーク診断情報を収集する

GitHub Copilot への接続で問題が発生した場合は、ネットワーク接続の診断情報を収集して、ファイアウォール、プロキシ、または VPN の問題を特定してください。

  1. コマンドパレットを開きます（⇧⌘P (Windows, Linux Ctrl+Shift+P)）。
  2. GitHub Copilot: Collect Diagnostics を実行します。
  3. 診断情報が記載されたエディタータブが開きます。これは、問題を報告する際に確認や共有を行うことができます。

ネットワーク構成の詳細については、「Copilot のネットワークおよびファイアウォール構成」を参照してください。

チャットのやり取りをデバッグする

VS Code には、AI にプロンプトを送信した際に何が起こっているかを調査するためのさまざまなツールが用意されています。

  • /troubleshoot スラッシュコマンド

    AI にチャットセッションのデバッグログを分析させます。オプションで #session を含めることで、以前のチャットセッションを選択して診断することも可能です。/troubleshoot に続けて質問を入力します（例: /troubleshoot how many tokens did I use? や /troubleshoot list all paths you tried to load customizations in #session）。これには github.copilot.chat.agentDebugLog.enabled Open in VS Code Open in VS Code Insiders が有効である必要があります。

  • エージェントデバッグログパネル（プレビュー）

    チャットセッション中のエージェントのやり取りを時系列で表示します。これには、ツール呼び出しのシーケンス、LLM リクエスト、トークン使用量、プロンプトファイルの検出、エラーなどが含まれます。これは、チャットのやり取りを理解しデバッグするための主要なツールです。

    エージェントデバッグログパネルを開くには

    1. チャットビューの省略記号（...）メニューを選択し、Show Agent Debug Logs を選択します。

    エージェントデバッグログパネルから、エージェントデバッグイベントのスナップショットをチャットの会話に添付することで、そのセッションについて AI に質問したり、特定のやり取りをトラブルシューティングしたりできます。

    エージェントデバッグログパネルの詳細をご覧ください。

  • チャットデバッグビュー

    完全なシステムプロンプト、ユーザープロンプト、コンテキスト、ツール呼び出しのペイロードなど、各 LLM リクエストと応答の生の詳細を表示します。このビューを使用して、各やり取りで言語モデルに対して送受信された正確なデータを調査します。

    チャットデバッグビューを開くには

    1. チャットビューのオーバーフローメニュー（...）を選択します。
    2. Show Chat Debug View を選択します。

チャットデバッグビューの詳細をご覧ください。

MCP サーバーのトラブルシューティング

MCP サーバーは、外部サービスに接続することでチャット機能を拡張します。MCP サーバーが正しく動作しない場合は、ログを表示したり、再起動したりすることができます。

MCP サーバーをトラブルシューティングするには

  1. コマンドパレットを開き、MCP: List Servers を実行します。
  2. サーバーを選択して、そのステータスと利用可能なアクションを表示します。
  3. Show Output を選択して、サーバーのログを表示します。
  4. Restart Server を選択して、動作が不安定なサーバーを再起動します。

MCP サーバーの構成とデバッグの詳細をご覧ください。

フィードバックを送信する

解決できない問題が発生した場合は、GitHub Copilot の改善にご協力ください。

  • ゴーストテキストの提案: エディター内のゴーストテキストの提案にカーソルを合わせ、Send Copilot Completion Feedback を選択します。
  • 次回の編集提案: エディターのガターにある次回の編集提案メニューで、Feedback アクションを選択します。
  • 一般的な問題: Help > Report Issue を開き、VS Code Extension を選択してから GitHub Copilot Chat を選択します。

問題を報告する際は、問題の診断に役立つよう、Copilot ログからの関連情報を添付してください。

関連リソース

4/8/2026
© . This site is unofficial and not affiliated with Microsoft.