Temario Lección 173 de 250 · Construir agentes (uso de herramientas y ReAct)
Construir agentes (uso de herramientas y ReAct)

De la intención a la herramienta + extracción de argumentos

Antes de que el bucle pueda actuar, tiene que decidir qué herramienta llamar y sacar los argumentos de la petición. Eso es el enrutador, y es la parte más propensa a errores de un agente real: enruta mal la intención o equivócate con los argumentos y todos los pasos posteriores estarán mal. Un sistema de producción suele usar el LLM para esto, pero un enrutador que puedes leer, probar y razonar es más rápido, más barato y determinista, y siempre deberías tener uno como respaldo.

Vas a construir route(query), que convierta una petición de texto libre en una decisión estructurada {"tool": ..., "args": {...}}. Tres herramientas reales más un comodín:

  • calculator: una petición como "12 * 3" contiene dos números alrededor de un operador. Analízala en {"a": 12, "op": "*", "b": 3}.
  • weather: aparece la palabra weather. Saca la ciudad de "... in <City>" en {"city": "Paris"}.
  • dictionary: frases como define X o meaning of X. Extrae el término en {"term": "photosynthesis"}.
  • fallback: no encajó nada, así que enruta al valor seguro por defecto con el texto original en {"query": ...}.

Las expresiones regulares hacen el trabajo pesado. El patrón de la calculadora captura un número, un operador y otro número:

import re
m = re.search(r"(-?\d+(?:\.\d+)?)\s*([+\-*/])\s*(-?\d+(?:\.\d+)?)", text)
if m:
    a, op, b = m.group(1), m.group(2), m.group(3)
    # turn "12" into 12 (an int) so the calculator gets real numbers

Para la ciudad, busca la palabra in seguida de palabras con mayúscula; para el término, busca después de define / meaning of / definition of. El orden importa: comprueba primero el patrón de la calculadora, luego el del tiempo, luego el del diccionario, y cae al respaldo si ninguno encaja.

Mantén los números como int simples cuando sean enteros (así 12, no 12.0): las pruebas comprueban el dict exacto. En un agente completo, esta decisión enrutada va directa al despachador del módulo de herramientas estructuradas. Pulsa Ejecutar para enrutar cuatro peticiones distintas.

Tu turno

Escribe route(query), que devuelva {"tool": ..., "args": {...}}. Reconoce, en orden: una petición de calculadora ("12 * 3" -> {"a": 12, "op": "*", "b": 3}, con los números enteros como ints), una petición del tiempo (extrae la ciudad tras in), una petición de diccionario (extrae el término tras define/meaning of), y un fallback para todo lo demás con el texto original en {"query": ...}.

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