Solución de problemas y comprensión de las cargas de trabajo con lenguaje natural en el escritorio de AKS (versión preliminar)

El Asistente de IA en el escritorio de AKS ofrece una resolución de problemas mejorada en lenguaje natural para cargas de trabajo de AKS. Con tecnología de Headlamp AI Assistant, ofrece aptitudes específicas de AKS, observabilidad con reconocimiento del clúster, flujos de trabajo de solución de problemas guiados e integración perfecta con los derechos de GitHub Copilot existentes.

Después de conectarse de forma segura al clúster, el asistente combina modelos de lenguaje con contexto, registros, eventos y métricas específicos de AKS para identificar problemas y recomendar soluciones en lenguaje claro. Este enfoque permite a los desarrolladores y operadores comprender y corregir rápidamente problemas sin necesidad de conocimientos profundos de Kubernetes. En este artículo se explica cómo habilitar y usar ai Assistant en el escritorio de AKS.

Requisitos previos

Antes de habilitar AI Assistant en el escritorio de AKS, asegúrese de que tiene:

  • AKS desktop v0.10.0 o posterior instalado.
  • Acceso a uno o varios clústeres de Kubernetes que desea investigar.
  • El complemento AI Assistant está habilitado en Configuración>. El complemento está habilitado de forma predeterminada.
  • Una de las siguientes configuraciones de proveedor:
    • GitHub Copilot Detección automática (recomendado): una suscripción de GitHub Copilot, GitHub CLI (gh) instalada en el equipo y GitHub CLI autenticada con la cuenta de GitHub.
    • Otro proveedor de IA compatible: acceso a un proveedor compatible o a un punto de conexión compatible con OpenAI.

¿Qué es AI Assistant?

Ai Assistant se incluye con el escritorio de AKS y proporciona una experiencia guiada para diagnosticar problemas en el clúster. El asistente le ayuda a:

  • Ejecuten diagnósticos específicos que analicen registros, eventos y métricas.
  • Recibir resúmenes generados por ia con un razonamiento y evidencia claros.
  • Obtenga una vista previa de las acciones recomendadas y aplíquelas con confianza.
  • Usa GitHub Copilot cuando esté disponible para una experiencia de configuración simplificada.
  • Use la observabilidad centrada en el clúster y las habilidades específicas de AKS para incorporar más contexto y prácticas recomendadas a las investigaciones.

¿Cómo funciona ai Assistant?

Tiene dos opciones para habilitar ai Assistant en el escritorio de AKS:

  • Usa GitHub Copilot (recomendado). Si GitHub CLI está instalada y autenticada con una cuenta que tiene una suscripción de GitHub Copilot, el escritorio de AKS puede detectar y configurar GitHub Copilot como proveedor.
  • Otro proveedor de IA compatible: configure manualmente un proveedor compatible o un punto de conexión compatible con OpenAI.

Para cualquier opción, AKS desktop puede proporcionar el contexto del clúster y las habilidades de AKS habilitadas al proveedor configurado.

AI Assistant se ejecuta como parte de AKS desktop y no implementa ningún agente ni ninguna otra carga de trabajo en el clúster. AKS desktop se conecta al clúster seleccionado a través de la API de Kubernetes mediante las credenciales del archivo kubeconfig. El asistente está limitado a las operaciones permitidas por los permisos de RBAC de Kubernetes.

Habilitar GitHub Copilot (detección automática)

  1. Instale GitHub CLI (gh) en el equipo e inicie sesión en la cuenta de GitHub.

  2. En el escritorio de AKS, vaya a Configuración>plugins>AI Assistant.

  3. Seleccione Detección automática.

  4. Compruebe que GitHub Copilot aparezca como proveedor configurado.

    Captura de pantalla de la configuración de AKS desktop AI Assistant en la que se muestra el botón Detección automática.

Configure su propio proveedor de IA

  1. En el escritorio de AKS, vaya a Configuración>plugins>AI Assistant.

  2. Seleccione Añadir proveedor.

  3. Seleccione el proveedor de IA que desea usar.

  4. Escriba la información de configuración necesaria para su proveedor.

  5. Compruebe que el proveedor aparece en la lista de proveedores configurados.

    Captura de pantalla del cuadro de diálogo de selección del proveedor de escritorio de AKS que muestra los proveedores de IA admitidos.

Habilitación de solicitudes de API de Kubernetes para el asistente

La configuración solicitud de API de Kubernetes permite que AI Assistant realice solicitudes de API de Kubernetes activas en el clúster. Cuando se habilita, el asistente puede consultar el estado de los recursos, los registros de pods, los eventos y las métricas para proporcionar análisis con reconocimiento del contexto. Si está deshabilitado, el asistente solo puede razonar de la información que proporcione manualmente en el chat.

Las peticiones de lectura se pueden ejecutar automáticamente. Las solicitudes que crean, actualizan o eliminan recursos de Kubernetes requieren su aprobación y siguen estando sujetas a los permisos de RBAC de Kubernetes.

  1. Vaya a Configuración>plugins>AI Assistant.

  2. Habilite el interruptor Solicitud de API de Kubernetes.

    Captura de pantalla de la configuración de herramientas de INTELIGENCIA artificial de escritorio de AKS que muestra la Solicitud a la API de Kubernetes habilitada.

Habilitar servidores MCP

