Ragionamento vs Non-ragionamento
In questa pagina
Aggiornato il 3 novembre 2026 in base al riferimento API di xAI e alla guida sul Ragionamento:
max_completion_tokenslimita solo la risposta visibile, non il ragionamento;logprobsviene ignorato da Grok 4.20 in poi; il ragionamento regolabile si applica a grok-4.5, 4.6 e 4.7. Fonti: Chat Completions · Reasoning.
Due approcci fondamentalmente diversi
La gamma Grok offre due approcci al ragionamento: la generazione di grok-4.20 è disponibile in due varianti distinte, con ragionamento e senza ragionamento, mentre grok-4.5, grok-4.6 e grok-4.7 le unificano in un ragionamento regolabile tramite un parametro di sforzo, che non può essere disattivato. Questa scelta non è cosmetica: modifica radicalmente il comportamento del modello, le sue capacità, i costi e i vincoli API. Scegliere la variante giusta per ogni compito è una competenza chiave.
Come funziona il ragionamento
Quando utilizzi una variante con ragionamento, il modello avvia un processo di pensiero interno prima di produrre la risposta. Scompone il problema, esplora diversi approcci, verifica la propria logica e costruisce la risposta passo dopo passo.
Presso xAI, questo ragionamento è “crittografato” per i modelli Grok 4 e superiori: non puoi leggere i passaggi intermedi in testo semplice. Tuttavia, puoi:
- Recuperare il contenuto crittografato tramite
include=["reasoning.encrypted_content"]per reiniettarlo nelle richieste successive - Controllare il conteggio dei token di ragionamento in
usage.completion_tokens_details.reasoning_tokens
Il ragionamento consuma token aggiuntivi, fatturati alla tariffa di output. Una richiesta con ragionamento costa quindi più di una richiesta identica senza ragionamento; il divario dipende dal compito e dallo sforzo, quindi misuralo sui tuoi dati.
Parametri vietati in modalità ragionamento
Questo è un errore comune durante la migrazione. Le varianti con ragionamento non supportano alcuni parametri frequenti nella modalità senza ragionamento:
| Parametro | Senza ragionamento | Con ragionamento |
|---|---|---|
| presencePenalty | Supportato | Vietato (errore) |
| frequencyPenalty | Supportato | Vietato (errore) |
| stop | Supportato | Vietato (errore) |
| logprobs | Ignorato da Grok 4.20 in poi | Ignorato |
| max_completion_tokens | Supportato | Supportato (solo risposta visibile) |
Se passi presencePenalty, frequencyPenalty o stop a una variante con ragionamento, l’API restituisce un errore. Assicurati di rimuovere questi parametri dalle tue richieste quando passi alla modalità con ragionamento.
Quando usare il ragionamento
Il ragionamento aggiunge un valore chiaro per alcune categorie di compiti:
- Matematica e logica formale — risoluzione di equazioni, dimostrazioni, ottimizzazione
- Analisi complessa del codice — debug con interdipendenze, audit di sicurezza
- Domande multi-step — problemi che richiedono di costruire un ragionamento in più fasi
- Decisioni sfumate — valutazione di pro e contro, analisi comparativa approfondita
- Competenze quantitative — statistica, modellazione finanziaria, analisi dati
Quando usare il non-ragionamento
Il non-ragionamento è preferibile quando il compito non richiede una riflessione profonda:
- Scrittura e riassunto — il modello non ha bisogno di “pensare” per scrivere
- Classificazione ed etichettatura — categorizzazione rapida dei contenuti
- Estrazione di informazioni — strutturazione di dati da testo grezzo
- Traduzione — il modello sa tradurre senza un ragionamento esplicito
- Conversazione semplice — chatbot, FAQ, supporto di primo livello
- Generazione di contenuti — email, descrizioni, copy marketing
Strategia di routing
In produzione, la strategia ottimale consiste nel instradare dinamicamente le richieste verso la variante giusta:
- Analizza la richiesta — coinvolge calcoli, analisi o elaborazione semplice?
- Instrada per default verso il non-ragionamento — è più veloce ed economico
- Passa al ragionamento quando la richiesta implica un ragionamento multi-step
- Monitora i risultati — adatta i criteri di routing in base alla qualità osservata
Questo approccio ti permette di sfruttare la potenza del ragionamento quando serve, senza pagare il sovrapprezzo quando è superfluo.
Il caso speciale di max_completion_tokens
Secondo il riferimento API di xAI, max_completion_tokens si applica solo alla risposta visibile: i token di ragionamento e le chiamate di funzione non contano nel limite, e il valore predefinito è 128.000 token. Imposta questo limite in base alla lunghezza attesa della risposta e regola il ragionamento tramite lo sforzo (reasoning_effort) su grok-4.5, 4.6 e 4.7.
Punti chiave
- Le varianti con ragionamento aggiungono una fase di pensiero interno prima di rispondere
- Il ragionamento è crittografato (non visibile in testo semplice); tuttavia, grok-4.7 espone un riepilogo, consultabile via streaming
presencePenalty,frequencyPenaltyestopsono vietati in modalità ragionamento- Il ragionamento costa da 2 a 5 volte più del non-ragionamento
- Usa il ragionamento per matematica, logica e problemi multi-step
- Usa il non-ragionamento per scrittura, classificazione ed estrazione