Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Streaming del contenuto di ragionamento

Lezione 3 di 14 Aggiornata il 29 luglio 2026 Sviluppatore
In questa pagina
  1. Osserva il modello mentre pensa
  2. Come funziona il contenuto di ragionamento
  3. Vantaggi per gli sviluppatori
  4. Differenza rispetto alla modalità non-streaming
  5. Negli editor di codice
  6. Punti chiave

Osserva il modello mentre pensa

grok-build-0.1 espone il suo processo di ragionamento tramite un campo dedicato: reasoning_content. Questo campo è disponibile solo in modalità streaming, permettendoti di vedere come il modello analizza il tuo codice prima di produrre la risposta finale.

Come funziona il contenuto di ragionamento

Quando il modello elabora una richiesta complessa, come refactoring, debug o ottimizzazione, attraversa una fase di ragionamento interno. Con reasoning_content, questo ragionamento viene esposto in tempo reale durante lo streaming:

for chunk in response:
    # Reasoning arrives first
    if chunk.choices[0].delta.reasoning_content:
        print("[Reasoning]", chunk.choices[0].delta.reasoning_content)

    # Then the final response
    if chunk.choices[0].delta.content:
        print("[Response]", chunk.choices[0].delta.content)

In pratica, vedi prima il modello analizzare il problema (identificando le dipendenze, individuando i casi limite, pianificando le modifiche), poi arriva la soluzione strutturata.

Vantaggi per gli sviluppatori

Debug trasparente

Quando il modello propone una correzione di un bug, reasoning_content ti mostra perché ha identificato quella riga come problematica. Puoi convalidare il suo ragionamento prima di accettare la modifica.

Apprendimento

Leggendo il ragionamento del modello, ne comprendi l’approccio. Questo è particolarmente utile quando lavori con un linguaggio o un framework che conosci meno.

Fiducia

Se il ragionamento è superficiale o errato, sai che la risposta sarà probabilmente sbagliata. Questo è un segnale di avvertimento che ti permette di aggiustare il tuo prompt prima di applicare le modifiche.

Differenza rispetto alla modalità non-streaming

In modalità non-streaming (richiesta standard senza streaming), reasoning_content non è disponibile. Ricevi solo la risposta finale. Ecco perché la maggior parte degli editor di codice utilizza la modalità streaming per impostazione predefinita con grok-build-0.1.

Negli editor di codice

La maggior parte degli editor che integrano grok-build-0.1 non mostra direttamente reasoning_content all’utente, ma lo sfrutta dietro le quinte, cosa istruttiva per la tua stessa integrazione. Alcuni convalidano la coerenza del ragionamento prima di presentare il suggerimento, scartando le risposte in cui il ragionamento devia chiaramente. Altri lo usano per visualizzare un indicatore di progresso onesto: invece di un spinner silenzioso, l’utente vede che il modello sta effettivamente lavorando. Infine, quasi tutti lo registrano nei log, perché quando si esegue il debug di un’integrazione — perché il modello ha proposto questa modifica assurda? — la traccia del ragionamento è spesso l’unica spiegazione disponibile.

Se stai sviluppando il tuo agente API con grok-build-0.1, sfruttare reasoning_content è un vantaggio significativo per offrire un’esperienza utente migliore.

Punti chiave

  • reasoning_content espone il ragionamento del modello in tempo reale
  • È disponibile solo in modalità streaming
  • Lo leggi tramite chunk.choices[0].delta.reasoning_content
  • Gli editor lo usano internamente per migliorare l’esperienza
  • È uno strumento prezioso per convalidare i suggerimenti prima di applicarli