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
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
| Herramienta | Qué hace |
|---|---|
get_cluster_overview | Recuento de recursos, CPU/memoria, puntuación de salud, eventos |
list_resources | Lista 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_detail | Detalle completo de un recurso concreto |
get_resource_yaml | Definició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_describe | Salida de kubectl describe para investigar a fondo |
get_pod_logs | Logs de pods con opciones de contenedor, tail, since y grep |
get_workload_pods | Pods que pertenecen a un controlador de workload |
get_workload_history | Historial de revisiones de Deployments/StatefulSets/DaemonSets |
get_workload_metrics | CPU / 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_jobs | Jobs hijos de un CronJob para investigar su historial de ejecuciones |
get_topology | Grafo completo de la topología del clúster |
get_insights | Insights activos con su severidad |
get_events | Eventos con filtros. Sin permiso sobre los eventos lo indica: no ver ninguno no significa que no los haya |
search_resources | Búsqueda por nombre en 16 tipos de recurso comunes del clúster seleccionado; si ahí no hay coincidencias, en tus otros clústeres |
get_permissions | Permisos RBAC detectados |
list_clusters | Todos 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_docs | Base de conocimiento del producto (funciones, navegación, páginas de administración) |
get_insight_episodes | Historial de insights: episodios que se resolvieron, que caducaron o que siguen activos, cómo terminó cada uno y cuántas veces volvió |
get_insight_episode | Un 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_episodes | Ráfagas de insights que se dispararon a la vez, ya clasificadas por causa común (rotación de nodos, rollout, etc.) |
get_recent_deploys | Rollouts 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_events | Eventos 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_findings | Postura de seguridad: CVE y configuraciones incorrectas de Trivy, infracciones de políticas de Kyverno, controles CIS |
get_finding_detail | Un hallazgo releído en vivo desde el escáner, con cada paquete que tiene un CVE y su versión corregida |
get_finding_workloads | Hallazgos agrupados por workload y ordenados para ir resolviéndolos: primero los secretos expuestos, después por severidad |
get_right_sizing | Recomendaciones de rightsizing del mismo motor determinista que leen las pantallas Capacity y Cost |
get_coverage | Qué puede ver KubeBolt ahora mismo: cómo está conectado el clúster, qué agentes reportan, qué fuentes de métricas responden |
query_metrics | Una consulta PromQL contra el almacén de métricas de KubeBolt, limitada a tu organización y al clúster actual |
get_external_connections | Qué 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_skill | Carga 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_summary | Insights activos por clúster en toda la organización, primero los peores. La única herramienta que ve fuera del clúster seleccionado |
offer_cluster_switch | Ofrece 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
| Herramienta | Propone | Sobre |
|---|---|---|
propose_restart_workload | Un reinicio progresivo (rolling restart) | Deployment, StatefulSet, DaemonSet |
propose_scale_workload | Un número de réplicas (0 lo pausa) | Deployment, StatefulSet |
propose_rollback_deployment | Un rollback a una revisión anterior | Deployment |
propose_set_image | Nuevas imágenes de contenedor | Deployment, StatefulSet, DaemonSet |
propose_set_resources | Nuevos requests y limits de CPU/memoria | Deployment, StatefulSet, DaemonSet |
propose_set_env | Variables de entorno añadidas, cambiadas o eliminadas | Deployment, StatefulSet, DaemonSet |
propose_patch_hpa | Nuevos minReplicas / maxReplicas | HorizontalPodAutoscaler |
propose_debug_pod | Un contenedor de depuración efímero | Pod |
propose_delete_resource | Una eliminación: escribes namespace/name para confirmar | Cualquier 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:
anthropic: la API de Claude. El modelo por defecto esclaude-haiku-5-5(Claude Haiku 5.5); Sonnet 5.5, Opus 5.5, Fable 5 y modelos de Claude anteriores están en el catálogo de la página Configuration. El caché de prompts cubre el prompt del sistema y las definiciones de las herramientas, y se conserva una hora por defecto.openai: el propio OpenAI (modelo por defectogpt-4o) y cualquier API de Chat Completions compatible con OpenAI: Azure OpenAI, xAI, DeepSeek, Groq, Mistral, OpenRouter y runners autoalojados como Ollama o vLLM. Los modelos Pro de OpenAI no son compatibles: OpenAI solo los sirve a través de/v1/responses.
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.
- Remoto, por HTTP: el servidor publica
POST /api/v1/mcpcon el transporte estándar Streamable HTTP, detrás de la autenticación normal de KubeBolt con un token de API. El token identifica al tenant; envíaX-KubeBolt-Cluster: <context-name>(un nombre deGET /api/v1/clusters) para apuntar a un clúster concreto en lugar del activo. - Local, por stdio: el binario independiente
kubebolt-mcphabla MCP por stdin/stdout directamente contra tu kubeconfig, sin servidor y sin autenticación. Descárgalo de los archivos de la versión en GitHub (kubebolt-mcp-linux-amd64,-linux-arm64,-darwin-amd64,-darwin-arm64,-windows-amd64.exe), renómbralo akubebolt-mcpy ponlo en tuPATH, o compílalo conmake build-mcp.
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
-
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.
-
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. -
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… | Token | Scopes |
|---|---|---|
| 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 red | Clave 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/mcp | Clave 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:
- Tarjetas de insights: diagnostican el insight y recomiendan una corrección
- Cabecera del detalle de un recurso: investiga el recurso; el prompt se adapta a la pestaña activa (Monitor, Logs, YAML…)
- Salud de los workloads en Overview: por qué un workload no está listo
- Eventos de tipo Warning: explican el evento y su impacto
- Flujos de tráfico en el Cluster Map: explican el flujo, los descartes y las tasas de error
- Paneles del dashboard: los mayores consumidores de CPU, rightsizing, despliegues recientes, focos de errores, mayor latencia, descartes de red y más, para todo el panel o para una sola fila
- Acciones estancadas: cuando una acción aprobada no converge, se le pregunta a Kobi por qué
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 entorno | Valor por defecto | Para qué sirve |
|---|---|---|
KUBEBOLT_AI_AUTO_COMPACT | true | Interruptor general de la compactación automática |
KUBEBOLT_AI_SESSION_BUDGET_TOKENS | ventana de contexto del modelo | Techo total. La compactación salta en presupuesto × umbral |
KUBEBOLT_AI_AUTO_COMPACT_THRESHOLD | 0.80 | Fracción del presupuesto en la que salta la compactación |
KUBEBOLT_AI_COMPACT_MODEL | claude-haiku-5-5 / gpt-4o-mini | Sustituye 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_TURNS | 3 | Turnos 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.