Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

Arquitectura

El sistema está diseñado como un ecosistema multi-agente jerárquico. Utiliza un Supervisor (Liz) central para orquestar solicitudes a través de múltiples Agentes de IA especializados, cada uno conectado a uno o más servidores MCP (Protocolo de Contexto del Modelo).

Componentes

El Supervisor (Liz)

Liz es el punto de entrada del sistema y el orquestador de la experiencia del usuario. En lugar de ejecutar cada tarea técnica directamente, Liz actúa como un Enrutador inteligente.

  • Analiza el aviso del usuario para determinar el dominio requerido (por ejemplo, Seguridad, Aprovisionamiento o Flota).

  • Consulta los metadatos de AIAgentConfig para seleccionar el Agente especializado más apropiado para la tarea.

  • Rastrea la ubicación del usuario en la interfaz de Rancher y asegura que los metadatos relevantes del clúster, espacio de nombres y recursos se pasen a los Agentes en sentido descendente para proporcionar una respuesta "consciente del contexto".

Agentes de IA Especializados (La "Tripulación")

Los Agentes Especializados son los caballos de batalla del sistema. Cada agente es el orquestador de la inteligencia de su dominio específico. Utiliza un modelo extenso de lenguaje (LLM) como su motor de razonamiento, mientras que el agente mismo proporciona la estructura, coordinación y ejecución segura de acciones.

  • LLM (Motor de Razonamiento):

    • Interpreta las entradas del usuario expresadas en lenguaje natural.

    • Realiza el razonamiento: descompone solicitudes complejas en pasos más pequeños.

    • Decide qué debe suceder a continuación (seguir razonando vs. actuar).

    • Sintetiza salidas de herramientas en respuestas claras y legibles para humanos.

  • Agente (Orquestador):

    • Envuelve el LLM con el patrón ReAct (Razonar + Actuar).

    • Decide cuándo dejar que el LLM siga razonando o cuándo actuar según sus instrucciones.

    • Llama a herramientas externas (a través del Servidor MCP) según lo indicado por el LLM.

    • Asegura interacciones seguras al pasar el token de Rancher del usuario al servidor MCP para autenticación y autorización.

Servidor MCP

El Servidor MCP actúa como una puerta de enlace segura y controlada entre el Agente ReAct y las APIs de Rancher y Kubernetes. Sus funciones incluyen:

  • Exposición de Herramientas: Proporciona un conjunto de herramientas bien definidas y seguras (puntos finales de API) que el Agente ReAct puede llamar. Estas herramientas abstraen la complejidad de las interacciones directas con la API de Rancher/Kubernetes.

  • Interacción con Rancher: Traduce las llamadas a herramientas del agente en las solicitudes de API apropiadas al servidor de gestión de Rancher, recuperando o modificando recursos según sea necesario.

Extensión de UI

La Extensión de UI proporciona la interfaz de chat orientada al usuario dentro del panel de control de Rancher. Está diseñada para ser una parte integrada de la experiencia de Rancher y es responsable de:

  • Entrada del Usuario: Captura las consultas del usuario y las envía al Agente ReAct.

  • Mostrando Respuestas: Recibe respuestas del Agente ReAct y las presenta en un formato similar al chat.

Cómo Funciona (El Flujo)

  1. Petición del Usuario: El usuario envía una consulta a través de la extensión de la UI.

  2. Enrutamiento del Supervisor: Liz identifica la intención y enruta la consulta, junto con el contexto de la UI, al Agente especializado (por ejemplo, el Fleet Agent).

  3. Razonamiento LLM: El LLM del Agente especializado interpreta la solicitud, razona sobre el problema y propone un plan de acción.

  4. Actuación del Agente: Si el plan requiere operaciones externas, el agente llama a las herramientas del Servidor MCP apropiado utilizando el token seguro del usuario.

  5. Formulación de Respuesta: El LLM toma las salidas de las herramientas y elabora una respuesta coherente y legible para los humanos.

  6. Respuesta Final: Liz entrega la respuesta sintetizada del Agente de vuelta a la UI.

grafo TD subgráfico "A. Interacción del Usuario" Usuario[Usuario / DevOps] UI[Extensión de la UI] fin subgráfico "B. Capa del Supervisor" Liz{Liz Supervisor} fin subgráfico "C. Agentes Especializados (ReAct)" + AgenteRancher(Agente Rancher) + AgenteFleet(Agente Fleet) + AgenteProv(Agente de Aprovisionamiento Rancher) + AgenteAppCo(Agente de Colección de Aplicaciones SUSE) + AgenteObs(Agente de Observabilidad SUSE) + AgenteSeg(Agente de Seguridad SUSE) + AgentePersonalizado(Agente Personalizado) + fin subgráfico "Capa de Razonamiento LLM (Aplicable a todos los Agentes)" dirección LR LLMLocal[LLM Local] LLMPúblico[LLM Público] fin subgráfico "D. Puertas de Infraestructura" MCP1[MCP Rancher] MCP2[MCP de Colección de Aplicaciones] MCP_Obs[MCP de Observabilidad] MCP_Seg[MCP de Seguridad] MCP4[MCP de Terceros] fin subgráfico "E. Datos y APIs" API_Rancher[(API Rancher / K8s)] API_AppCo[(API de Colección de Aplicaciones)] DB_Métricas[(Observabilidad SUSE / Métricas)] DB_Vulnerabilidades[(Seguridad / Escaneos CVE)] API_Externa[(Sistema Externo)] fin %% Flujo Usuario -- "1. Consulta" --> UI UI -- "2. Context + Intent" --> Liz Liz -- "3. Rutas" --> RancherAgent Liz --> FleetAgent Liz --> ProvAgent Liz --> AppCoAgent Liz --> ObsAgent Liz --> SecAgent Liz --> CustomAgent %% Ejemplo de Bucle de Razonamiento + AgenteRancher -. "Motor de Razonamiento" .-> LocalLLM RancherAgent -. "Motor de Razonamiento" .-> LLMPúblico %% Conexiones de Razón + Actuar + AgenteRancher -- "4" --> MCP1 + AgenteFleet -- "4" --> MCP1 + AgenteProv -- "4" --> MCP1 + AgenteAppCo -- "4" --> MCP2 + AgenteObs -- "4" --> MCP_Obs + AgenteSec -- "4" --> MCP_Sec + AgentePersonalizado -- "4" --> MCP4 %% Conexiones API + MCP1 -- "5" --> RancherAPI + MCP2 -- "5" --> AppCoAPI + MCP_Obs -- "5" --> MetricsDB + MCP_Sec -- "5" --> VulnDB + MCP4 -- "5" --> ExternalAPI %% Estilo estilo Liz fill:#f9f,stroke:#333,stroke-width:2px estilo LLMLocal fill:#fff3cd,stroke:#ffc107,stroke-dasharray: 5 5 estilo LLMPúblico fill:#fff3cd,stroke:#ffc107,stroke-dasharray: 5 5 estilo Nota fill:#fff,stroke:none estilo AgenteRancher fill:#d4edda,stroke:#28a745 estilo AgenteFleet fill:#d4edda,stroke:#28a745 estilo AgenteProv fill:#d4edda,stroke:#28a745 estilo AgenteAppCo fill:#d4edda,stroke:#28a745 estilo AgenteObs fill:#d4edda,stroke:#28a745 estilo AgenteSec fill:#d4edda,stroke:#28a745 estilo MCP_Obs fill:#cce5ff,stroke:#007bff estilo MCP_Sec fill:#cce5ff,stroke:#007bff