Programma Lezione 245 di 250 · Lavorare con le risposte del modello
Lavorare con le risposte del modello

Leggere una vera risposta: blocchi e motivi di arresto

Perché è importante Ogni bug di questo modulo comincia allo stesso modo: codice che legge reply["content"][0]["text"] e dà per scontato che quella sia la risposta. Con un modello attuale il primo blocco spesso non è affatto testo.

Una risposta dell'API Messages di Claude è un dict. La risposta vive in content, una lista di blocchi, e ogni blocco ha un type:

  • "thinking": il modello ha ragionato prima di rispondere. Sui modelli attuali questo blocco spesso viene per primo, e di default il suo testo thinking è vuoto (il ragionamento c'è stato, ma non viene mostrato).
  • "text": parole per l'utente. Ci può essere più di un blocco di testo; la risposta è l'unione di tutti.
  • "tool_use": il modello vuole che tu esegua uno strumento (lezioni successive).

Accanto al contenuto c'è stop_reason, che dice perché il modello si è fermato: "end_turn" (finito), "max_tokens" (ha raggiunto il tuo limite di lunghezza, quindi la risposta può essere troncata o perfino mancare), "tool_use" (aspetta il risultato di uno strumento) o "refusal" (ha rifiutato). Ce ne sono altri, come "stop_sequence" e "pause_turn", quindi considera non finito tutto ciò che non è "end_turn". Controllalo sempre prima di fidarti del contenuto.

{'id': 'msg_01',
 'type': 'message',
 'role': 'assistant',
 'model': 'claude-opus-5-5',
 'content': [{'type': 'thinking', 'thinking': '', 'signature': 'EuYBCkQYAiJA...'},
             {'type': 'text',
              'text': 'A context window is the amount of text a model can read at once.'}],
 'stop_reason': 'end_turn',
 'stop_sequence': None,
 'usage': {'input_tokens': 412, 'output_tokens': 60}}

Su queste risposte: sono simulate. Ognuna è stata scritta per questo corso esattamente nella forma che restituisce l'API Messages di Claude (blocchi di contenuto, stop_reason, usage), e ognuna copia qualcosa che fanno i modelli veri. Non sono registrazioni di un modello dal vivo, quindi le parole esatte sono nostre; le forme e i problemi sono quelli veri che il tuo codice incontrerà.

Tocca a te

Scrivi reply_text(reply) che restituisce tutti i blocchi di testo uniti in ordine (una stringa vuota se non ce ne sono), saltando ogni altro tipo di blocco. Scrivi finished(reply) che restituisce True solo quando stop_reason è "end_turn". Lascia REPLIES del codice di partenza così com'è: la verifica lo legge.

Hai notato un problema in questa lezione? Segnalalo · Chiedi qualcosa su questa lezione

Questo esercizio si apre presto

Finisci la lezione precedente e questa si sblocca. L'intero corso è gratuito, senza account, e puoi leggere questa lezione subito.