Lendo uma Resposta Real: Blocos e Motivos de Parada
Por que isso importa Todo bug neste módulo começa do mesmo jeito: código que lê reply["content"][0]["text"] e assume que essa é a resposta. Em um modelo atual, o primeiro bloco muitas vezes nem é texto.
A da Claude Messages API é um dict. A resposta está em content, uma lista de blocos, e cada bloco tem um type:
"thinking": o modelo raciocinou antes de responder. Nos modelos atuais, este bloco geralmente vem primeiro, e por padrão seu textothinkingestá vazio (o raciocínio aconteceu, mas não é mostrado)."text": palavras para o usuário. Pode haver mais de um bloco de texto; a resposta é todos eles juntos."tool_use": o modelo quer que você execute uma ferramenta (lições posteriores).
Ao lado do conteúdo fica stop_reason, que diz por que o modelo parou: "end_turn" (finalizado), "max_tokens" (atingiu seu limite de tamanho, então a resposta pode estar cortada ou até faltando), "tool_use" (aguardando resultado de uma ferramenta) ou "refusal" (recusado). Existem mais alguns, como "stop_sequence" e "pause_turn", então trate qualquer coisa que não seja "end_turn" como não finalizado. Sempre verifique antes de confiar no conteúdo.
{'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}}
Sobre essas respostas: elas são simuladas. Cada uma foi escrita para este curso exatamente no formato que a Claude Messages API retorna (blocos de conteúdo, stop_reason, usage), e cada uma copia algo que modelos reais fazem. Elas não são gravações de um modelo ao vivo, então as palavras exatas são nossas; os formatos e os problemas são os reais que seu código encontrará.
Escreva reply_text(reply) retornando todos os blocos de texto unidos em ordem (uma string vazia se não houver nenhum), pulando cada outro tipo de bloco. Escreva finished(reply) retornando True apenas quando stop_reason for "end_turn". Mantenha o REPLIES do iniciador como está: a verificação o lê.
Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição
Este exercício abre em breve
Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.
Este navegador está bloqueando cookies para learn.floati.life, então as lições que você terminou aqui não podem abrir em ordem. Permita cookies para este site e recarregue.