KubeBolt docs
ENES GitHub

Kobi

Kobi Copilot

El modo asistido de Kobi: habla con tu clúster en lenguaje natural, con 32 herramientas de lectura y 9 propuestas que solo se ejecutan si las apruebas.

En esta página
  1. Cómo funciona
  2. 32 herramientas de lectura
  3. 9 propuestas de acción
  4. Proveedores compatibles
  5. Leer tu nube
  6. Servidor MCP (solo lectura)
  7. ”Ask Kobi” contextual
  8. Conversaciones
  9. Memoria de la conversación
  10. Límite de alcance
  11. Analítica de uso

Kobi Copilot es el modo asistido de Kobi, el SRE con IA de KubeBolt: tú preguntas, Kobi responde. Viene en todas las ediciones: en el núcleo open source usas tu propia clave de LLM (consulta Activar Kobi); en KubeBolt Cloud la IA es gestionada. Para ver cómo se relaciona con Kobi Autopilot, consulta Conoce a Kobi.

Ábrelo con el lanzador de Kobi, abajo a la derecha, o con ⌘J (Ctrl+J en Linux y Windows).

Cómo funciona

El copiloto envía tu pregunta al proveedor de LLM configurado junto con las definiciones de 41 herramientas integradas (32 que leen y 9 que proponen un cambio), más las herramientas de cualquier conector de nube que tengas permitido usar. El backend ejecuta él mismo cada llamada a una herramienta, a través de la misma conexión con el clúster que usa el resto de KubeBolt: el LLM nunca habla directamente con tu clúster. Kobi analiza los resultados y responde con hallazgos respaldados por datos y, cuando es útil, comandos kubectl. Con las tarjetas de llamadas a herramientas activadas (lo están por defecto), cada llamada aparece en el panel como una tarjeta que puedes desplegar.

Además de diagnosticar, Kobi puede proponer la corrección: reiniciar, escalar, revertir, cambiar la imagen y más. Una propuesta no cambia nada por sí sola: solo se ejecuta cuando haces clic en Execute, con tu rol de KubeBolt, después de una vista previa con dry-run en el servidor, y cada acción ejecutada queda en el registro de auditoría. Consulta Acciones y gobernanza.

Kobi también responde cuando no hay ningún clúster conectado: sigue hablando de Kubernetes y de KubeBolt, y te dice que no hay un clúster en vivo que inspeccionar. En KubeBolt Cloud, una pregunta que supera el límite de preguntas a la vez de tu plan espera su turno en lugar de fallar (consulta Cuando Kobi está ocupado).

Qué llega al modelo

Tus mensajes, las instrucciones de Kobi, las definiciones de las herramientas y los resultados de las herramientas que llama Kobi: resúmenes y specs de recursos, eventos, fragmentos de logs, métricas. Antes de que un resultado salga del backend, los datos de los Secrets y los valores que parecen credenciales (en variables de entorno, args, anotaciones, mensajes de eventos, logs y la salida de describe) se sustituyen por [REDACTED]. La petición va de la API de KubeBolt al endpoint del proveedor configurado en Activar Kobi (en KubeBolt Cloud, el proveedor con el que funciona la plataforma); el navegador nunca habla con el proveedor y nunca ve la clave.

32 herramientas de lectura

