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"]cujotypeé"tool_use". - Procure
tools[name]e chame com oinputdo bloco como argumentos de palavra-chave:tools[name](**block["input"]). Se o nome não estiver emtools, lance (umaKeyErrorouValueError) -> 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.
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.
Este navegador está bloqueando cookies para learn.floati.life, então as lições que você terminou aqui não podem abrir em ordem. Permita cookies para este site e recarregue.