Modelos

12 min de lectura

Kujira puede ejecutar el razonamiento de tus agentes mediante un proveedor cloud o con Ollama en tu propia infraestructura. Esta sección reúne las opciones, cómo se configuran y cómo asignarlas a cada agente.

Elegir dónde se ejecuta el modelo

Opción	Cuándo elegirla	Qué necesitas configurar
Proveedor cloud	Quieres empezar rápido y delegar la infraestructura en un proveedor.	La credencial del proveedor y el modelo que utilizará cada agente.
Gemini	Tienes saldo en Google y quieres usar sus modelos con una clave de AI Studio.	Una clave de API de Google AI Studio y el modelo de cada agente.
OpenAI	Tienes saldo en OpenAI y quieres usar sus modelos con una clave de API.	Una clave de API de OpenAI y el modelo de cada agente.
Grok	Tienes un plan de X o SuperGrok, o saldo en xAI, y quieres usar los modelos de Grok.	Tu suscripción o una clave de API de xAI, y el modelo de cada agente.
OpenRouter	Quieres probar o combinar modelos de varios proveedores con una sola clave y un solo saldo.	Una clave de OpenRouter y el modelo que llevará cada conexión.
Ollama	Necesitas que el procesamiento se ejecute en una máquina que controlas.	Una instancia de Ollama accesible desde el contenedor del agente y un modelo descargado.
vLLM	Tu motor habla la API de OpenAI: vLLM, LM Studio, llama.cpp o SGLang.	El motor accesible desde el contenedor del agente y el modelo que sirve.

Las conexiones de un proveedor

Ve a Ajustes > Modelos y abre el proveedor que quieras utilizar. Cada proveedor tiene una lista de conexiones, y todos funcionan igual: una conexión es una cuenta concreta o una máquina concreta, con su nombre y su credencial.

• Puedes tener varias conexiones del mismo proveedor. La suscripción del equipo y una clave API para facturar aparte son dos conexiones de Claude, no un duplicado. Lo mismo con un Ollama por ordenador.
• El nombre es obligatorio. Es lo único que distingue una conexión de otra, tanto en esta lista como en la ficha de cada agente. Escribe de qué cuenta o de qué máquina se trata: «Suscripción del equipo», «Clave de facturación», «Ollama del portátil».
• Cada conexión se puede encender o apagar, editar o quitar, y una de ellas es la predeterminada del proveedor.

Añadir una conexión

Abre el proveedor

En Ajustes > Modelos, selecciona el proveedor en la barra lateral. Verás su lista de conexiones y, junto al título, cuántas hay.

Pulsa «Añadir conexión»

Se abre el formulario. Necesitas permisos para editar los modelos de la organización.

Ponle nombre y elige el tipo

El nombre es obligatorio. El tipo —Suscripción o Clave API— decide a qué dirección apunta la conexión y cómo se autentica, así que se elige al crear y no se cambia después: para pasar de una modalidad a otra, añade otra conexión.

Añade la credencial y guarda

Pega la clave del proveedor. En Claude, además, puedes autorizar la suscripción desde el navegador sin pegar nada. Si la conexión es una máquina (Ollama), aquí indicas también su dirección, el modelo y la ventana de contexto. En OpenRouter indicas el modelo, y la ventana si fijas uno concreto.

La conexión predeterminada

La predeterminada es la que utilizan los agentes que no han elegido ninguna en concreto. Hay una por proveedor, marcada con una estrella en su cabecera.

• La primera conexión que añades a un proveedor queda marcada automáticamente.
• Para cambiarla, pulsa la estrella de la que quieras. Tiene que estar encendida y tener credencial: una conexión apagada o vacía no puede arrancar a nadie.
• Si apagas o quitas la predeterminada, Kujira asciende a otra conexión del mismo proveedor que sí pueda arrancar. Si no queda ninguna, el proveedor se queda sin predeterminada y sus agentes heredados no arrancarán hasta que elijas una.

Quitar una conexión

Si hay agentes que arrancan con esa conexión, Kujira no la quita sin más: te dice cuáles son (de los que no gestionas, solo cuántos) y te pide a qué otra conexión pasan. En Pasar los agentes a eliges, en un mismo desplegable, la conexión de destino —que puede ser de otro proveedor— y el modelo con el que van a trabajar. Confirma con Mover y quitar: esos agentes usan la conexión nueva desde su siguiente respuesta, sin reiniciarse.

Las conversaciones y los canales que la tenían elegida, también los de otras personas, pasan a Automático y siguen con la conexión de su agente. Kujira te avisa de cuántos son antes de confirmar.

Si prefieres conservarla —por ejemplo para volver a usarla más adelante—, apágala en lugar de quitarla. Apagarla, o quitarle la clave, deja sin responder a los agentes que la tienen elegida hasta que la vuelvas a encender, le pongas clave o los pases a otra conexión.

Credencial del modelo y credencial de una herramienta

