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
argsdoivent correspondre exactement au schéma enregistré. Un argument manquant ou un argument en trop -> lèveValueError. 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.
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.
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.