Saltar al contenido principal
Estos ajustes están en la tarjeta Advanced settings del formulario para agregar o editar un modelo en la página AI providers.

Razonamiento / Pensamiento extendido

El formulario para agregar un modelo expone un selector Thinking / Reasoning (Off / Low / Medium / High / Custom) en Advanced settings. Las opciones disponibles reflejan lo que el modelo realmente puede hacer:
  • Un modelo que no puede razonar queda bloqueado en Off con una nota.
  • Un modelo que solo razona en ciertos niveles (p. ej., medium/high de GPT-5) deshabilita los no válidos.
  • Un modelo que razona por defecto recibe Medium como punto de partida razonable.

Niveles predefinidos

Cuando eliges Low / Medium / High, Kodus traduce el nivel al formato nativo de cada proveedor automáticamente:
Las variantes que siempre razonan (Kimi k2p7-code/k3, GLM-5.3) razonan incondicionalmente y no se pueden poner en Off. Test rechaza un ajuste Off en ellas.

Anulación con JSON personalizado

Al elegir Custom en el selector Thinking / Reasoning aparece un área de texto JSON. Pega directamente las opciones del proveedor: Kodus las envuelve automáticamente bajo el espacio de nombres del proveedor activo. No necesitas conocer las reglas de enrutamiento del Vercel AI SDK. Úsalo cuando:
  • Necesites un valor específico de budgetTokens para Claude (en lugar de la asignación de esfuerzo predefinida)
  • Quieras activar o desactivar el pensamiento por modelo en proveedores compatibles con OpenAI
  • Quieras campos más allá del razonamiento: caché, nivel de servicio, ajustes de seguridad, etiquetado con user, etc. La anulación se fusiona en providerOptions, así que cualquier campo del adaptador pasa
  • El proveedor lance un campo nuevo que Kodus todavía no ha envuelto

Ejemplos (pega directamente, sin necesidad de espacio de nombres)

Anula el presupuesto de pensamiento de Claude a exactamente 20,000 tokens (Claude 4.7 y posteriores rechazan budgetTokens; usa effort ahí):
Activa el caché de prompts (ejemplo sin razonamiento):

Ir manual con espacios de nombres (usuarios avanzados)

Si tu JSON ya empieza con una clave de espacio de nombres conocida en el nivel superior (cualquier clave de la tabla de asignación de abajo), Kodus la deja intacta. Es útil si quieres mezclar varios espacios de nombres de proveedor o ser explícito:
Por debajo, estas son las asignaciones de espacios de nombres que usa Kodus:

Cosas a tener en cuenta

  • Solo un objeto JSON válido. Las comas faltantes, las comas finales o un valor que no sea un objeto se rechazan al guardar.
  • Precedencia: la anulación con JSON reemplaza por completo el bloque del espacio de nombres del nivel de esfuerzo predefinido: si anulas anthropic.thinking pero olvidas anthropic.effort, ese campo no se enviará. El enrutamiento de OpenRouter (Pin providers / Allow fallbacks) es la única excepción: se fusiona en profundidad con tu anulación bajo openrouter.
  • Proveedor desconocido = sin envoltura. Si tu proveedor BYOK no está en la tabla de espacios de nombres de arriba, Kodus pasa el JSON tal cual.

Temperatura

La temperatura está en Advanced settings, y el campo se adapta a las reglas del modelo, definidas por el proveedor y no adivinadas por el formulario:
Test valida la temperatura que defines contra estas reglas y devuelve un error antes de guardar, para que nunca persistas un valor que el modelo no respetará.

Concurrencia y límites de velocidad

El campo maxConcurrentRequests (Max concurrent requests, en Advanced settings) limita cuántas solicitudes en curso envía Kodus a tu proveedor en paralelo. La mayoría de las veces el valor por defecto está bien, pero los planes de suscripción con topes estrictos de concurrencia necesitan que lo definas explícitamente.

Valores a definir

Cuándo ajustarlo

Súbelo

  • Tienes una recarga de nivel alto en Moonshot/OpenRouter y quieres mayor rendimiento en PRs grandes
  • Las revisiones se sienten serializadas en PRs con varios archivos y no ves errores 429

Bájalo

  • Ves errores 429 o Too much concurrency en los registros de revisión
  • Tu proveedor advierte sobre límites de velocidad en el panel
  • Quieres conservar la ventana del Coding Plan (5 h/semanal) para más PRs
Concurrencia vs. RPM vs. TPM. maxConcurrentRequests solo limita las solicitudes en curso en paralelo. Muchos proveedores también aplican límites separados de RPM (solicitudes por minuto) y TPM (tokens por minuto). Si alcanzas RPM/TPM mientras la concurrencia se ve bien, la solución suele ser mejorar tu nivel o repartir la carga en el tiempo, no cambiar maxConcurrentRequests.
Interacción con el respaldo. Cuando el modelo de una tarea sigue fallando con 429 y Kody conmuta al Fallback model, se aplica el maxConcurrentRequests propio del respaldo. Definir un respaldo generoso en otro proveedor es una buena forma de absorber picos cuando tu modelo principal está en una suscripción ajustada.