La credencial de modelo permite que el agente use su proveedor de IA. Las claves de un CRM, una API o una integración se gestionan por separado en Credenciales.

Comprobar una conexión

Debajo del nombre de cada conexión tienes el botón Probar. Comprueba de una vez la credencial, la dirección a la que apunta y —cuando la conexión lleva su propio modelo— que ese modelo existe en el proveedor, sin esperar a que un agente falle en su primer turno.

La comprobación no consume tokens: Kujira pide el catálogo de modelos del proveedor o un recuento, nunca envía una conversación.

Resultado	Qué significa
Funciona	La credencial es válida y la dirección responde.
El proveedor rechaza la credencial	La clave ya no vale: se ha revocado, ha caducado o es de otra cuenta. Sustitúyela y vuelve a probar.
No se llega a la dirección	Nadie responde ahí. Revisa que esté bien escrita y que se pueda alcanzar desde donde sale la comprobación.
El modelo no está en el proveedor	La credencial funciona, pero el modelo que indica la conexión no existe en su catálogo. El agente no arrancaría.
El proveedor está limitando las peticiones	Es suyo, no tuyo. Espera un momento y vuelve a probar.

Necesitas los mismos permisos que para cambiar la credencial, y cada comprobación queda anotada en el Registro de actividad. Si pruebas dos veces seguidas, el botón te indica cuántos segundos quedan: cada pulsación es una llamada al proveedor.

Cuando la comprobación sale de tu servidor

Kujira solo llama a direcciones de internet. Estas conexiones no encajan ahí, así que la comprobación la hace el supervisor de tu servidor en vez del panel:

• Ollama, vLLM y cualquier conexión declarada en red privada. Esa dirección es tuya, y Kujira no la llama nunca desde fuera.
• Una suscripción de Claude. Su autorización solo se utiliza desde tu propio servidor, igual que cuando la conectas o la retiras.

El botón es el mismo y está en el mismo sitio. La diferencia es que necesita un servidor tuyo encendido: si ninguno lo está, la comprobación te lo dice en vez de hablarte de la credencial.

Si tienes varios servidores, eliges desde cuál probar. No es un detalle: una conexión no está atada a un servidor, y una dirección como host.docker.internal significa una máquina distinta en cada uno. El desplegable aparece junto al botón cuando hay más de uno.

Resultado	Qué significa
Ninguno de tus servidores está conectado	La comprobación sale de tu servidor y no hay ninguno en marcha. Enciéndelo y vuelve a probar.
El supervisor de ese servidor es anterior a esta comprobación	Actualízalo ejecutando sudo kujira update en ese servidor y vuelve a probar. Ver Actualizar el supervisor.

Comprobar un motor local

Al probar una conexión de Ollama, Kujira te dice además qué modelos tiene descargados esa máquina y las dos cifras de la ventana de contexto:

• Ventana del modelo — lo máximo que ese modelo admite.
• Ventana que sirve — lo que tu servidor está sirviendo de verdad.

Cuando la que sirve es 64k o menos, la comprobación sale en rojo: esa conexión no vale para un agente, porque al modelo no le queda sitio para trabajar. Es lo que pasa con un Ollama recién instalado, que sirve 4.096 tokens; se sube con OLLAMA_CONTEXT_LENGTH en la máquina donde corre.

Cuando sirve más de 64k pero menos de lo que el modelo admite, sale en ámbar: la conexión funciona, pero las conversaciones largas se cortarán sin avisar al llegar a ese tope.

Kujira no cambia esa cifra por su cuenta. Prometerle al agente una ventana que el motor no sirve no falla al arrancar: falla a mitad de conversación, que es mucho peor de diagnosticar.

Si el modelo que indica la conexión no está descargado, la comprobación lo dice y te enseña los que sí hay.

Probar no es encender

Una conexión apagada también se puede probar, que es lo normal antes de encenderla. Que la prueba salga bien no la pone en marcha.

Guías de configuración

Claude

Conecta una suscripción Pro o Max, o crea una clave API de Anthropic para pago por uso.

Kimi

Configura un plan de Kimi Code o una clave de pago por token sin mezclar sus credenciales.

MiniMax

Usa un Token Plan o una API key y conoce la diferencia entre ambas modalidades.

Gemini

Conecta los modelos de Google con una clave de AI Studio.

OpenAI

Conecta los modelos de OpenAI con una clave de API.

Grok

Conecta los modelos de Grok, de xAI, con tu suscripción o con una clave de API.

OpenRouter

Usa modelos de muchos proveedores con una sola clave, o deja que OpenRouter elija el modelo en cada petición.

Ollama

Ejecuta modelos locales en una máquina de tu infraestructura y conéctalos a Kujira.

vLLM

Conecta vLLM, LM Studio, llama.cpp, SGLang o cualquier motor que hable la API de OpenAI.

Elegir la conexión de un agente

