Modelos

10 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.
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.

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 en su fila.

• La primera conexión que añades a un proveedor queda marcada automáticamente.
• Para cambiarla, usa Hacer predeterminada en la fila 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ántos son y te pide a qué otra conexión pasan. Elige el destino en Pasar los agentes a y confirma con Mover y quitar; esos agentes se reinician para arrancar con la conexión nueva.

Si prefieres conservarla —por ejemplo para volver a usarla más adelante—, apágala en lugar de quitarla.

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, 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 segunda es menor que la primera, la comprobación sale en ámbar: la conexión funciona, pero las conversaciones largas se cortarán sin avisar al llegar a ese tope. Ollama sirve 4.096 tokens por defecto; se sube con OLLAMA_CONTEXT_LENGTH en la máquina donde corre.

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.

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.

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, guardar un cambio de conexión lo reinicia solo para que empiece a usarla.

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 puedes dejar que el agente herede el modelo predeterminado o asignarle uno concreto. La lista solo muestra los modelos que puede servir la conexión elegida. Cambiar el modelo requiere reiniciar el agente.

Opción	Cuándo conviene
Heredar	Cuando quieres aplicar una política común a la organización.
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.

Al cambiar el modelo, reinicia el agente antes de continuar. Si también cambias de conexión o de proveedor, el reinicio es imprescindible: la dirección y la credencial se fijan al arrancar el contenedor.

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. 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.