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
budgetTokenspara 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 enproviderOptions, 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)
- Anthropic
- Google Gemini
- OpenAI
- OpenRouter
- OpenAI-compatible (Kimi, GLM, etc.)
Anula el presupuesto de pensamiento de Claude a exactamente 20,000 tokens (Claude 4.7 y posteriores rechazan Activa el caché de prompts (ejemplo sin razonamiento):
budgetTokens; usa effort ahí):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: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.thinkingpero olvidasanthropic.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 bajoopenrouter. - 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 campomaxConcurrentRequests (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
429oToo much concurrencyen 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
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.