HerramientaQué hace
get_cluster_overviewRecuento de recursos, CPU/memoria, puntuación de salud, eventos
list_resourcesLista cualquiera de 33 tipos de recurso (workloads, red, Gateway API, almacenamiento, configuración, RBAC, HPA y VPA, Certificates de cert-manager, Applications de Argo CD, políticas de Cilium, nodos, namespaces, eventos) con filtros
get_resource_detailDetalle completo de un recurso concreto
get_resource_yamlDefinición YAML en bruto (con los secretos ocultos, y los values de Helm, los parámetros y el entorno de plugin de una Application de Argo CD también). Incluye los objetos de External Secrets (ExternalSecret, SecretStore, ClusterSecretStore), con las credenciales en línea de un store ocultas. Lista la última escritura de cada field manager; el nombre de un manager es lo que la escritura dice ser, no quién la hizo
get_resource_describeSalida de kubectl describe para investigar a fondo
get_pod_logsLogs de pods con opciones de contenedor, tail, since y grep
get_workload_podsPods que pertenecen a un controlador de workload
get_workload_historyHistorial de revisiones de Deployments/StatefulSets/DaemonSets
get_workload_metricsCPU / memoria / red en un rango de tiempo para un workload, un pod o un nodo, y el llenado del disco de un nodo. Cada punto de CPU y de memoria es el máximo de su intervalo, y la respuesta dice cuándo se produjo el máximo
get_cronjob_jobsJobs hijos de un CronJob para investigar su historial de ejecuciones
get_topologyGrafo completo de la topología del clúster
get_insightsInsights activos con su severidad
get_eventsEventos con filtros. Sin permiso sobre los eventos lo indica: no ver ninguno no significa que no los haya
search_resourcesBúsqueda por nombre en 16 tipos de recurso comunes del clúster seleccionado; si ahí no hay coincidencias, en tus otros clústeres
get_permissionsPermisos RBAC detectados
list_clustersTodos los clústeres disponibles, y si el agente de cada uno está desactualizado, con el comando helm upgrade para dártelo. Kobi nunca lo ejecuta
get_kubebolt_docsBase de conocimiento del producto (funciones, navegación, páginas de administración)
get_insight_episodesHistorial de insights: episodios que se resolvieron, que caducaron o que siguen activos, cómo terminó cada uno y cuántas veces volvió
get_insight_episodeUn episodio completo: su línea de tiempo, a la que solo se añaden entradas, quién silenció qué y cuándo, y la evidencia tipada que registró la regla
get_operational_episodesRáfagas de insights que se dispararon a la vez, ya clasificadas por causa común (rotación de nodos, rollout, etc.)
get_recent_deploysRollouts de Deployments de las últimas horas, del más reciente al más antiguo: qué workload recibió un ReplicaSet nuevo, cuándo y con qué imagen
get_runtime_eventsEventos de seguridad en tiempo de ejecución de Falco: una shell abierta en un contenedor, la lectura de un archivo sensible, una conexión saliente inesperada
get_findingsPostura de seguridad: CVE y configuraciones incorrectas de Trivy, infracciones de políticas de Kyverno, controles CIS
get_finding_detailUn hallazgo releído en vivo desde el escáner, con cada paquete que tiene un CVE y su versión corregida
get_finding_workloadsHallazgos agrupados por workload y ordenados para ir resolviéndolos: primero los secretos expuestos, después por severidad
get_right_sizingRecomendaciones de rightsizing del mismo motor determinista que leen las pantallas Capacity y Cost
get_coverageQué puede ver KubeBolt ahora mismo: cómo está conectado el clúster, qué agentes reportan, qué fuentes de métricas responden
query_metricsUna consulta PromQL contra el almacén de métricas de KubeBolt, limitada a tu organización y al clúster actual
get_external_connectionsQué es cada dirección a la que llama un workload: dentro del clúster, otro de tus clústeres, un servicio de la nube o el exterior. Lee los flujos de Hubble, o la configuración del workload cuando no hay Hubble, y sigue un Service ExternalName hasta el punto en que sale del clúster
load_skillCarga uno de los 18 procedimientos de KubeBolt, desde un crash loop o una probe que falla hasta una dependencia externa, un error de credenciales o un rollback
get_fleet_summaryInsights activos por clúster en toda la organización, primero los peores. La única herramienta que ve fuera del clúster seleccionado
offer_cluster_switchOfrece cambiar a otro clúster con un clic, llevándose la pregunta para que la nueva conversación se abra ya preguntándola

Disco del nodo. Ante DiskPressure, desalojos por ephemeral-storage o “el disco se llenó”, Kobi lee el disco del nodo con get_workload_metrics (kind=Node, metric=filesystem): el disco más lleno en cada punto, con perMountpoint indicando cuál cuando node-exporter reporta varios puntos de montaje. Cada punto es el máximo de su paso, así que un disco que se llenó durante unos minutos no se diluye en la media, y el chat dibuja el resultado como una tarjeta Disk. Si se pide el disco de un pod o de un workload, se rechaza en lugar de aproximarlo (el uso de disco de un pod no es el del nodo), y una métrica que no se midió vuelve con un error en lugar de una serie vacía que se leería como inactividad. El IO de disco a nivel de pod no está expuesto; el llenado de un PVC se lee con query_metrics (kubelet_volume_stats_used_bytes / kubelet_volume_stats_capacity_bytes).

