Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Parametri di richiesta

Lezione 3 di 16 Aggiornata il 3 novembre 2026 Sviluppatore
In questa pagina
  1. Controllo del comportamento del modello
  2. Parametri di generazione
  3. Parametri di conversazione
  4. Parametri degli strumenti
  5. Riepilogo dei parametri
  6. Punti chiave

Aggiornato il 3 novembre 2026. Basato sul riferimento delle API Responses e sulle best practice di xAI: temperatura consigliata 0.7, con limite massimo a 1; top_p impostato di default a 0.95; max_output_tokens limitato alla risposta visibile (128.000 di default, ragionamento escluso); lo sforzo di ragionamento è riservato ai modelli da grok-4.5 a 4.7. Fonti: API Responses · Best practices.

Controllo del comportamento del modello

Oltre a model, input e instructions, le API Responses offrono numerosi parametri per affinare il comportamento di Grok. Comprendere questi parametri ti permette di ottenere risposte più pertinenti, più brevi o più creative in base alle tue esigenze.

Parametri di generazione

temperature

Controlla la casualità delle risposte. L’API accetta valori da 0 a 2, ma qualsiasi valore superiore a 1 viene campionato come se fosse 1.

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

Le best practice di xAI sono chiare: imposta temperature a 0.7 e non discostartene troppo, perché i modelli Grok reagiscono male ad altre impostazioni di campionamento. Per ottenere un tono più fattuale o creativo, modifica il prompt piuttosto che la temperatura.

top_p

Campionamento del nucleo (nucleus sampling). I modelli testuali attuali hanno un default di 0.95 e qualsiasi valore superiore al default del modello viene ridotto a questo.

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

Con top_p: 0.95, il modello considera solo i token che rappresentano il 95% della probabilità. Il riferimento API ripete il classico consiglio di regolare solo uno dei due parametri; le best practice di xAI richiedono invece di impostare esplicitamente entrambi, a 0.7 e 0.95, in ogni richiesta.

max_output_tokens

Limita il numero di token nella risposta visibile; il ragionamento e le chiamate di funzione non vengono conteggiati e il valore predefinito è 128.000 token:

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

Per i modelli di ragionamento, è lo sforzo di ragionamento (reasoning effort), e non questo limite, a governare la riflessione interna. Una risposta interrotta dal limite viene segnalata dallo stato incomplete.

reasoning

Per i modelli che supportano il ragionamento, puoi regolare lo sforzo:

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

I valori possibili sono low, medium e high (default), più xhigh su grok-4.6 e grok-4.7; il parametro si applica da grok-4.5 a 4.7, mentre grok-4.20-0309-reasoning non lo accetta. Uno sforzo elevato consuma più token ed è adatto a problemi complessi.

Parametri di conversazione

store

Determina se la risposta viene memorizzata lato server:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this contract.",
  "store": false
}
  • true: la risposta viene archiviata per 30 giorni, recuperabile tramite GET e utilizzabile con previous_response_id
  • false: la risposta non viene persistita (modalità privata)

previous_response_id

Collega una nuova richiesta a una conversazione esistente (dettagliato nella lezione 5).

user

Identificatore dell’utente finale, utile per il tracciamento e la moderazione:

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

Parametri degli strumenti

tools, tool_choice, parallel_tool_calls, max_turns

Questi parametri controllano l’uso degli strumenti (web_search, code_interpreter, funzioni personalizzate). Sono trattati in dettaglio nella sezione “Strumenti” (lezioni 9-12).

Riepilogo dei parametri

ParametroTipoDefaultUtilizzo
modelstringrichiestoIdentificatore del modello
inputstring/arrayrichiestoPrompt dell’utente
instructionsstringnullPrompt di sistema
temperaturenumber—0.7 consigliato; limite a 1
top_pnumber0.95Campionamento del nucleo
max_output_tokensinteger128.000Limite risposta visibile
reasoningobjectnullSforzo di ragionamento
storebooleannullPersistenza di 30 giorni
streambooleanfalseStreaming SSE
userstringnullID utente finale

Punti chiave

  • xAI consiglia temperature a 0.7 e top_p a 0.95, da impostare esplicitamente
  • max_output_tokens limita solo la risposta visibile, escludendo il ragionamento
  • store: true persiste la risposta per 30 giorni per il concatenamento delle conversazioni
  • reasoning.effort ti permette di scalare la riflessione del modello in base alla complessità del compito
  • Il parametro user aiuta nel tracciamento e nella moderazione da parte di xAI