GitHub .NET Aspire ダッシュボードの Copilot

.NET Aspire ダッシュボードGitHub Copilot について説明します。 GitHub Copilot は、新しい AI デバッグ アシスタントです。

GitHub Copilot は、ダッシュボードの OpenTelemetry デバッグと診断のエクスペリエンスを高めます。 AI を使用すると、次のことができます。

• 1 回のクリックで何百ものログ メッセージを確認する
• 複数のアプリにわたるエラーの根本原因を調査する
• トレースのパフォーマンスの問題を強調表示する
• AI の巨大なナレッジ リポジトリを使用してあいまいなエラー コードを説明する

VS Code または Visual Studio からアプリを起動すると、ダッシュボードで Copilot にアクセスできます。

要求事項

GitHub Copilot は、 .NET Aspire プロジェクトが IDE から実行されている場合にのみ使用できます。

また、GitHub Copilot サブスクリプションを持つ IDE のGitHub アカウントにもログインする必要があります。 .NET Aspire ダッシュボードのCopilot 操作では、IDE に関連付けられているGitHub アカウントが使用されます。

Copilot サブスクリプションをまだお持ちでない場合は、Copilot Free プランにサインアップすることで、無料で Copilot を使用できます。これには、チャットのやり取りの毎月の制限が含まれます。

始めましょう

開始するには、IDE で通常どおり .NET.NET Aspire ソリューションを起動します。

1. C# Dev Kit拡張機能がインストールされているサポートされているバージョンのVisual Studioまたは VS Code で、.NET Aspire ソリューションを開きます。
2. GitHub アカウントを使用して IDE にログインしていることを確認します。
   • Visual Studioについては、「Visual Studio キーチェーンにGitHub アカウントを追加する」を参照してください。
   • VS Code と C# Dev Kitについては、「 VS Code で Copilot GitHub 設定する」を参照してください。
3. .NET .NET Aspire アプリ ホストを実行します。

ダッシュボードの右上隅に GitHub Copilot ボタンが表示されます。 ボタンを選択すると、Copilot UI が開きます。

Copilot UI では、 リソースの集計などの提案された質問を選択するか、チャット入力フィールドに独自の質問を入力できます。 Enter キーを押して送信します。 例: What health checks are configured in my app?

Copilot UI の上部には、新しい会話を開始したり、チャットを展開したり、UI を閉じたりするためのボタンがあります。

リソース、コンソール ログ、テレメトリを分析する

アプリ内のリソース、コンソール ログ、テレメトリを分析するには、いくつかのオプションがあります。 上で 2 つについて説明しました。

• 提案された質問を選択します。 Copilot の提案される質問はコンテキストに応じた質問です。 たとえば、リソースに関する質問はリソース ページに表示され、分散トレースに関する質問はトレース ページに表示されます。
• チャット入力フィールドに、 Why did the product cache fail to start? や What caused recent errors in the frontend?

ダッシュボードには、リソース、構造化されたログ、トレース、スパンのコンテキスト メニューに Copilot オプションも含まれています。 [ Ask GitHub Copilot ] を選択して、選択したデータを調査します。

アプリにエラーのある構造化されたログまたはトレースがある場合は、それらのページに [エラーの説明 ] ボタンが表示されます。 これを選択すると、すべてのエラーが調査のために Copilot で使用できるようになります。

トレースの詳細ページで、[ トレースの説明 ] ボタンが常に表示されます。 現在表示されているトレースを簡単に分析できます。

トラブルシューティング

Copilot が "準備中" にハングアップする

既知の問題により、Copilot UI が最初にアクセスされたときに "準備中" メッセージでハングする可能性があります。 これは、 サポートされているバージョン の Visual Studio または VS Code からダッシュボードが起動されていない場合、または GitHub アカウントが IDE にログインしていない場合に発生します。 Copilot UI を閉じてから再度開くと、問題が修正されます。 一度修正すると、UI は、copilot でダッシュボードを使用するための要件 GitHub メッセージを正しく表示します。

コピロット無料プランの月額制限に達しました

GitHubCopilot 無料プランには、チャットの使用に関する毎月の制限が含まれています。 この制限を超えると、Copilot はダッシュボードで機能しなくなります。 Copilot サブスクリプションをアップグレード するか、制限がリセットされるまで待ちます。

制限事項

データ サイズ

AI モデルには、一度に処理できるデータの量に制限があります。 .NET Aspire ダッシュボードでは、必要に応じて、GitHub Copilot に送信されるデータの量が制限される場合があります。

• 大きなデータ フィールド (長い例外スタック トレースなど) が切り捨てられる場合があります。
• テレメトリの大規模なコレクションを含む要求は、古い項目を省略することで短縮できます。

ダッシュボードで Copilot GitHub 無効にする

GitHub Copilot は、明示的に操作する場合にのみデータにアクセスします。 たとえば、チャット クエリを送信したり、コンテキスト メニューから [Ask GitHub Copilot ] を選択したりします。

この機能を完全に無効にする場合は、ASPIRE_DASHBOARD_AI_DISABLED環境変数をアプリ ホストのlaunchSettings.jsonファイルにtrueするように設定します。 これにより、ダッシュボード内のすべての Copilot UI 要素が非表示になります。

{
  "$schema": "https://json.schemastore.org/launchsettings.json",
  "profiles": {
    "https": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "applicationUrl": "https://localhost:17129;http://localhost:15010",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development",
        "DOTNET_ENVIRONMENT": "Development",
        "ASPIRE_DASHBOARD_OTLP_ENDPOINT_URL": "https://localhost:21124",
        "ASPIRE_RESOURCE_SERVICE_ENDPOINT_URL": "https://localhost:22206",
        "ASPIRE_DASHBOARD_AI_DISABLED": "true"
      }
    }
  }
}

GitHub Copilot に関してよく寄せられる質問

プラン、プライバシー、責任ある AI の使用に関する質問など、 GitHub Copilot の詳細については、 GitHub Copilot に関してよく寄せられる質問を参照してください。