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

Chamadas de Ferramentas em Paralelo: Uma Viagem de Ida e Volta

Por que isso importa Pergunte "qual é o clima em Paris, Tóquio e Lima?" e um modelo atual pede as três ferramentas em uma única resposta. Responda errado e o modelo ou perde o fio da meada ou para de chamar ferramentas em paralelo.

As regras para a resposta que você enviar de volta:

  • Uma user mensagem cujo conteúdo é uma lista de tool_result blocos, um para cada tool_use bloco, na mesma ordem. Dividi-los em várias mensagens ensina o modelo a parar de perguntar em paralelo.
  • Cada resultado ecoa o id da sua chamada como tool_use_id.
  • Uma ferramenta
  • que falha ainda recebe um resultado: is_error: true e uma mensagem curta, para que o modelo possa explicar ou tentar outro caminho. Nunca a descarte, e nunca deixe uma ferramenta falhando travar a turnada inteira.
  • A ferramenta que o modelo inventou (não está no seu registro) é um resultado de erro também, nunca algo que você tenta rodar.

(Antes que esta mensagem volte, a própria resposta do modelo, com todos os seus blocos incluindo o pensamento, é anexada à conversa sem alterações.)

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 tool_results(reply, tools), onde tools mapeia um nome para uma function. Retorne {"role": "user", "content": [...]} com um bloco por bloco tool_use, em ordem: {"type": "tool_result", "tool_use_id": ..., "content": str(result), "is_error": False} quando a tool rodou, e is_error: True com conteúdo "unknown tool: NAME" ou "error: MESSAGE" (a mensagem da exceção) quando não rodou. Mantenha o REPLIES e TOOLS do starter como estão: o check os 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.