Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Ragionamento vs Non-ragionamento

Lezione 12 di 14 Aggiornata il 3 novembre 2026 Principiante
In questa pagina
  1. Due approcci fondamentalmente diversi
  2. Come funziona il ragionamento
  3. Parametri vietati in modalità ragionamento
  4. Quando usare il ragionamento
  5. Quando usare il non-ragionamento
  6. Strategia di routing
  7. Il caso speciale di max_completion_tokens
  8. Punti chiave

Aggiornato il 3 novembre 2026 in base al riferimento API di xAI e alla guida sul Ragionamento: max_completion_tokens limita solo la risposta visibile, non il ragionamento; logprobs viene 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:

  1. Analizza la richiesta — coinvolge calcoli, analisi o elaborazione semplice?
  2. Instrada per default verso il non-ragionamento — è più veloce ed economico
  3. Passa al ragionamento quando la richiesta implica un ragionamento multi-step
  4. 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, frequencyPenalty e stop sono 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