AKS デスクトップの AI アシスタントは、AKS ワークロードに対して強化された自然言語のトラブルシューティングを提供します。 Headlamp AI Assistant を利用して、AKS 固有のスキル、クラスター対応の可観測性、ガイド付きトラブルシューティング ワークフロー、既存の GitHub Copilot の利用権とのシームレスな統合を実現します。
クラスターに安全に接続した後、アシスタントは言語モデルを AKS 固有のコンテキスト、ログ、イベント、メトリックと組み合わせて問題を特定し、プレーンな言語で解決策を推奨します。 このアプローチにより、開発者とオペレーターは、Kubernetes の深い専門知識を必要とせずに、問題をすばやく理解して修正できます。 この記事では、AKS デスクトップで AI アシスタントを有効にして使用する方法について説明します。
Prerequisites
AKS デスクトップで AI アシスタントを有効にする前に、以下の条件が満たされていることを確認してください:
- AKS デスクトップ v0.10.0 以降がインストールされていること。
- 調査する 1 つ以上の Kubernetes クラスターへのアクセス。
- AI アシスタント プラグインは 設定>プラグイン で有効になっています。 プラグインは既定で有効になっています。
- 次のいずれかのプロバイダー構成:
-
GitHub Copilot自動検出 (推奨): GitHub Copilot サブスクリプション、GitHub CLI (
gh) がコンピューターにインストールされ、GitHub CLI が GitHub アカウントで認証されていること。 - サポートされているもう 1 つの AI プロバイダー: サポートされているプロバイダーまたは OpenAI と互換性のあるエンドポイントへのアクセス。
-
GitHub Copilot自動検出 (推奨): GitHub Copilot サブスクリプション、GitHub CLI (
AI アシスタントとは
AI アシスタントは AKS デスクトップにバンドルされており、クラスター内の問題を診断するためのガイド付きエクスペリエンスを提供します。 アシスタントは次を支援します:
- ログ、イベント、メトリックを分析するスコープ付き診断を実行します。
- 明確な推論と証拠を使用して、AI によって生成された概要を受け取ります。
- 推奨されるアクションをプレビューし、自信を持って適用します。
- 可能であれば、GitHub Copilot を使用して、セットアップ作業をスムーズに進めます。
- クラスターを意識した可観測性と AKS 固有のスキルを活用し、調査にさらなるコンテキストとベストプラクティスを取り入れます。
AI アシスタントのしくみ
AKS デスクトップで AI アシスタントを有効にするには、次の 2 つのオプションがあります。
- GitHub Copilot (推奨) を使用します。 GitHub CLI がインストールされ、GitHub Copilot サブスクリプションを持つアカウントで認証されている場合、AKS デスクトップはプロバイダーとしてGitHub Copilotを検出して構成できます。
- サポートされているもう 1 つの AI プロバイダー: サポートされているプロバイダーまたは OpenAI と互換性のあるエンドポイントを手動で構成します。
どちらのオプションの場合でも、AKS デスクトップは、構成されたプロバイダーに対してクラスター コンテキストと有効化された AKS スキルを提供できます。
AI アシスタントは AKS デスクトップの一部として実行され、クラスターにエージェントやその他のワークロードをデプロイしません。 AKS デスクトップは、kubeconfig の資格情報を使用して、Kubernetes API を介して選択したクラスターに接続します。 アシスタントは、Kubernetes RBAC アクセス許可によって許可される操作に制限されます。
GitHub Copilotを有効にする (自動検出)
GitHub CLI (
gh) をコンピューターにインストールし、GitHub アカウントにサインインします。AKS デスクトップで、 設定>Plugins>AI アシスタントに移動します。
自動検出 を選択します。
GitHub Copilotが構成済みのプロバイダーとして表示されることを確認します。
独自の AI プロバイダーを構成する
AKS デスクトップで、 設定>Plugins>AI アシスタントに移動します。
[ プロバイダーの追加] を選択します。
使用する AI プロバイダーを選択します。
ご利用のプロバイダーに必要な構成情報を入力してください。
構成済みのプロバイダーの一覧にプロバイダーが表示されることを確認します。
アシスタントの Kubernetes API 要求を有効にする
Kubernetes API Request 設定を使用すると、AI アシスタントはクラスターに対してライブ Kubernetes API 要求を行うことができます。 有効にすると、アシスタントはリソースの状態、ポッド ログ、イベント、メトリックに対してクエリを実行して、コンテキストに対応した分析を提供できます。 無効にした場合、アシスタントはチャットで手動で指定した情報からのみ理由を付けることができます。
読み取り要求は自動的に実行されます。 Kubernetes リソースを作成、更新、または削除する要求には承認が必要であり、引き続き Kubernetes RBAC アクセス許可の対象となります。
設定>Plugins>AI アシスタントに移動します。
Kubernetes API Request トグルを有効にします。
MCP サーバーを有効にする
モデル コンテキスト プロトコル (MCP) サーバーを使用すると、AI アシスタントは外部ツールとデータ ソースに接続できます。 MCP サーバーは、トラブルシューティングと調査のワークフロー中に使用できる追加のコンテキストとアクションを提供することで、AI アシスタントの機能を拡張します。
AKS デスクトップでは MCP サーバーへの接続がサポートされていますが、MCP サーバーは既定では有効になっていません。
MCP サーバーは省略可能であり、AI Assistant の組み込みの AKS トラブルシューティングとクラスター対応の可観測性には必要ありません。 特定の外部ツールまたはデータ ソースに AI アシスタントを接続する必要がある場合にのみ、MCP サーバーを構成します。
MCP サーバーを選択する
必要な機能に基づいてサーバーを選択してください。
- Flux Operator MCP を使用して Flux GitOps のリソースとワークフローを調査します。
- eBPF トレースおよびランタイム診断には、Inspektor ガジェットを使用します。
AKS デスクトップで MCP サーバーを構成する前に、サーバーをインストールし、ローカル コマンドとして実行できることを確認してください。 これらの追加の統合のいずれかが必要ない場合は、MCP サーバーなしで AI Assistant を引き続き使用してください。
MCP サーバーを構成する
AKS デスクトップで、 設定>Plugins>AI アシスタントに移動します。
MCP サーバーを表示します。
MCP サーバーを有効にする をオンにします。
[ MCP サーバーの追加] を選択します。
MCP サーバーの構成に必要な情報を入力します。
サーバーの承認設定を構成します。
MCP サーバーの承認
MCP サーバーが AI アシスタントに代わってアクションを実行すると、アクションが実行される前に AKS デスクトップで承認が必要になる場合があります。 各 MCP サーバーの承認設定を構成します。
既定では、 自動承認アクション は無効になっています。 AI アシスタントは、要求された各アクションをチャット ウィンドウに表示し、MCP サーバーがそれを実行するには、ユーザーの承認が必要となります。
特定の MCP サーバーの 自動承認アクション を有効にして、そのサーバーからの要求を自動的に承認します。 有効にすると、AI Assistant は、各要求の承認を求めることなく MCP ツールを使用できます。
スキル リポジトリを有効にする
スキルは、特定のタスクの指示とサポート情報を提供します。 AKS デスクトップには、Azure Skills リポジトリの AKS スキルが含まれています。これは既定で有効になっています。 他のスキル リポジトリを有効にすることも、カスタム リポジトリを追加することもできます。
AKS デスクトップで、 設定>Plugins>AI アシスタントに移動します。
組み込みのスキル リポジトリの一覧を確認します。
各リポジトリの横にあるトグルを使用して、リポジトリを有効または無効にします。
リポジトリの追加 を選択してカスタムリポジトリを追加します。
リポジトリの URL を入力し、変更を保存してください。
事前診断
プロアクティブ診断は、既定で無効になっている個別のオプトイン機能です。 有効にすると、Headlamp の Kubernetes API プロキシを介したワンショット要求を使用して、クラスターを継続的に監視するのではなく、 Warning または Error の種類の最近のイベントについて、選択したクラスターをポーリングします。
最初のチェックは、AI バックエンドの準備が整った直後に行われ、スケジューラは 1 分に 1 回チェックします。 条件を満たすイベントが見つかると、アシスタントは、影響を受けた最新の個別のワークロードのうち、最大 3 つを順番に診断します。 診断サイクルが完了すると、別のサイクルを実行する前に 20 分間のクールダウンが開始されます。 該当するイベントが見つからない場合、診断サイクルは開始されないため、次の 1 分ごとのチェック時に、軽量イベント クエリを再度実行できます。 同じリソースを繰り返し診断しないように、成功した結果がキャッシュされます。
プロアクティブ診断を有効にする
AKS デスクトップで、 設定>Plugins>AI アシスタントに移動します。
プロアクティブ診断のトグルをオンにします。
AI アシスタントによって検出された問題と推奨事項を確認します。
推奨事項を選択して調査するか、トラブルシューティングを開始します。
AI アシスタントを無効にする
設定>Plugins に移動します。
AI アシスタントをオフにする。
保存して適用 を選択します。
プロンプトが表示されたら、AKS デスクトップを再読み込みしてください。