Resolução de problemas e compreensão de cargas de trabalho com linguagem natural no desktop AKS (pré-visualização)

O AI Assistant no desktop AKS fornece uma resolução melhorada de problemas em linguagem natural para cargas de trabalho AKS. Impulsionado pelo Headlamp AI Assistant, oferece competências específicas do AKS, observabilidade consciente do cluster, fluxos de trabalho guiados para resolução de problemas e integração perfeita com o seu direito já existente ao GitHub Copilot.

Depois de se ligar de forma segura ao seu cluster, o assistente combina modelos de linguagem com contexto, registos, eventos e métricas específicos do AKS para identificar problemas e recomendar soluções em linguagem simples. Esta abordagem permite que os programadores e operadores compreendam e resolvam rapidamente problemas sem necessidade de profunda experiência em Kubernetes. Este artigo explica-te como ativar e usar o AI Assistant no desktop AKS.

Prerequisites

Antes de ativares o Assistente de IA no ambiente de trabalho AKS, certifica-te de que tens:

  • AKS desktop v0.10.0 ou posterior instalada.
  • Acesso a um ou mais clusters Kubernetes que pretendas investigar.
  • O plugin AI Assistant ativado em Definições>Plugins. O plugin está ativado por defeito.
  • Uma das seguintes configurações de fornecedor:
    • GitHub Copilot Auto Detect (recomendado): Uma subscrição do GitHub Copilot, CLI do GitHub (gh) instalada na sua máquina e CLI do GitHub autenticada com a sua conta GitHub.
    • Outro fornecedor de IA suportado: Acesso a um fornecedor suportado ou endpoint compatível com OpenAI.

O que é o Assistente de IA?

O AI Assistant vem incluído no desktop AKS e oferece uma experiência orientada para diagnosticar problemas no seu cluster. O assistente ajuda-o a:

  • Execute diagnósticos com âmbito que analisem logs, eventos e métricas.
  • Receba resumos gerados por IA com raciocínio e evidências claras.
  • Pré-visualize as ações recomendadas e aplique-as com confiança.
  • Usa o GitHub Copilot quando disponível para uma experiência de configuração mais fluida.
  • Utilize a observabilidade consciente de clusters e competências específicas do AKS para trazer contexto adicional e boas práticas às investigações.

Como funciona o Assistente de IA?

Tens duas opções para ativar o Assistente de IA no ambiente de trabalho AKS:

  • Use o GitHub Copilot (recomendado). Se a CLI do GitHub estiver instalada e autenticada com uma conta que tenha uma subscrição do GitHub Copilot, o desktop do AKS pode detetar e configurar o GitHub Copilot como fornecedor.
  • Outro fornecedor de IA suportado: Configure manualmente um fornecedor suportado ou um endpoint compatível com OpenAI.

Para qualquer uma das opções, o AKS desktop pode fornecer contexto de cluster e capacidades do AKS ativadas ao fornecedor configurado.

O AI Assistant funciona como parte do desktop do AKS e não implementa um agente ou outra carga de trabalho no teu cluster. O desktop do AKS liga-se ao cluster selecionado através da API Kubernetes usando as credenciais no seu kubeconfig. O assistente está limitado às operações permitidas pelas permissões RBAC do Kubernetes.

Ativar o GitHub Copilot (Deteção Automática)

  1. Instala o GitHub CLI (gh) na tua máquina e inicia sessão na tua conta GitHub.

  2. No desktop do AKS, vá a Definições>Plugins>AI Assistant.

  3. Selecione Deteção Automática.

  4. Verifica se o GitHub Copilot aparece como o fornecedor configurado.

    Captura de ecrã das definições do assistente de IA no desktop do AKS a mostrar o botão de Deteção Automática.

Configure o seu próprio fornecedor de IA

  1. No desktop do AKS, vai a Definições>Plugins>AI Assistant.

  2. Selecione Adicionar provedor.

  3. Selecione o fornecedor de IA que quer usar.

  4. Introduza a informação de configuração necessária para o seu fornecedor de serviços.

  5. Verifique se o provedor aparece na lista de provedores configurados.

    Captura de ecrã da caixa de diálogo de seleção do fornecedor do ambiente de trabalho AKS, mostrando os fornecedores de IA suportados.

Ativar pedidos da API Kubernetes para o assistente

A definição Kubernetes API Request permite ao Assistente de IA fazer pedidos da API Kubernetes em tempo real no seu cluster. Quando ativado, o assistente pode consultar o estado do recurso, pod logs, eventos e métricas para fornecer uma análise contextualizada. Se estiver desativado, o assistente só pode raciocinar com base nas informações que forneces manualmente no chat.

As solicitações de leitura podem ser executadas automaticamente. Os pedidos que criam, atualizam ou eliminam recursos Kubernetes requerem a sua aprovação e continuam sujeitos às permissões RBAC do Kubernetes.

  1. Vá para Definições>Plugins>Assistente de IA.

  2. Ative a opção de Kubernetes API Request.

    Captura de ecrã das definições das ferramentas de IA do desktop AKS a mostrar o Pedido da API do Kubernetes ativado.