En Configuración > Modelo del agente, la sección Conexión va antes que el modelo porque decide qué modelos puede usar: una conexión de Claude solo sirve modelos de Claude. El desplegable ofrece:

Opción	Qué significa
Heredar de la organización	Usa la conexión predeterminada del proveedor que corresponda a su modelo. Si mañana cambias la predeterminada, este agente cambia con ella.
Una conexión de la organización	Arranca siempre con ésa, por su nombre, aunque la organización cambie su predeterminada. Es lo que necesitas cuando tienes varias del mismo proveedor y quieres separar el gasto o apuntar a una máquina en particular.
Una conexión propia	Aparece en el grupo Sólo de este agente. Es una cuenta que solo puede usar este agente: no sale en Ajustes > Modelos y no la hereda nadie más.

Si el agente está en marcha, empieza a usar la conexión nueva en su siguiente respuesta, sin reiniciarse.

Elige por nombre, no por modalidad

Con varias conexiones del mismo proveedor, «Claude» no dice cuál. Por eso el desplegable enseña nombres: la conexión ya lleva dentro su modalidad, su dirección y su credencial.

Conexiones propias de un agente

Cuando un agente necesita una cuenta que no compartes con el resto —la suscripción personal de alguien, una clave de pruebas—, pulsa Conexiones propias junto al desplegable. Desde ahí puedes añadirlas, editarlas, apagarlas y quitarlas con los mismos campos que en Ajustes > Modelos, salvo la opción de predeterminada: una conexión que solo usa un agente no puede ser la que heredan los demás.

• Basta con poder editar el agente. Indicar una dirección propia, en cambio, requiere permisos para editar los modelos de la organización.
• En Claude puedes conectar la suscripción desde el navegador, igual que en Ajustes > Modelos.
• No puedes quitar la conexión con la que arranca el agente: elige antes otra en el desplegable.
• Cada agente admite hasta diez.

Elegir el modelo de un agente

Desde Configuración > Modelo eliges el modelo del agente. Todo agente necesita uno: sin modelo no se crea ni arranca. La lista solo muestra los modelos que puede servir la conexión elegida. El cambio se aplica en la siguiente respuesta de cada conversación, sin reiniciar el agente y sin que ninguna pierda su hilo.

Las conversaciones a las que les fijaste un modelo propio lo conservan. Si quieres que todas pasen al modelo del agente, marca Aplicar a todo, junto al título Modelo, antes de guardar: las que tenían modelo o conexión propios vuelven a usar los del agente desde su siguiente respuesta. Puedes marcarla sin cambiar el modelo, para devolverlas todas al que el agente ya tiene. Como cualquier cambio de modelo, esas conversaciones pierden la caché de contexto.

Opción	Cuándo conviene
Modelo por familia	Cuando prefieres utilizar siempre la versión recomendada más reciente de una familia.
Versión concreta	Cuando necesitas estabilidad para un flujo que ya has validado.

Si el agente tiene fijada una conexión que trae su propio modelo —el caso de Ollama y OpenRouter—, manda ese modelo.

Cambiar de conexión o de proveedor con el agente en marcha no lo reinicia. La credencial anterior sigue en su entorno hasta que lo reinicies tú. Si se ha filtrado una clave, revócala en el proveedor y reinicia los agentes que la usaban: cambiarla o quitarla en Kujira no basta.

Credencial compartida o propia

De forma predeterminada, un agente usa una credencial de su organización. Es la opción adecuada en la mayoría de casos: centraliza la facturación y reduce la configuración duplicada.

Asigna una credencial propia al agente únicamente cuando deba utilizar una cuenta distinta que no quieras compartir con el resto. Para separar el gasto de un cliente o aislar un entorno de prueba suele bastar con añadir otra conexión a la organización y fijársela a ese agente, sin credenciales sueltas que mantener.

Una política clara evita sorpresas

Si todos los agentes comparten proveedor y presupuesto, deja una sola conexión marcada como predeterminada y los agentes en Heredar de la organización. Reserva las excepciones para casos que realmente requieran aislamiento.

Elegir con criterio

Trabajo complejo

Prioriza un modelo más capaz cuando el agente deba analizar, planificar o tomar decisiones con más matiz.

Tareas repetitivas

Valora modelos más rápidos o económicos para clasificar, resumir o ejecutar flujos predecibles.

Ollama

Si necesitas ejecutar el modelo en tu propia infraestructura, revisa la integración experimental con Ollama.

Vigilar el consumo

El coste y los límites dependen de la modalidad del proveedor y del modelo elegido. Establece límites a nivel de organización o de agente y revísalos periódicamente en Consumo y límites.

La vista Estadísticas permite analizar el consumo de cada agente con detalle: filtra por periodo, granularidad y canal, agrupa los datos por agente y revisa la evolución en el tiempo. También separa los tokens de entrada, salida y caché para entender qué está impulsando el gasto estimado.