Programme Leçon 230 sur 250 · Projet : agent de recherche qui utilise des outils
Projet : agent de recherche qui utilise des outils

Registre d'outils + répartiteur

Tous les « agents IA » dont tu as entendu parler reposent au fond sur un composant sans éclat : un registre d'outils. Le modèle émet quelque chose comme {"tool": "search", "args": {"query": "weather"}}, et ton code doit trouver la bonne fonction Python, vérifier que les arguments tiennent la route, l'exécuter et renvoyer le résultat. Rate cette couche et tout l'agent est à un argument mal formé d'un plantage en production. Cette première leçon du projet construit exactement cette couche, et tu réutiliseras l'idée dans toutes les leçons suivantes.

Tu construis le répartiteur d'un agent de recherche. Il lui faut deux outils pour commencer : un search(query) qui cherche un fait, et un calc(op, a, b) qui fait des calculs. Le registre associe un nom d'outil à une paire : la fonction, et un schéma d'arguments (l'ensemble des noms d'arguments que l'outil accepte). La répartition est la porte par laquelle tout passe.

class Registry:
    def __init__(self):
        self.tools = {}   # name -> {"fn": callable, "args": set_of_arg_names}

    def register(self, name, fn, args):
        self.tools[name] = {"fn": fn, "args": set(args)}

    def dispatch(self, name, args):
        # 1. unknown tool name      -> raise KeyError
        # 2. args keys != schema    -> raise ValueError (missing OR extra)
        # 3. otherwise              -> call fn(**args) and return the result
        ...

Les règles que dispatch doit faire respecter (c'est tout l'intérêt de l'exercice) :

  • Un nom d'outil inconnu -> lève KeyError. L'agent a demandé quelque chose qui n'existe pas.
  • Les clés du dict args doivent correspondre exactement au schéma enregistré. Un argument manquant ou un argument en trop -> lève ValueError. C'est ce qui empêche un {"q": ...} halluciné (mauvaise clé) de ne rien faire sans bruit.
  • Un appel valide -> exécute fn(**args) et renvoie ce qu'elle renvoie.

Pourquoi un set pour le schéma ? Parce que la validation devient alors une simple égalité d'ensembles : set(args) == self.tools[name]["args"]. Si c'est faux, détermine si des clés manquent ou sont en trop, et lève ValueError dans les deux cas. Appeler avec fn(**args) déplie le dict en arguments nommés, donc c'est la signature de la fonction qui fait l'association finale.

Un recruteur qui lit « j'ai construit un agent qui utilise des outils » se demande en réalité : as-tu géré les cas d'échec ? L'agent qu'on met en production est celui dont le répartiteur refuse bruyamment les mauvais appels au lieu de corrompre une exécution. Appuie sur Run pour enregistrer deux outils et voir les bons appels réussir pendant que les mauvais lèvent une erreur.

À ton tour

Construis une classe Registry. register(name, fn, args) stocke la fonction et son schéma de noms d'arguments (utilise un set). dispatch(name, args) doit : lever KeyError pour un nom d'outil inconnu ; lever ValueError si les clés de args ne correspondent pas exactement au schéma (manquante OU en trop) ; sinon appeler fn(**args) et renvoyer le résultat. Enregistre un outil search(query) et un outil calc(op, a, b) pour que le répartiteur ait quelque chose de réel vers quoi router.

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.