Modelos y proveedores

jAIgent habla con diez proveedores y decide cuál usar según lo que le pidas. Tres mecanismos lo gobiernan: auto, free y failover.

Auto

--model auto dimensiona el modelo al trabajo. Un saludo no cuesta un refactor.

jaigent -m auto "hola"                                    # → un modelo barato
jaigent -m auto "refactoriza este paquete y añade tests"  # → uno capaz
jaigent settings set model auto
jaigent route "¿por qué esto deadlockea bajo carga?"      # preview, no gasta nada

El enrutador puntúa longitud, bloques de código, fraseo multipaso y palabras clave de dificultad, y clasifica en simple, estándar o complejo.

Free

--model free recorre los proveedores que de verdad puedes usar y elige un modelo sin coste. El orden es Ollama primero, luego Groq, Gemini y los identificadores :free de OpenRouter.

jaigent -m free "resume README.md"
jaigent models --free
jaigent route --free "refactoriza esto"
jaigent settings set model free

Sigues necesitando una clave para Groq, Gemini u OpenRouter. Ollama no necesita ninguna.

Failover

Un 503 o un límite de tasa reintenta con backoff y jitter, y después cae al siguiente proveedor que tenga clave propia.

$ jaigent "resume el changelog"
  openai is overloaded — retrying…
  Continuing on anthropic…

Las reglas exactas:

jaigent doctor muestra la cadena completa. Se ajusta con --retries N o se desactiva con JAIGENT_FAILOVER=0. Un Ollama local cuenta como respaldo sin clave. Cambiar con /provider nunca reutiliza la clave del backend anterior.

Proveedores admitidos

jaigent providers imprime esta tabla desde tu propia instalación, con lo que tienes configurado. jaigent models lista el catálogo y jaigent route previsualiza qué elegiría el enrutador sin gastar nada.

Presupuesto de pasos y temperatura

El bucle tiene un presupuesto de pasos por turno: JAIGENT_MAX_STEPS, por defecto 12. Cuando se agota, se hace una última llamada sin herramientas, forzando una respuesta en vez de dejar el turno a medias.

Tope de gasto

Tres controles independientes. Ninguno está activado hasta que lo digas, salvo las skills integradas, que son solo texto de prompt.

jaigent settings set budget 0.50       # tope duro en USD para una ejecución
jaigent settings set auto_compact true # pliega turnos viejos cuando crece el historial
jaigent settings set memory true       # remember / recall + .jaigent/memory.md

Tope de gasto. budget se aplica en el bucle del agente después de cada respuesta del modelo. Cuando la estimación alcanza el tope, la ejecución se detiene y el pie dice spend cap reached. La skill integrada spend-cap es la parte blanda: gastar menos antes de que maten la ejecución. 0 lo desactiva.

Compact. /compact en el chat pliega los turnos viejos en un resumen sin otra llamada al modelo. auto_compact hace lo mismo cuando el historial pasa de veinte mensajes. La skill integrada compact le dice al modelo qué conservar.

Memoria. Apagada hasta que la enciendes. Entonces el modelo recibe remember y recall, y las notas permanentes viven en .jaigent/memory.md dentro del espacio de trabajo. Mientras el ajuste esté apagado no se escribe ni se envía nada.