IA para programadores
Tutorial: crea tu primer agente de IA con herramientas
Paso a paso para construir un agente mínimo que razona, llama a una herramienta y verifica el resultado, con código comentado.
En este tutorial construiremos un agente mínimo pero real: recibe una tarea, decide si necesita llamar a una herramienta, ejecuta y responde con el resultado verificado. Usamos TypeScript, pero los conceptos aplican a cualquier stack.
1. Define las herramientas
Cada herramienta es una función con un esquema claro de entrada. El modelo decide cuándo llamarla basándose en su descripción, así que escribe descripciones precisas.
const tools = {
buscarDocumento: {
description: "Busca un documento por título",
execute: async ({ titulo }: { titulo: string }) =>
db.documentos.find((d) => d.titulo.includes(titulo)),
},
};2. El bucle del agente
El patrón es siempre el mismo: el modelo responde con texto o con una llamada a herramienta; ejecutas la llamada, añades el resultado a la conversación y vuelves a preguntar hasta que responda con texto final.
3. Pon límites
- Máximo de pasos (p. ej. 10) para evitar bucles infinitos.
- Valida siempre los argumentos antes de ejecutar.
- Registra cada llamada para depurar y auditar.
4. Prueba con casos adversos
Prueba qué ocurre si la herramienta falla, si el documento no existe o si la petición es ambigua. Un agente útil falla de forma controlada y explica qué no pudo hacer.