Temario Lección 141 de 250 · Salidas estructuradas y llamadas a funciones y herramientas
Salidas estructuradas y llamadas a funciones y herramientas

Despachador o enrutador de herramientas

El modelo ha leído tus esquemas de herramientas y ha respondido con una llamada a herramienta: un objeto analizado como {"name": "add", "arguments": {"a": 4, "b": 5}}. Ahora tu programa tiene que ejecutar de verdad la función correcta. Ese es el trabajo de un despachador (o enrutador): buscar la herramienta nombrada, comprobar que los argumentos son exactamente los que la función espera, invocarla y devolver el resultado. Esta es la línea donde las palabras de un LLM se convierten en un efecto real en tu sistema, así que también es donde debes ser estricto.

En un bucle real se sitúa justo después de analizar la respuesta del modelo:

call = parse_tool_call(model_reply)        # {"name": ..., "arguments": {...}}
result = dispatch(call, TOOL_REGISTRY)     # runs the matching Python function
# feed result back to the model as the tool's observation

Vas a construir dispatch(call, registry), donde registry asigna nombres de herramientas a funciones de Python. Debe:

  • Leer call["name"] y call["arguments"] (los argumentos, por defecto {}).
  • Rechazar una herramienta desconocida. Si el nombre no está en el registro, lanza un ValueError -> nunca dejes de hacer algo en silencio, y nunca ejecutes una herramienta que el modelo se haya inventado.
  • Validar los argumentos. Usa inspect.signature para obtener los nombres de los parámetros de la función y confirma que las claves de los argumentos recibidos coinciden exactamente -> un argumento que falta o uno extra inesperado debe lanzar una excepción.
  • Invocar y devolver. Llama a la función con func(**arguments) y devuelve su resultado.
import inspect
expected = set(inspect.signature(func).parameters)
if set(arguments) != expected:
    raise ValueError("bad arguments")
return func(**arguments)

¿Por qué tan estricto con los argumentos? Una llamada a herramienta que se ejecuta con argumentos incorrectos o bien falla en lo profundo de tu función o, peor aún, hace lo incorrecto sin hacer ruido. Fallar ruidosamente en la frontera es justo la idea. Constrúyelo para que dos herramientas distintas (por ejemplo, una calculadora y una búsqueda) devuelvan cada una su propio resultado, una herramienta desconocida lance una excepción, y tanto un argumento que falta como uno extra lancen una excepción.

Tu turno

Escribe dispatch(call, registry), donde call es {"name": ..., "arguments": {...}} y registry asigna nombres a funciones. Lanza una excepción ante un nombre de herramienta desconocido. Usa inspect.signature para confirmar que está presente cada parámetro obligatorio y que no hay extras inesperados (un parámetro con valor por defecto es opcional, así que omitirlo está bien). inspect.signature(func).parameters asigna a cada nombre un objeto parámetro p; p.default is inspect.Parameter.empty es True exactamente cuando el parámetro no tiene valor por defecto, así que es obligatorio; luego llama a func(**arguments) y devuelve el resultado. Dos herramientas distintas deben devolver cada una su propio resultado.

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