Conteúdo do curso Lição 118 de 250 · Chamando um LLM Real
Chamando um LLM Real

Chamadas de Ferramentas Paralelas e is_error

A lição anterior lidou com uma chamada de ferramenta. Mas modelos modernos pedem várias de uma vez: o uso paralelo de ferramentas está ativado por padrão, então um único turno do assistente pode conter três ou quatro tool_use blocos ("pegar o clima E procurar o pedido E verificar o estoque"). Se o seu código executar apenas o primeiro, o modelo espera por resultados que nunca chegam e o turno trava.

"Paralelo" aqui descreve o REQUEST do modelo, não a sua execução: o modelo pediu várias ferramentas em um único turno. Você pode simplesmente executá-las uma após a outra e enviar todos os resultados juntos, sem precisar de threads ou async.

O contrato é preciso: execute cada tool_use bloco, depois envie de volta a one mensagem do usuário cuja content é uma list de tool_result blocos, um por chamada, cada um ecoando seu próprio tool_use_id.

{"content": [
  {"type": "tool_use", "id": "t1", "name": "get_weather", "input": {"city": "Paris"}},
  {"type": "tool_use", "id": "t2", "name": "add",         "input": {"a": 2, "b": 5}}],
 "stop_reason": "tool_use"}

A segunda ideia nova é isolamento de falhas. Se uma ferramenta falhar, você NÃO trava a turnada inteira e perde os outros resultados. Você retorna o tool_result daquele bloco com "is_error": True e o texto do erro como seu conteúdo, para que o modelo possa ver o que deu errado e se recuperar. Um nome de ferramenta alucinado (não no seu registro) é apenas outro erro: reporte como is_error, nunca execute algo que você não registrou.

Construa run_tool_calls(resp, tools) retornando a mensagem única de acompanhamento do usuário. Em caso de sucesso, um tool_result tem exatamente type, tool_use_id e content (o resultado via str(...)); em caso de falha, ele TAMBÉM carrega "is_error": True. Pressione Run para responder um turno de duas chamadas.

Sua vez

Escreva run_tool_calls(resp, tools) que executa TODO bloco tool_use em resp["content"] (ignore outros tipos de bloco) e retorna uma mensagem do usuário {"role": "user", "content": [ ...tool_result blocks... ]}, um resultado por chamada em ordem. Cada resultado de sucesso é {"type": "tool_result", "tool_use_id": <id>, "content": str(result)}. Se uma ferramenta lançar um erro ou seu nome não estiver em tools, esse resultado em vez disso carrega "is_error": True com o texto de erro como content, e as outras ferramentas ainda rodam.

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.