Conteúdo do curso Lição 245 de 250 · Trabalhando com Respostas do Modelo
Trabalhando com Respostas do Modelo

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 resposta

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 texto thinking está 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á.

Sua vez

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.