Agentes de IA
Reglas
- Define herramientas como funciones tipadas con descripciones — el modelo elige qué herramienta invocar
- Esquema de herramienta:
{ name, description, parameters: zodSchema, execute: async (args) => result }
- Bucle multi-paso: enviar mensajes → el modelo devuelve una llamada a herramienta → ejecutar herramienta → retroalimentar el resultado → repetir hasta terminar
- Límite
maxSteps para evitar bucles infinitos — por defecto 5-10 pasos dependiendo de la complejidad
- Salidas estructuradas con Zod:
generateObject({ schema: z.object({...}) }) para una forma garantizada
- Lógica de reintentos: envolver la ejecución de herramientas en try/catch, reintentar fallos transitorios 2-3 veces con backoff exponencial
- Orquestación de agentes: dividir tareas complejas en sub-agentes con conjuntos de herramientas enfocados, un agente coordinador delega
- Siempre valida los resultados de las herramientas antes de retroalimentarlos al modelo — sanitiza datos no confiables
- Usa
streamText con onToolCall para visibilidad en tiempo real del razonamiento del agente
Patrones
const tools = {
searchDatabase: tool({
description: "Buscar en la base de datos de productos",
parameters: z.object({ query: z.string(), limit: z.number().default(10) }),
execute: async ({ query, limit }) => db.products.search(query, limit),
}),
};
const result = await generateText({
model,
tools,
maxSteps: 10,
messages,
});
Evitar
- Dar acceso irrestricto a herramientas a los agentes — limita las herramientas a la tarea
- Olvidar
maxSteps — los agentes pueden ciclar para siempre
- Confiar en las salidas de las herramientas sin validación — siempre verifica antes de actuar sobre los resultados
- Agentes monolíticos — prefiere sub-agentes enfocados en lugar de un agente con más de 20 herramientas