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

Parâmetros do Pedido

Aula 3 de 16 Atualizada a 3 de novembro de 2026 Programador
Nesta página
  1. Controlar o comportamento do modelo
  2. Parâmetros de geração
  3. Parâmetros de conversação
  4. Parâmetros de ferramentas
  5. Resumo dos parâmetros
  6. Pontos-chave

Atualizado em 3 de novembro de 2026. Com base na referência da API de Respostas e nas melhores práticas da xAI: temperatura recomendada de 0,7, limitada a 1; top_p 0,95 por predefinição; max_output_tokens limitado à resposta visível (128.000 por predefinição, raciocínio excluído); esforço de raciocínio reservado ao grok-4.5 até 4.7. Fontes: API de Respostas · Melhores práticas.

Controlar o comportamento do modelo

Para além de model, input e instructions, a API de Respostas oferece numerosos parâmetros para afinar o comportamento do Grok. Compreender estes parâmetros permite obter respostas mais relevantes, mais curtas ou mais criativas, consoante as suas necessidades.

Parâmetros de geração

temperature

Controla a aleatoriedade das respostas. A API aceita valores de 0 a 2, mas qualquer valor acima de 1 é amostrado como 1.

{
  "model": "grok-4.7",
  "input": "Write a slogan for a bakery.",
  "temperature": 0.7,
  "top_p": 0.95
}

As melhores práticas da xAI são claras: defina temperature como 0,7 e não se afaste muito desse valor, pois os modelos Grok reagem mal a outras configurações de amostragem. Para um tom mais factual ou criativo, ajuste o prompt em vez da temperatura.

top_p

Amostragem de núcleo (nucleus sampling). Os modelos de texto atuais têm 0,95 como predefinição, e qualquer valor superior ao padrão do modelo é reduzido a esse limite.

{
  "model": "grok-4.7",
  "input": "Summarize this article.",
  "top_p": 0.95
}

Com top_p: 0.95, o modelo considera apenas os tokens que representam 95% da probabilidade. A referência da API repete o conselho clássico de ajustar apenas um dos dois parâmetros; no entanto, as melhores práticas da xAI exigem a definição explícita de ambos, para 0,7 e 0,95, em cada pedido.

max_output_tokens

Limita o número de tokens na resposta visível; o raciocínio e as chamadas de função não contam, e o valor predefinido é de 128.000 tokens:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Explain general relativity.",
  "max_output_tokens": 500
}

Para modelos de raciocínio, é o esforço de raciocínio, e não este limite, que governa a reflexão interna. Uma resposta cortada pelo limite é sinalizada com o estado incomplete.

reasoning

Para modelos que suportam raciocínio, pode ajustar o esforço:

{
  "model": "grok-4.7",
  "input": "Solve this logic problem.",
  "reasoning": {"effort": "high"}
}

Os valores possíveis são low, medium e high (predefinição), além de xhigh no grok-4.6 e grok-4.7; o parâmetro aplica-se ao grok-4.5 até 4.7, e o grok-4.20-0309-reasoning não o aceita. Um esforço elevado consome mais tokens e é adequado para problemas complexos.

Parâmetros de conversação

store

Determina se a resposta é armazenada no lado do servidor:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this contract.",
  "store": false
}
  • true: resposta armazenada por 30 dias, recuperável via GET, utilizável com previous_response_id
  • false: resposta não persistida (modo privado)

previous_response_id

Encadeia um novo pedido a uma conversação existente (detalhado na lição 5).

user

Identificador do utilizador final, útil para rastreio e moderação:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Hello",
  "user": "user-12345"
}

Parâmetros de ferramentas

tools, tool_choice, parallel_tool_calls, max_turns

Estes parâmetros controlam a utilização de ferramentas (web_search, code_interpreter, funções personalizadas). São abordados em detalhe na secção «Ferramentas» (lições 9 a 12).

Resumo dos parâmetros

ParâmetroTipoPredefiniçãoUtilização
modelstringobrigatórioIdentificador do modelo
inputstring/arrayobrigatórioPrompt do utilizador
instructionsstringnullPrompt do sistema
temperaturenumber—0,7 recomendado; limitado a 1
top_pnumber0,95Amostragem de núcleo
max_output_tokensinteger128.000Limite da resposta visível
reasoningobjectnullEsforço de raciocínio
storebooleannullPersistência de 30 dias
streambooleanfalseStreaming SSE
userstringnullID do utilizador final

Pontos-chave

  • A xAI recomenda temperature em 0,7 e top_p em 0,95, definidos explicitamente
  • max_output_tokens limita apenas a resposta visível, excluindo o raciocínio
  • store: true persiste a resposta por 30 dias para encadeamento de conversação
  • reasoning.effort permite escalar a reflexão do modelo com base na complexidade da tarefa
  • O parâmetro user ajuda no rastreio e na moderação do lado da xAI