Programme Leçon 117 sur 250 · Appeler un vrai LLM
Appeler un vrai LLM

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 le type est "tool_use".
  • Recherche tools[name] et appelle-le avec le input du bloc comme arguments par mot-clé : tools[name](**block["input"]). Si le nom n'est pas dans tools, lève (une KeyError ou une ValueError) -> 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.

À ton tour

É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.