Los servidores de Model Context Protocol (MCP) permiten que AI Assistant se conecte con herramientas y orígenes de datos externos. Los servidores MCP amplían las funcionalidades del Asistente para IA proporcionando contexto y acciones adicionales que se pueden usar durante los flujos de trabajo de solución de problemas e investigación.

El escritorio de AKS admite conexiones a servidores MCP, pero los servidores MCP no están habilitados de forma predeterminada.

Los servidores MCP son opcionales y no son necesarios para la solución de problemas integrada de AKS de AI Assistant y la observabilidad compatible con clústeres. Configure un servidor MCP solo cuando necesite conectar AI Assistant a una herramienta o origen de datos externo específico.

Elección de un servidor MCP

Elija un servidor en función de la funcionalidad que necesita:

  • Usa Flux Operator MCP para investigar los flujos de trabajo y los recursos de GitOps de Flux.
  • Usa Inspektor Gadget para el seguimiento de eBPF y los diagnósticos en tiempo de ejecución.

Antes de configurar un servidor MCP en AKS Desktop, instale el servidor y confirme que se puede ejecutar como un comando local. Si no necesita una de estas integraciones adicionales, siga usando AI Assistant sin un servidor MCP.

Configurar un servidor MCP

  1. En el escritorio de AKS, vaya a Configuración>plugins>AI Assistant.

  2. Vea servidores de MCP.

  3. Activa Habilitar servidores MCP.

  4. Seleccione Agregar servidor MCP.

  5. Escriba la información de configuración necesaria para el servidor MCP.

  6. Configure la configuración de aprobación para el servidor.

    Captura de pantalla de la configuración de servidores MCP de escritorio de AKS en la que se muestran el interruptor Habilitar servidores MCP y el botón Agregar servidor MCP.

Aprobaciones del servidor MCP

Cuando un servidor MCP realiza una acción en nombre del Asistente para IA, el escritorio de AKS puede requerir aprobación antes de que se ejecute la acción. Configure la configuración de aprobación para cada servidor de MCP.

De forma predeterminada, Auto Approve Actions está deshabilitado. Ai Assistant muestra cada acción solicitada en la ventana de chat y requiere la aprobación antes de que el servidor MCP pueda ejecutarla.

Habilite Acciones de aprobación automática para un servidor MCP específico para aprobar automáticamente las solicitudes de ese servidor. Cuando se habilita, AI Assistant puede usar herramientas de MCP sin solicitar aprobación para cada solicitud.

Habilitar repositorios de habilidades

Las habilidades proporcionan instrucciones e información auxiliar para tareas específicas. AKS desktop incluye una habilidad de AKS del repositorio de habilidades de Azure, que está habilitada de forma predeterminada. Puede habilitar otros repositorios de aptitudes o agregar un repositorio personalizado.

  1. En el escritorio de AKS, vaya a Configuración>plugins>AI Assistant.

  2. Revise la lista de repositorios de habilidades integrados.

  3. Use la alternancia junto a cada repositorio para habilitarlos o deshabilitarlos.

  4. Seleccione Agregar repositorio para agregar un repositorio personalizado.

  5. Escriba la dirección URL del repositorio y guarde los cambios.

    Captura de pantalla de la configuración de aptitudes de escritorio de AKS que muestra el repositorio de aptitudes de Azure configurado con la ruta de acceso azure-kubernetes y habilitado.

Diagnóstico proactivo

El diagnóstico proactivo es una función independiente de activación voluntaria que está deshabilitada de forma predeterminada. Cuando está habilitada, usa solicitudes de un solo uso a través del proxy de API de Kubernetes de Headlamp para sondear los clústeres seleccionados para eventos recientes con un tipo de Warning o Error en lugar de observar continuamente los clústeres.

La primera comprobación se produce poco después de que el back-end de IA esté listo y el planificador comprueba una vez por minuto. Cuando se encuentran eventos aptos, el asistente diagnostica secuencialmente hasta tres de las cargas de trabajo afectadas distintas más recientes. Una vez completado un ciclo de diagnóstico, comienza un tiempo de enfriamiento de 20 minutos antes de que se pueda ejecutar otro ciclo. Si no se encuentra ningún evento calificado, no se inicia ningún ciclo de diagnóstico, por lo que la consulta de eventos ligeros se puede volver a ejecutar en la siguiente comprobación de un minuto. Los resultados correctos se almacenan en caché para evitar diagnosticar repetidamente el mismo recurso.

Habilitar el diagnóstico proactivo

  1. En el escritorio de AKS, vaya a Configuración>plugins>AI Assistant.

  2. Active el interruptor Diagnóstico proactivo.

  3. Revise los problemas detectados y las recomendaciones expuestas por ai Assistant.

  4. Seleccione una recomendación para investigar o comenzar a solucionar problemas.

    Captura de pantalla de la configuración de Asistente de IA de escritorio AKS que muestra el botón de alternancia Diagnóstico proactivo.

Desactivar el Asistente de IA

  1. Vaya a Configuración>Complementos.

  2. Desactive AI Assistant.

  3. Seleccione Guardar y aplicar.

  4. Vuelva a cargar el escritorio de AKS si se le solicita.

    Captura de pantalla de la lista de complementos de escritorio de AKS en la que se muestra el botón de alternancia AI Assistant desactivado.