Temario Lección 230 de 250 · Proyecto: agente de investigación que usa herramientas
Proyecto: agente de investigación que usa herramientas

Registro de herramientas + despachador

Todo "agente de IA" del que hayas leído se reduce al final a un componente poco glamuroso: un registro de herramientas. El modelo emite algo como {"tool": "search", "args": {"query": "weather"}}, y tu código tiene que encontrar la función de Python correcta, comprobar que los argumentos tienen sentido, ejecutarla y devolver el resultado. Si te equivocas en esta capa, todo el agente está a un argumento mal formado de fallar en producción. Esta primera lección del proyecto construye exactamente esa capa, y reutilizarás la idea en todas las lecciones siguientes.

Estás construyendo el despachador de un agente de investigación. Para empezar necesita dos herramientas: un search(query) que busca un dato y un calc(op, a, b) que hace aritmética. El registro asigna a cada nombre de herramienta un par: la función y un esquema de argumentos (el conjunto de nombres de argumento que acepta la herramienta). El despacho es la puerta por la que pasa todo.

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

Las reglas que debe imponer el despacho (esa es toda la idea del ejercicio):

  • Un nombre de herramienta desconocido -> lanza KeyError. El agente pidió algo que no existe.
  • Las claves del dict args deben coincidir exactamente con el esquema registrado. Un argumento que falta o uno de más -> lanza ValueError. Es lo que impide que un {"q": ...} alucinado (clave equivocada) no haga nada sin avisar.
  • Una llamada válida -> ejecuta fn(**args) y devuelve lo que devuelva.

¿Por qué un set para el esquema? Porque así la validación es simplemente una igualdad de conjuntos: set(args) == self.tools[name]["args"]. Si es falsa, averigua si faltan claves o sobran y lanza ValueError en ambos casos. Llamar con fn(**args) reparte el dict en argumentos con nombre, así que la firma de la función hace la vinculación final.

Quien lee "construí un agente que usa herramientas" en realidad pregunta: ¿trataste el camino infeliz? El agente que se publica es aquel cuyo despachador rechaza ruidosamente las llamadas malas en lugar de estropear una ejecución. Pulsa Ejecutar para registrar dos herramientas y ver cómo las llamadas buenas salen bien mientras las malas lanzan excepciones.

Tu turno

Construye una clase Registry. register(name, fn, args) guarda la función y su esquema de nombres de argumento (usa un set). dispatch(name, args) debe: lanzar KeyError con un nombre de herramienta desconocido; lanzar ValueError si las claves de args no coinciden exactamente con el esquema (falta alguna O sobra alguna); y si no, llamar a fn(**args) y devolver el resultado. Registra una herramienta search(query) y otra calc(op, a, b) para que el despachador tenga algo real a donde enrutar.

¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección

Este ejercicio se abre pronto

Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.