Ativar servidores MCP

Os servidores do Protocolo de Contexto de Modelo (MCP) permitem que o Assistente de IA se ligue a ferramentas e fontes de dados externas. Os servidores MCP expandem as capacidades do Assistente de IA ao fornecer contexto adicional e ações que podem ser usadas durante fluxos de trabalho de resolução de problemas e investigação.

O desktop do AKS suporta ligações a servidores MCP, mas os servidores MCP não estão ativados por defeito.

Os servidores MCP são opcionais e não são obrigatórios para a resolução de problemas AKS integrada do AI Assistant e para a observabilidade com reconhecimento do cluster. Configure um servidor MCP apenas quando precisar de ligar o AI Assistant a uma ferramenta externa específica ou fonte de dados.

Escolha um servidor MCP

Escolha um servidor com base na capacidade de que precisa:

  • Utilize o Flux Operator MCP para investigar recursos e fluxos de trabalho do Flux GitOps.
  • Use o Inspektor Gadget para rastreamento eBPF e diagnósticos em tempo de execução.

Antes de configurares um servidor MCP no desktop AKS, instala o servidor e confirma que o servidor pode ser executado localmente como comando. Se não precisar de uma destas integrações adicionais, continue a usar o AI Assistant sem um servidor MCP.

Configurar um servidor MCP

  1. No desktop do AKS, vai a Definições>Plugins>AI Assistant.

  2. Ver servidores MCP.

  3. Ativa servidores MCP.

  4. Selecione Adicionar Servidor MCP.

  5. Introduza a informação de configuração necessária para o servidor MCP.

  6. Configure as definições de aprovação do servidor.

    Captura de ecrã das definições dos servidores MCP do AKS desktop mostrando o botão Ativar Servidores MCP e Adicionar Servidor MCP.

Aprovações do servidor MCP

Quando um servidor MCP executa uma ação em nome do Assistente de IA, o desktop AKS pode exigir aprovação antes de a ação ser executada. Configura as definições de aprovação para cada servidor MCP.

Por defeito, a Aprovação Automática de Ações está desativada. O Assistente de IA mostra cada ação solicitada na janela de chat e requer a sua aprovação antes de o servidor MCP a executar.

Ative as Ações de Aprovação Automática para um servidor MCP específico para aprovar automaticamente os pedidos desse servidor. Quando ativado, o Assistente de IA pode usar ferramentas MCP sem necessidade de aprovação para cada pedido.

Ativar repositórios de competências

As Skills fornecem instruções e informação de apoio para tarefas específicas. O desktop do AKS inclui uma skill AKS do repositório Azure Skills, que está ativada por defeito. Podes ativar outros repositórios de skills ou adicionar um repositório personalizado.

  1. No desktop do AKS, vai a Definições>Plugins>AI Assistant.

  2. Reveja a lista de repositórios de competências incorporados.

  3. Utilize o botão de alternância ao lado de cada repositório para ativar ou desativar repositórios.

  4. Selecione Adicionar Repositório para adicionar um repositório personalizado.

  5. Introduza a URL do repositório e guarde as suas alterações.

    Captura de ecrã das definições de habilidades do desktop do AKS mostrando o repositório Azure Skills configurado com o caminho azure-kubernetes e ativado.

Diagnóstico proativo

O diagnóstico proativo é uma funcionalidade separada, de opt-in, que está desativada por defeito. Quando ativado, utiliza pedidos one-shot através do proxy da API Kubernetes da Headlamp para sondar clusters selecionados para eventos recentes com um tipo de Warning ou Error , em vez de monitorizar continuamente os clusters.

A primeira verificação ocorre pouco depois de o backend da IA estar pronto, e o agendador verifica uma vez por minuto. Quando são encontrados eventos qualificadores, o assistente diagnostica até três das cargas de trabalho afetadas mais recentes e distintas, de forma sequencial. Após a conclusão do ciclo de diagnóstico, começa um período de arrefecimento de 20 minutos antes de poder decorrer outro ciclo. Se não forem encontrados eventos qualificadores, não começa nenhum ciclo de diagnóstico, pelo que a consulta leve do evento pode ser executada novamente na verificação de um minuto seguinte. Os resultados bem-sucedidos são armazenados em cache para evitar o diagnóstico repetido do mesmo recurso.

Ativar o diagnóstico proativo

  1. No desktop do AKS, vai a Definições>Plugins>AI Assistant.

  2. Ativa o interruptor Diagnóstico Proativo.

  3. Revise os problemas detetados e as recomendações apresentadas pelo Assistente de IA.

  4. Escolha uma recomendação para investigar ou iniciar a resolução de problemas.

    Captura de ecrã das definições do Assistente de IA do AKS para desktop a mostrar o interruptor de Diagnóstico Proativo.

Desative o Assistente de IA

  1. Vai a Definições>Plugins.

  2. Desliga o Assistente de IA.

  3. Selecione Guardar & Aplicar.

  4. Recarregue o desktop do AKS se lhe for pedido.

    Captura de ecrã da lista de plugins de desktop do AKS a mostrar o interruptor do AI Assistant desligado.