Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Ragionamento visibile: concetto e lineup 2026

Lezione 1 di 12 Aggiornata il 28 luglio 2026 Sviluppatore
In questa pagina
  1. Che cos’è il ragionamento visibile?
  2. Sforzo di ragionamento regolabile
  3. Tracce di ragionamento nella risposta
  4. Cosa significa per te
  5. Casi d’uso del ragionamento regolabile
  6. Punti chiave

Aggiornato il 3 novembre 2026 sulla base della pagina Models e della guida Reasoning di xAI: grok-4.6 e grok-4.7 completano la gamma high-end, con l’impostazione dello sforzo xhigh. Fonti: Models · Reasoning.

Che cos’è il ragionamento visibile?

Un modello di ragionamento genera una catena di pensiero interna prima di formulare la risposta finale: scompone il problema, esplora diverse strade e verifica i propri passaggi. Alcuni modelli espongono questo ragionamento nella risposta API, mentre altri lo mantengono interno. Comprendere questa distinzione è il punto di partenza dell’intero corso.

Storicamente, presso xAI, grok-3-mini (generazione precedente, rimosso dal catalogo nel 2026) ha reso popolare il ragionamento visibile: il suo campo reasoning_content conteneva l’intero processo di pensiero, in testo semplice, direttamente leggibile. Questa trasparenza ne ha fatto uno strumento didattico eccezionale e la scelta preferita per il debug dei prompt.

Nel luglio 2026, la lineup è cambiata. Il ragionamento funziona ora con due famiglie di modelli:

  • grok-4.20-0309-reasoning: la variante esplicitamente dedicata al ragionamento, con 1 milione di token di contesto.
  • grok-4.7, grok-4.6 e grok-4.5: i modelli high-end (settembre, agosto e luglio 2026), il cui ragionamento è regolabile: moduli lo sforzo di ragionamento in base al compito, fino a xhigh su 4.6 e 4.7; grok-4.7 è il modello raccomandato da xAI.
4.20
Variante dedicata al ragionamento
Configurabile
Sforzo regolabile da grok-4.5 a grok-4.7
1M
Contesto di grok-4.20-0309
500k
Contesto di grok-4.5

Sforzo di ragionamento regolabile

Il principio dello sforzo di ragionamento regolabile è semplice: maggiore è lo sforzo, più token di ragionamento il modello consuma prima di rispondere e più affidabile sarà la risposta su problemi complessi.

  • Basso sforzo: il modello riflette brevemente. Adatto a domande semplici dove desideri una risposta strutturata senza consumare troppi token.
  • Alto sforzo: il modello sviluppa un ragionamento profondo. Adatto a problemi logici, calcoli multi-step o analisi di codice complesse.

Sulla generazione precedente, questa impostazione utilizzava il parametro reasoning_effort (low / high) su grok-3-mini:

{
  "model": "grok-4.20-0309-reasoning",
  "reasoning_effort": "high",
  "messages": [
    {
      "role": "user",
      "content": "Prove that the square root of 2 is irrational."
    }
  ]
}

Su grok-4.5, il ragionamento è configurabile nativamente: è anzi uno degli argomenti centrali del modello. Il nome esatto e i valori del parametro evolvono con l’API: consulta la pagina ufficiale Models (docs.x.ai) per la sintassi corrente prima di scrivere il tuo codice.

Tracce di ragionamento nella risposta

Sulla generazione precedente, grok-3-mini restituiva un campo reasoning_content nell’oggetto message, contenente il ragionamento completo in testo semplice:

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "The square root of 2 is irrational...",
        "reasoning_content": "I will use a proof by contradiction. Assume that √2 = p/q where p and q are coprime integers..."
      }
    }
  ]
}

Importante avvertenza: sulla lineup 2026 (grok-4.5, grok-4.20-0309-reasoning), la documentazione ufficiale non garantisce che le tracce di ragionamento siano esposte in testo semplice nello stesso modo. Prima di costruire un’interfaccia che mostri il ragionamento del modello, testa l’oggetto risposta restituito dal modello che stai utilizzando e consulta la pagina ufficiale Models. Non dare mai per scontato che il comportamento della generazione precedente sia preservato.

Cosa significa per te

La distinzione da ricordare:

  • Ragionamento esposto: puoi visualizzare il processo di pensiero, farne il debug, usarlo per insegnare. Verifica questo punto modello per modello sulla lineup attuale.
  • Ragionamento interno: il modello pensa, ma ricevi solo la risposta finale (e potenzialmente un contenuto riutilizzabile cifrato—vedi la prossima lezione).

Se la tua applicazione ha bisogno di mostrare come il modello ragiona (tutor, strumento educativo, audit), valida prima questo punto nella scelta del modello. Se conta solo la qualità della risposta finale, grok-4.5 con sforzo adattato è la scelta naturale.

Casi d’uso del ragionamento regolabile

  • Debug dei prompt: uno sforzo elevato su grok-4.20-0309-reasoning rivela se il modello interpreta correttamente le tue istruzioni
  • Didattica: scomporre il ragionamento matematico o logico passo dopo passo
  • Validazione: verificare il percorso di ragionamento su un campione prima di andare in produzione
  • Prototipazione: testare una catena di ragionamento con basso sforzo prima di scalare

Punti chiave

  • Un modello di ragionamento pensa prima di rispondere; alcuni espongono questo ragionamento, altri no
  • grok-3-mini (generazione precedente, fuori catalogo) esponeva il suo ragionamento in testo semplice tramite reasoning_content
  • Nel 2026, il ragionamento funziona con grok-4.20-0309-reasoning (variante dedicata, contesto 1M) e grok-4.5 (ragionamento configurabile, contesto 500k)
  • L’esposizione delle tracce sulla lineup attuale non è garantita: testa la risposta API e consulta la pagina ufficiale Models
  • Scegli lo sforzo di ragionamento in base alla complessità del compito, non impostandolo di default al massimo