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

Verifique uma Tool Call antes de executá-la

Por que isso importa Uma tool call é o modelo pedindo para o seu código agir: reservar, pagar, deletar. O modelo preenche os argumentos a partir de uma conversa, e ele pode errar. Executar uma reserva para "Sexta-feira" ou para vinte pessoas em um restaurante que acomoda doze é um bug real com um custo real.

A ferramenta que o modelo recebeu:

{"name": "book_table",
 "input_schema": {"type": "object", "required": ["date", "time", "party_size"],
   "properties": {"date": {"type": "string", "description": "YYYY-MM-DD"},
                  "time": {"type": "string", "description": "HH:MM, 24-hour"},
                  "party_size": {"type": "integer", "description": "1 to 12"}}}}

Seis respostas, cada uma um padrão que modelos reais produzem: uma chamada correta; uma chamada com "Friday" onde uma data era necessária; party_size como a string "2"; uma chamada que deixou de fora time; uma festa de 20 (a descrição diz de 1 a 12, e uma descrição é um pedido, não uma garantia); e nenhuma chamada de ferramenta, porque o modelo fez uma pergunta ao usuário primeiro, o que geralmente é o movimento certo.

Seu trabalho é o portão: decida se deve executar a tool, enviar os problemas de volta para o modelo para que ele possa corrigi-los, ou passar a pergunta para o usuário. (Com strict: true na definição da tool, a API garante os tipos e campos obrigatórios, mas não que os valores façam sentido; o intervalo e a data real são sempre de sua responsabilidade para verificar.)

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 gate_booking(reply). Se a resposta não tiver um bloco tool_use, retorne {"action": "ask_user", "text": ...} com o texto unido. Caso contrário, pegue a primeira chamada book_table e verifique sua entrada: cada chave obrigatória presente; date uma data real escrita YYYY-MM-DD; time escrita HH:MM com horas de 00 a 23 e minutos de 00 a 59; party_size um int real (não uma string, não True) de 1 a 12. Retorne {"action": "run", "input": ...} quando tudo passar, senão {"action": "fix", "errors": [...]} com uma mensagem por problema, cada mensagem nomeando o campo sobre o qual trata. 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.