9 propuestas de acción

HerramientaProponeSobre
propose_restart_workloadUn reinicio progresivo (rolling restart)Deployment, StatefulSet, DaemonSet
propose_scale_workloadUn número de réplicas (0 lo pausa)Deployment, StatefulSet
propose_rollback_deploymentUn rollback a una revisión anteriorDeployment
propose_set_imageNuevas imágenes de contenedorDeployment, StatefulSet, DaemonSet
propose_set_resourcesNuevos requests y limits de CPU/memoriaDeployment, StatefulSet, DaemonSet
propose_set_envVariables de entorno añadidas, cambiadas o eliminadasDeployment, StatefulSet, DaemonSet
propose_patch_hpaNuevos minReplicas / maxReplicasHorizontalPodAutoscaler
propose_debug_podUn contenedor de depuración efímeroPod
propose_delete_resourceUna eliminación: escribes namespace/name para confirmarCualquier recurso

Cada una muestra en el chat una tarjeta de acción con una insignia de riesgo y una vista previa automática con dry-run: el clúster dice si aceptaría el cambio (cuota, LimitRange y webhooks de admisión incluidos) antes de que hagas clic en Execute. No pasa nada hasta que lo haces, y se ejecuta con tu rol: eliminar requiere Admin; el resto, Editor. Después de ejecutarse, el panel sigue el rollout; si no ha convergido dentro del tiempo límite de la acción (90 s por defecto), se le pregunta a Kobi por qué.

Los administradores pueden retirarlas todas (KUBEBOLT_AI_ACTIONS_ENABLED=false) o solo las destructivas (KUBEBOLT_AI_DESTRUCTIVE_ACTIONS_ENABLED=false). Los detalles están en Acciones y gobernanza.

Proveedores compatibles

KubeBolt incluye dos adaptadores de proveedor, y KUBEBOLT_AI_PROVIDER solo acepta estos dos valores:

Para cualquier proveedor que no sea el propio OpenAI, configura como URL base el endpoint de chat-completions completo del proveedor (por ejemplo https://api.x.ai/v1/chat/completions). KubeBolt envía las peticiones a esa URL tal cual y nunca le añade una ruta. El modelo tiene que admitir llamadas a herramientas (tool calling). La página Configuration muestra un catálogo seleccionado por proveedor y una opción Custom para cualquier otro ID de modelo.

El modelo pequeño por defecto responde a la mayoría de las preguntas dentro de un clúster. Combínalo con un modelo de escalamiento para que una investigación que sale del clúster continúe en uno más potente. Las URL base, las claves y todos los ajustes están en Activar Kobi.

Usa tu propia clave. En la edición open source configuras tu propia clave del proveedor y le pagas directamente a ese proveedor; KubeBolt no factura la IA. El backend hace de proxy de cada petición al LLM, así que la clave nunca llega al navegador, y una clave guardada desde la UI se cifra en reposo. En KubeBolt Cloud la IA es gestionada: no hay claves que configurar y el uso se descuenta de los créditos de tu plan.

Leer tu nube

Cuando la causa está fuera del clúster, Kobi puede seguirla hasta tu cuenta de AWS o Azure a través de conectores de nube, en solo lectura. Las herramientas de un conector se suman a las anteriores cuando un administrador lo configura y tu rol alcanza el mínimo del conector; si no lo alcanza, Kobi te dice que el conector existe y qué rol necesita. Una llamada que retuvo el presupuesto por minuto, o que se rechazó antes de enviarse, lo indica en su tarjeta en lugar de aparecer como un fallo.

Servidor MCP (solo lectura)

Treinta y una de las herramientas de lectura también se exponen a través del Model Context Protocol, así que cualquier host MCP (Claude Code, Cursor, un paso de CI, otro agente) puede investigar un clúster en vivo con su propio LLM. No hace falta ninguna clave de IA de KubeBolt: el modelo del host razona y KubeBolt solo sirve las herramientas.

La solo lectura se impone en el servidor: las 9 herramientas propose_* ni se listan ni se pueden llamar, ni siquiera por su nombre; llamar a una es un error de protocolo. La herramienta de lectura número treinta y dos, offer_cluster_switch, también se retiene: dibuja una tarjeta que solo sabe mostrar el propio panel de Kobi, así que para cualquier otro host sería una herramienta que no hace nada. Las herramientas de los conectores de nube nunca se sirven por MCP. El servidor también ofrece un prompt MCP, kobi-guidance, con las pautas de operación de Kobi para el modelo del host.

Conectar un host

  1. Crea una clave de API con MCP only (read-only tools) (consulta la sección siguiente) y copia su valor; solo se muestra una vez.

  2. Apunta el host a tu URL de KubeBolt con la clave en una cabecera bearer. Para los hosts que leen un archivo mcpServers (Claude Code, Cursor):

    {
      "mcpServers": {
        "kubebolt": {
          "type": "http",
          "url": "https://kubebolt.example.com/api/v1/mcp",
          "headers": { "Authorization": "Bearer kbk_xxxxxxxxxxxxxxxx" }
        }
      }
    }

    O, en Claude Code:

    claude mcp add --transport http kubebolt https://kubebolt.example.com/api/v1/mcp \
      --header "Authorization: Bearer kbk_xxxxxxxxxxxxxxxx"

    En KubeBolt Cloud la URL es https://api.kubebolt.io/api/v1/mcp, con una clave creada en tu organización.

  3. Pregúntale al host algo que necesite datos en vivo (“con las herramientas de kubebolt, ¿hay algún pod en crash loop?”) y comprueba que llama a las herramientas.

Para el binario local sirve cualquier host que lance un comando, Claude Desktop incluido:

{
  "mcpServers": {
    "kubebolt": {
      "command": "kubebolt-mcp",
      "args": ["--kubeconfig", "/home/me/.kube/config"]
    }
  }
}

kubebolt-mcp también acepta --connect-wait (segundos que espera al clúster antes de empezar a servir, 10 por defecto) y escribe sus logs en stderr, para que el flujo del protocolo en stdout quede limpio.

Qué token usar

Tu host MCP llega a KubeBolt a través de…TokenScopes
La URL de la UI de una instalación con Helm o Docker Compose (el nginx incluido, el caso habitual)Clave de API (kbk_)Debe incluir /api/v1/mcp o *
La API directamente: la imagen de un solo contenedor, o el Service <release>-api del chart desde dentro de tu redClave de API o token de servicio (kbs_)Los scopes por defecto de un token kbs_ ya incluyen /api/v1/mcp
KubeBolt Cloud, en https://api.kubebolt.io/api/v1/mcpClave de API (kbk_)MCP only; las organizaciones de Cloud no emiten tokens kbs_

Una clave de API no tiene scopes por defecto. Elige MCP only (read-only tools) en el diálogo de creación: la clave llega a /api/v1/mcp y a nada más, su rol queda fijado en viewer en el servidor y caduca a los 90 días salvo que lo cambies. Marca en ese mismo diálogo los clústeres que puede leer, o deja la lista vacía para que lea todos. A través de la API es lo mismo con "scopes":["/api/v1/mcp"].

Los tokens de servicio no funcionan a través de la URL de la UI. El nginx incluido marca cada petición que reenvía con X-KubeBolt-Edge: public, y la API rechaza los tokens de servicio kbs_ en esas peticiones con 401 invalid or expired token. Es deliberado: un token de servicio filtrado no sirve de nada desde internet. Si quieres usar un token kbs_, apunta el host directamente a la API (por ejemplo http://<release>-api.<namespace>.svc:8080/api/v1/mcp, o un kubectl port-forward svc/<release>-api 8080:8080).

initialize y tools/list responden incluso mientras el clúster está desconectado por un momento; un tools/call en ese intervalo devuelve un resultado isError que dice que hace falta acceso al clúster en vivo, en lugar de hacer fallar la sesión. get_kubebolt_docs sigue funcionando, porque no necesita clúster.

”Ask Kobi” contextual

Los botones Ask Kobi abren el panel con un clic y un prompt ya cargado con el clúster, el namespace, el recurso y el síntoma. Aparecen en:

Conversaciones

Las conversaciones son personales y se guardan por usuario, así que puedes recargar, cerrar sesión y retomar donde lo dejaste. El botón History de la cabecera del panel lista tus conversaciones anteriores; New conversation empieza una nueva. Para guardarlas hace falta tener la autenticación activada (lo está por defecto). La retención y el máximo por usuario se fijan con KUBEBOLT_COPILOT_CONVERSATION_RETENTION_HORIZON (por defecto 2160h) y KUBEBOLT_COPILOT_CONVERSATION_MAX_PER_USER (por defecto 200).

Memoria de la conversación

Las sesiones largas ya no pierden contexto. Cuando el tamaño estimado de la conversación supera SESSION_BUDGET_TOKENS × AUTO_COMPACT_THRESHOLD (80 % por defecto), el handler condensa los turnos más antiguos en un resumen generado por el modelo económico del proveedor (claude-haiku-5-5 / gpt-4o-mini) y sustituye por un marcador los tool_results voluminosos de la cola que se conserva. Los tool_results del turno activo siempre están protegidos, para que una compactación a mitad de respuesta nunca la trunque.

Un icono de tijeras en la cabecera del panel ofrece la misma operación a demanda: “new session with summary” condensa toda la transcripción en un único mensaje de resumen para que puedas cambiar de tema sin perder el contexto.

Variable de entornoValor por defectoPara qué sirve
KUBEBOLT_AI_AUTO_COMPACTtrueInterruptor general de la compactación automática
KUBEBOLT_AI_SESSION_BUDGET_TOKENSventana de contexto del modeloTecho total. La compactación salta en presupuesto × umbral
KUBEBOLT_AI_AUTO_COMPACT_THRESHOLD0.80Fracción del presupuesto en la que salta la compactación
KUBEBOLT_AI_COMPACT_MODELclaude-haiku-5-5 / gpt-4o-miniSustituye el modelo de resumen; es obligatorio en cualquier endpoint compatible con OpenAI que no sea el propio OpenAI, porque gpt-4o-mini solo existe allí. Funciona con el proveedor y la clave del principal
KUBEBOLT_AI_COMPACT_PRESERVE_TURNS3Turnos que se conservan intactos después de compactar

Los mismos ajustes están en Administration → AI (Kobi) → Configuration, dentro de Behavior (Auto-compact, Session budget, Compact threshold, Compact model, Preserve turns). El chart no tiene valores para estas variables: configúralas con extraEnv o desde esa página. En KubeBolt Cloud se gestionan según tu plan.

Límite de alcance

El prompt del sistema define qué está dentro del alcance (operaciones de Kubernetes, temas de DevOps/SRE al servicio del clúster del usuario, el propio KubeBolt) y qué queda fuera (programación general sin relación con Kubernetes, temas no técnicos, productos de nube que no corren sobre Kubernetes). El LLM rechaza las preguntas fuera de alcance con una redirección amable de una sola frase en el idioma del usuario; nunca responde a medias.

Analítica de uso

Administration → AI (Kobi) → Usage (rol Admin): sesiones, tokens facturados, tasa de aciertos de caché, costo estimado en USD (una tabla de precios aproximada: tu factura real es lo que cobre tu proveedor; los modelos desconocidos no muestran estimación), las herramientas más usadas con sus tasas de error y un desglose por sesión con el detalle por herramienta y los eventos de compactación. Selector de rango 24h / 7d / 30d. Se guarda localmente en BoltDB con un límite de retención de 30 días / 5000 registros. Requiere tener la autenticación activada. La pestaña Health, a su lado, muestra cómo terminan las respuestas (completadas, sin rondas restantes, con errores), las valoraciones 👍/👎 de las respuestas y la proporción de lecturas de caché; las llamadas a la nube rechazadas o retenidas no cuentan como herramientas que fallan.

En KubeBolt Cloud la misma vista está en Administration → AI & Autopilot → Usage & Credits, en créditos en lugar de dólares, con Copilot y Autopilot uno al lado del otro.