Pular para o conteúdo principal
Estas configurações ficam no card Advanced settings do formulário de adicionar ou editar um modelo na página AI providers.

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 budgetTokens para 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 user etc. O override é mesclado em providerOptions, 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)

Sobrescreva o budget de thinking do Claude para exatamente 20.000 tokens (o Claude 4.7 e posteriores rejeitam budgetTokens; use effort neles):
Habilite o prompt caching (exemplo sem reasoning):

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:
Por baixo dos panos, estes são os mapeamentos de namespace que a Kodus usa:

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.thinking mas esquecer anthropic.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 em openrouter.
  • 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 campo maxConcurrentRequests (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 429 ou Too much concurrency nos 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
Simultaneidade vs. RPM vs. TPM. maxConcurrentRequests só limita requisições paralelas em andamento. Muitos provedores também aplicam limites separados de RPM (requisições por minuto) e TPM (tokens por minuto). Se você está atingindo RPM/TPM enquanto a simultaneidade parece boa, a solução geralmente é subir de tier ou distribuir a carga ao longo do tempo — não mudar maxConcurrentRequests.
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.