Migrar de un sistema basado en workflows a un agente con mayor autonomía es un paso natural en la evolución de muchas arquitecturas LLM. Pero también es una zona de riesgo. Aumentar la flexibilidad sin controles adecuados puede derivar en errores costosos, loops inesperados o comportamientos opacos. Esta guía resume los anti-patrones más frecuentes y cómo mitigarlos.

1. Tentaciones comunes

• Over-prompting: Intentar resolver toda la lógica desde el prompt, sin herramientas bien definidas.
• Tool creep: Añadir demasiadas tools sin control ni priorización. El LLM se pierde al decidir.

Menos tools, mejor descritas, rinden más que muchas ambiguas.

2. Falta de contratos y validación

Sin JSON schemas ni reason codes, las salidas del agente son frágiles, difíciles de validar y casi imposibles de auditar.

• No hay garantías de estructura.
• Es difícil trazar errores o mejorar decisiones.

Solución:

• JSON schemas estrictos por tool.
• Códigos de decisión (reason_code) bien documentados.

3. Memoria sin límites ni TTL

Dar al agente memoria ilimitada puede parecer potente, pero suele generar:

• Respuestas incoherentes.
• Costes descontrolados.
• Riesgos de privacidad.

Define límites claros:

• Máximo de elementos.
• TTL por tipo de dato.
• Revisión y limpieza periódica.

4. Ausencia de router o guardrails

Pasar directamente todo al agente es ineficiente. Necesitas:

• Router: Para filtrar lo que va al agente y lo que se resuelve antes.
• Guardrails: Para limitar pasos, tools, tiempo o bucles.

Esto reduce errores, mejora tiempos y facilita el control operativo.

5. Plan de hardening antes de salir a producción

Antes del General Availability (GA):

• Revisión de herramientas (duplicadas, obsoletas, mal descritas).
• Tests funcionales y de límites.
• Observabilidad activada: logs, métricas, trazas.
• Circuit breakers por si algo falla.

Tabla de anti-patrones comunes

Anti-patrón	Síntoma	Impacto	Corrección
Over-prompting	Prompts largos y frágiles	Fallos frecuentes	Delegar a tools
Tool creep	Modelo usa tools irrelevantes	Coste elevado, errores	Curar y priorizar tools
Sin validación	Salidas inconsistentes	Difícil de depurar	JSON schema + reason codes
Memoria ilimitada	Respuestas erráticas	Pérdida de contexto	TTL + límites + limpieza
Sin router	Latencia alta	Procesamiento innecesario	Agregar router determinista

Checklist técnico antes del GA

• Curado de toolset.
• Validaciones por schema.
• Límite de pasos/tools/tiempo.
• Estrategia de fallback robusta.
• Observabilidad activa.

Preguntas frecuentes

• ¿Cómo saber si el agente ya está listo?
  • Cuando pasa tests, tiene trazas claras, responde dentro de límites y sus decisiones son explicables y consistentes.

Conclusión

La autonomía bien gestionada es una ventaja. Pero subir de nivel no significa liberar el control. Al pasar de workflow a agente, cada nuevo grado de libertad debe ir acompañado de validaciones, observabilidad y diseño técnico sólido. En Lean Mind ayudamos a nuestros clientes a evitar estos anti-patrones con un enfoque riguroso y progresivo en cada etapa de la arquitectura.