Le voyage aller-retour de l'appel d'outil
L'appel d'outils est une danse en deux tours. Tu envoies le message de l'utilisateur avec tes tool schemas; le modèle répond avec un bloc tool_use disant "call get_weather with {city: 'Paris'}"; ton code exécute cette fonction et renvoie la réponse comme un tool_result; ensuite le modèle l'utilise pour écrire la réponse finale. Cette leçon construit l'étape du milieu -> la partie où la requête du modèle devient un vrai appel Python et le résultat est emballé pour le voyage de retour.
Voici la vraie boucle (illustratif seulement -> nous n'appelons pas le réseau) :
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)Les détails non négociables : tu appelles la fonction que le modèle a nommée avec les arguments qu'il a donnés, tu échois son tool_use_id dans le tool_result pour que le modèle puisse faire correspondre chaque réponse à sa requête, et quand un tour demande plusieurs outils tu retournes chaque résultat dans un seul message utilisateur (les diviser sur plusieurs messages apprend au modèle à arrêter de demander en parallèle). Dans cette leçon tu gères le cas le plus simple, un appel de fonction ; la leçon 4 gère plusieurs. Nous modélisons la réponse comme un dictionnaire simple pour qu'elle s'exécute hors ligne :
{"content": [{"type": "tool_use", "id": "toolu_1",
"name": "get_weather", "input": {"city": "Paris"}}],
"stop_reason": "tool_use"}Tu construis run_tool_call(resp, tools), où tools associe un nom d'outil à une fonction Python. Elle doit :
- Trouve le premier bloc dans
resp["content"]dont letypeest"tool_use". - Recherche
tools[name]et appelle-le avec leinputdu bloc comme arguments par mot-clé :tools[name](**block["input"]). Si le nom n'est pas danstools, lève (uneKeyErrorou uneValueError) -> ne jamais exécuter un outil que le modèle a halluciné. - Retourne le message de suivi de l'utilisateur qui ramène le résultat :
{"role": "user",
"content": [{"type": "tool_result",
"tool_use_id": <the block's id>,
"content": str(result)}]}Stringify le résultat avec str(result) -> le contenu tool_result voyage comme du texte. Construis-le pour que deux appels d'outils différents (nom et entrée différents) produisent deux messages tool_result différents, le tool_use_id original est renvoyé, et un nom d'outil inconnu provoque une erreur.
Écris run_tool_call(resp, tools). Trouve le premier bloc {"type": "tool_use", "id", "name", "input"} dans resp["content"], appelle tools[name](**input), et retourne le message de suivi {"role": "user", "content": [{"type": "tool_result", "tool_use_id": <id>, "content": str(result)}]}. Lève une erreur sur un nom d'outil qui n'est pas dans tools.
Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon
Cet exercice s'ouvre bientôt
Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.
Ce navigateur bloque les cookies pour learn.floati.life, donc les leçons que tu as terminées ici ne peuvent pas s'ouvrir dans l'ordre. Autorise les cookies pour ce site et recharge la page.