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 testothinkingè 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à.
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.
Questo browser blocca i cookie per learn.floati.life, quindi le lezioni che hai finito qui non si possono aprire in ordine. Consenti i cookie per questo sito e ricarica.