Reasoning / Extended Thinking
O formulário de adicionar modelo expõe um toggle Thinking / Reasoning (Off / Low / Medium / High / Custom) em Advanced settings. As opções disponíveis refletem o que o modelo realmente consegue fazer:- Um modelo que não faz reasoning fica travado em Off, com uma nota.
- Um modelo que só faz reasoning em certos níveis (ex.: medium/high do GPT-5) desabilita os inválidos.
- Um modelo que faz reasoning por padrão recebe Medium como um ponto de partida sensato.
Níveis predefinidos
Quando você escolhe Low / Medium / High, a Kodus traduz o nível automaticamente para o formato nativo de cada provedor:Variantes que sempre fazem reasoning (Kimi
k2p7-code/k3, GLM-5.3) fazem reasoning incondicionalmente e não podem ser colocadas em Off. O Test rejeita a configuração Off nelas.Custom JSON override
Escolher Custom no toggle Thinking / Reasoning revela uma textarea de JSON. Cole as opções do provedor diretamente — a Kodus as envolve automaticamente no namespace do provedor ativo. Você não precisa conhecer as regras de roteamento do Vercel AI SDK. Use quando:- Você precisa de um valor específico de
budgetTokenspara o Claude (em vez do mapeamento de esforço predefinido) - Você quer habilitar/desabilitar thinking por modelo em provedores compatíveis com OpenAI
- Você quer campos além de reasoning — caching, service tier, safety settings, tagging de
useretc. O override é mesclado emproviderOptions, então qualquer campo do adaptador passa - O provedor lançou um campo novo que a Kodus ainda não envolveu
Exemplos (cole direto — não precisa de namespace)
- Anthropic
- Google Gemini
- OpenAI
- OpenRouter
- OpenAI-compatible (Kimi, GLM, etc.)
Sobrescreva o budget de thinking do Claude para exatamente 20.000 tokens (o Claude 4.7 e posteriores rejeitam Habilite o prompt caching (exemplo sem reasoning):
budgetTokens; use effort neles):Indo no modo manual com namespaces (usuários avançados)
Se o seu JSON já começa com uma chave de namespace conhecida no nível superior — qualquer chave da tabela de mapeamento abaixo — a Kodus o deixa intocado. Útil se você quer misturar vários namespaces de provedores ou ser explícito:Pegadinhas
- Apenas um objeto JSON válido. Vírgulas faltando, vírgulas sobrando ou um valor que não seja objeto são rejeitados ao salvar.
- Precedência: o override em JSON substitui por completo o bloco de namespace do preset de esforço — se você sobrescrever
anthropic.thinkingmas esqueceranthropic.effort, esse campo não será enviado. O roteamento do OpenRouter (Pin providers / Allow fallbacks) é a única exceção: ele faz deep-merge com o seu override emopenrouter. - Provedor desconhecido = sem wrap. Se o seu provedor BYOK não está na tabela de namespaces acima, a Kodus repassa o JSON como está.
Temperature
A temperature fica em Advanced settings, e o campo se adapta às regras do modelo — definidas pelo provedor, não adivinhadas pelo formulário:O Test valida a temperature que você definiu contra essas regras e retorna um erro antes de salvar, então você nunca persiste um valor que o modelo não vai respeitar.
Simultaneidade e rate limits
O campomaxConcurrentRequests (Max concurrent requests, em Advanced settings) limita quantas requisições em andamento a Kodus envia ao seu provedor em paralelo. Na maioria das vezes, o padrão serve — mas planos de assinatura com limites de simultaneidade rígidos precisam que ele seja definido explicitamente.
Valores a definir
Quando ajustar
Aumente
- Você tem uma recarga de tier alto na Moonshot/OpenRouter e quer mais throughput em PRs grandes
- As revisões parecem serializadas em PRs com vários arquivos e você não vê 429
Diminua
- Você vê erros
429ouToo much concurrencynos logs de revisão - Seu provedor avisa sobre rate limits no painel
- Você quer conservar a janela do Coding Plan (5h/semanal) em mais PRs
Interação com o fallback. Quando o modelo de uma tarefa continua falhando com 429 e a Kody faz failover para o Fallback model, o
maxConcurrentRequests do próprio fallback é que vale. Definir um fallback generoso em um provedor diferente é uma boa forma de absorver picos quando seu modelo principal está em uma assinatura apertada.