De Tool-Call Round Trip
Tool calling is een dans van twee beurten. Je stuurt het bericht van de gebruiker samen met je tool schemas; het model antwoordt met een tool_use blok dat zegt "call get_weather with {city: 'Paris'}"; je code voert die functie uit en stuurt het antwoord terug als een tool_result; daarna gebruikt het model dit om de uiteindelijke reactie te schrijven. Deze les bouwt de middelste stap -> het deel waar de aanvraag van het model een echte Python call wordt en het resultaat wordt verpakt voor de terugreis.
Hier is de echte lus (alleen illustratief -> we roepen het netwerk niet aan):
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)De niet-onderhandelbare details: je roept de functie aan die het model noemt met de argumenten die het geeft, je echoot de tool_use_id terug in de tool_result zodat het model elk antwoord aan zijn verzoek kan koppelen, en wanneer één beurt vraagt om meerdere tools stuur je elk resultaat terug in één gebruikersbericht (het splitsen over meerdere berichten leert het model om niet parallel te vragen). In deze les verwerk je de eenvoudigste zaak, één tool call; les 4 verwerkt meerdere. We modelleren de respons als een simpele dictionary zodat het offline draait:
{"content": [{"type": "tool_use", "id": "toolu_1",
"name": "get_weather", "input": {"city": "Paris"}}],
"stop_reason": "tool_use"}Je bouwt run_tool_call(resp, tools), waar tools een toolnaam koppelt aan een Python functie. Het moet:
- Zoek het eerste blok in
resp["content"]waarvan detypeis"tool_use". - Zoek
tools[name]op en roep het aan met deinputvan het blok als keyword arguments:tools[name](**block["input"]). Als de naam niet intoolsstaat, gooi een (eenKeyErrorofValueError) -> voer nooit een tool uit die het model heeft gehallucineerd. - Geef het vervolgbericht van de gebruiker dat het resultaat terugbrengt terug:
{"role": "user",
"content": [{"type": "tool_result",
"tool_use_id": <the block's id>,
"content": str(result)}]}Stringify het resultaat met str(result) -> de tool_result inhoud reist als tekst. Bouw het zo dat twee verschillende tool calls (verschillende naam en input) twee verschillende tool_result berichten produceren, de originele tool_use_id wordt teruggestuurd, en een onbekende tool naam een fout geeft.
Schrijf run_tool_call(resp, tools). Zoek het eerste {"type": "tool_use", "id", "name", "input"} blok in resp["content"], noem tools[name](**input), en geef het vervolgbericht {"role": "user", "content": [{"type": "tool_result", "tool_use_id": <id>, "content": str(result)}]} terug. Gooi een foutmelding bij een toolnaam die niet in tools staat.
Een probleem ontdekt in deze les? Meld het · Vraag naar deze les
Deze oefening opent binnenkort
Maak de les ervoor af voordat deze wordt ontgrendeld. De hele cursus is gratis, geen account nodig, en je kunt deze les nu lezen.
Deze browser blokkeert cookies voor learn.floati.life, dus lessen die je hier hebt afgerond kunnen niet in de juiste volgorde worden geopend. Sta cookies toe voor deze site en laad de pagina opnieuw.