Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Raciocínio vs. Sem Raciocínio

Aula 12 de 14 Atualizada a 3 de novembro de 2026 Iniciante
Nesta página
  1. Duas Abordagens Fundamentalmente Diferentes
  2. Como Funciona o Raciocínio
  3. Parâmetros Proibidos no Modo de Raciocínio
  4. Quando Utilizar o Raciocínio
  5. Quando Utilizar o Modo Sem Raciocínio
  6. Estratégia de Encaminhamento
  7. O Caso Especial de max_completion_tokens
  8. Pontos-chave

Atualizado a 3 de novembro de 2026 com base na referência da API xAI e no guia Reasoning: max_completion_tokens limita apenas a resposta visível, não o raciocínio; logprobs é ignorado a partir do Grok 4.20; o raciocínio ajustável aplica-se ao grok-4.5, 4.6 e 4.7. Fontes: Chat Completions · Reasoning.

Duas Abordagens Fundamentalmente Diferentes

A gama Grok oferece duas abordagens para o raciocínio: a geração do grok-4.20 apresenta duas variantes distintas — com raciocínio e sem raciocínio — enquanto o grok-4.5, grok-4.6 e grok-4.7 unificam-nas num raciocínio ajustável através de um parâmetro de esforço, que não pode ser desativado. Esta escolha não é cosmética; altera fundamentalmente o comportamento, as capacidades, o custo e as restrições da API do modelo. Selecionar a variante adequada para cada tarefa é uma competência essencial.

Como Funciona o Raciocínio

Quando utiliza uma variante com raciocínio, o modelo executa um processo de pensamento interno antes de produzir a sua resposta. Decompõe o problema, explora diferentes abordagens, verifica a sua lógica e constrói a resposta passo a passo.

Na xAI, este raciocínio está «encriptado» para os modelos Grok 4 e superiores: não é possível ler as etapas intermédias em texto simples. No entanto, pode:

  • Recuperar o conteúdo encriptado através de include=["reasoning.encrypted_content"] para o reinjetar em pedidos subsequentes
  • Verificar a contagem de tokens de raciocínio em usage.completion_tokens_details.reasoning_tokens

O raciocínio consome tokens adicionais, faturados à tarifa de saída. Um pedido com raciocínio custa, portanto, mais do que um pedido idêntico sem raciocínio; a diferença depende da tarefa e do esforço, pelo que deve medi-la nos seus próprios dados.

Parâmetros Proibidos no Modo de Raciocínio

Esta é uma armadilha comum durante a migração. As variantes com raciocínio não suportam certos parâmetros frequentes no modo sem raciocínio:

Parâmetro Sem Raciocínio Com Raciocínio
presencePenalty Suportado Proibido (erro)
frequencyPenalty Suportado Proibido (erro)
stop Suportado Proibido (erro)
logprobs Ignorado a partir do Grok 4.20 Ignorado
max_completion_tokens Suportado Suportado (apenas resposta visível)

Se passar presencePenalty, frequencyPenalty ou stop para uma variante com raciocínio, a API devolve um erro. Certifique-se de remover estes parâmetros dos seus pedidos ao mudar para o modo de raciocínio.

Quando Utilizar o Raciocínio

O raciocínio agrega valor claro em certas categorias de tarefas:

  • Matemática e lógica formal — resolução de equações, demonstrações, otimização
  • Análise de código complexa — depuração com interdependências, auditorias de segurança
  • Perguntas em várias etapas — problemas que exigem construir raciocínios em múltiplas fases
  • Decisões nuanceadas — avaliação de prós e contras, análise comparativa aprofundada
  • Expertise quantitativa — estatística, modelação financeira, análise de dados

Quando Utilizar o Modo Sem Raciocínio

O modo sem raciocínio é preferível quando a tarefa não exige reflexão profunda:

  • Redação e resumo — o modelo não precisa de «pensar» para escrever
  • Classificação e etiquetagem — categorização rápida de conteúdos
  • Extração de informação — estruturação de dados a partir de texto bruto
  • Tradução — o modelo sabe traduzir sem raciocínio explícito
  • Conversa simples — chatbots, FAQs, suporte de primeiro nível
  • Geração de conteúdos — e-mails, descrições, textos de marketing

Estratégia de Encaminhamento

Em produção, a estratégia ótima consiste em encaminhar dinamicamente os pedidos para a variante adequada:

  1. Analisar o pedido — envolve cálculo, análise ou processamento simples?
  2. Encaminhamento padrão para sem raciocínio — é mais rápido e barato
  3. Mudar para raciocínio quando o pedido envolver raciocínio em várias etapas
  4. Monitorizar resultados — ajustar os critérios de encaminhamento com base na qualidade observada

Esta abordagem permite-lhe beneficiar da potência do raciocínio quando necessário, sem pagar a sobretaxa quando esta é supérflua.

O Caso Especial de max_completion_tokens

De acordo com a referência da API xAI, max_completion_tokens aplica-se apenas à resposta visível: os tokens de raciocínio e as chamadas de função não contam para este limite, e o valor padrão é de 128.000 tokens. Defina este limite com base no comprimento esperado da resposta e ajuste o raciocínio através do esforço (reasoning_effort) no grok-4.5, 4.6 e 4.7.

Pontos-chave

  • As variantes com raciocínio adicionam uma fase de pensamento interno antes de responder
  • O raciocínio está encriptado (não visível em texto simples); no entanto, o grok-4.7 expõe um resumo, consultável via streaming
  • presencePenalty, frequencyPenalty e stop são proibidos no modo de raciocínio
  • O raciocínio custa 2 a 5 vezes mais do que o modo sem raciocínio
  • Utilize o raciocínio para matemática, lógica e problemas em várias etapas
  • Utilize o modo sem raciocínio para redação, classificação e extração