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

A Viagem de Ida e Volta da Chamada de Ferramenta

Tool calling é uma dança de duas turnos. Você envia a mensagem do usuário junto com seus tool schemas; o modelo responde com um bloco tool_use dizendo "call get_weather with {city: 'Paris'}"; seu código executa essa function e envia a resposta de volta como um tool_result; então o modelo a usa para escrever a resposta final. Esta lição constrói o passo do meio -> a parte onde a requisição do modelo se torna uma chamada Python real e o resultado é embalado para a viagem de volta.

Aqui está o loop real (apenas ilustrativo -> não chamamos a rede):

resp = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
                              tools=TOOLS, messages=history)
# resp.stop_reason == "tool_use". The model may ask for SEVERAL tools at once:
# append its turn once, run every tool_use block, and send ALL the results
# back together in ONE user message.
history.append({"role": "assistant", "content": resp.content})
results = []
for block in resp.content:
    if block.type == "tool_use":
        result = TOOLS_BY_NAME[block.name](**block.input)
        results.append({"type": "tool_result", "tool_use_id": block.id,
                        "content": str(result)})
history.append({"role": "user", "content": results})
final = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
                               tools=TOOLS, messages=history)

Os detalhes não negociáveis: você chama a function do modelo nomeado com os argumentos que ele forneceu, você ecoa o tool_use_id de volta no tool_result para que o modelo possa corresponder cada resposta ao seu pedido, e quando um turno pede várias ferramentas você retorna cada resultado em uma única mensagem de usuário (dividir entre mensagens ensina o modelo a parar de pedir em paralelo). Nesta lição você lida com o caso mais simples, uma chamada de ferramenta; a lição 4 lida com várias. Nós modelamos a resposta como um dict simples para que ela rode offline:

{"content": [{"type": "tool_use", "id": "toolu_1",
              "name": "get_weather", "input": {"city": "Paris"}}],
 "stop_reason": "tool_use"}

Você está construindo run_tool_call(resp, tools), onde tools mapeia um nome de ferramenta para uma função Python. Ele deve:

  • Encontre o primeiro bloco em resp["content"] cujo type é "tool_use".
  • Procure tools[name] e chame com o input do bloco como argumentos de palavra-chave: tools[name](**block["input"]). Se o nome não estiver em tools, lance (uma KeyError ou ValueError) -> nunca execute uma ferramenta que o modelo alucinou.
  • Retorne a mensagem de acompanhamento do usuário que traz o resultado de volta:
{"role": "user",
 "content": [{"type": "tool_result",
              "tool_use_id": <the block's id>,
              "content": str(result)}]}

Transforme o resultado com str(result) -> o conteúdo tool_result viaja como texto. Construa para que duas chamadas de ferramenta diferentes (nome e entrada diferentes) produzam duas mensagens tool_result diferentes, o tool_use_id original seja ecoado de volta, e um nome de ferramenta desconhecido gere um erro.

Sua vez

Escreva run_tool_call(resp, tools). Encontre o primeiro bloco {"type": "tool_use", "id", "name", "input"} em resp["content"], chame tools[name](**input) e retorne a mensagem de acompanhamento {"role": "user", "content": [{"type": "tool_result", "tool_use_id": <id>, "content": str(result)}]}. Lance um erro em um nome de ferramenta que não esteja em tools.

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.