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
argsdeben coincidir exactamente con el esquema registrado. Un argumento que falta o uno de más -> lanzaValueError. 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.
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.
Este navegador está bloqueando las cookies de learn.floati.life, así que las lecciones que terminaste aquí no se pueden abrir en orden. Permite las cookies de este sitio y recarga.