Elegir un framework de agentes: lo que de verdad importa
Cualquier artículo que ordene frameworks de agentes por nombre queda desfasado antes de indexarse. Estas librerías reescriben sus abstracciones centrales cada pocas versiones, y la que hoy gana una comparativa puede haber cambiado cuando tu proyecto salga.
Por eso esta guía hace algo más duradero: enumera las ocho preguntas que determinan si dentro de seis meses seguirás contento con tu elección, y explica el coste de cada respuesta. Llévalas a la lista corta del momento y obtendrás una decisión defendible.
Las ocho preguntas, por orden de importancia#
- ¿Puedo leer el bucle? Si no encuentras el fichero donde la salida del modelo se convierte en llamada, no podrás depurar una mala ejecución.
- ¿Qué ocurre ante un fallo de herramienta: me llega, o se reintenta invisible con otro prompt?
- ¿Mi prompt es el prompt del framework? El texto de sistema que no escribiste te sorprenderá en una auditoría.
- ¿Se puede persistir y reanudar el estado, o una caída pierde la ejecución?
- ¿Cómo se definen las herramientas y puedo reutilizar esas definiciones fuera?
- ¿Cómo son las actualizaciones: han renombrado abstracciones centrales en dos versiones?
- ¿Puedo cambiar de modelo sin cambiar de framework?
- ¿Cuánto añade al arranque en frío y a cada turno?
Tres categorías, tres tratos distintos#
| Categoría | Obtienes | Cedes | Sensato cuando |
|---|---|---|---|
| SDK del proveedor y tu bucle | Visibilidad total, pocas dependencias | Reintentos, estado y persistencia los escribes tú | Un agente, pocas herramientas, mucha depuración |
| Librería de orquestación | Estado duradero, ramas, reintentos, reanudación | Algo de visibilidad; ruido de actualizaciones | Flujos largos o multi-paso |
| Plataforma gestionada | Hosting, trazas, evaluación, interfaz | Portabilidad; precio por asiento o ejecución | Equipo pequeño, tarea estándar, prueba rápida |
Escribe tú lo que debe seguir siendo tuyo#
Elijas lo que elijas, cuatro activos deben vivir en tu repositorio en una forma que ningún framework posea: los prompts, las definiciones de herramientas con sus esquemas JSON, el conjunto de evaluación y el formato de traza. Es lo que costó trabajo de verdad. Si son datos simples con adaptadores finos, cambiar de framework es un día. Si son decoradores y herencia, cambiar es reescribir — y por eso no cambiarás, aunque debas.
La prueba que nadie hace y todos deberían#
Antes de decidir, construye el mismo agente pequeño dos veces: con tu favorito y con el SDK del proveedor y un bucle escrito a mano. Mismas tres herramientas, mismos diez casos. No mides precisión — será parecida. Mides cuánto tardaste, cuán legible es la traza y qué fácil fue averiguar por qué falló el caso siete. Esa tarde le ha ahorrado a todos los equipos que conocemos mucho más de lo que costó.
Guarda la versión hecha a mano. Será tu referencia cuando debas probar si una rareza viene de tu prompt o del framework.
Señales de que se te ha quedado pequeño#
- Lees el código del framework más que el tuyo.
- Mantienes un parche o un fork para conseguir un comportamiento.
- Aplazas actualizaciones por renombrados y vas dos versiones mayores por detrás.
- La mitad de tu prompt existe para contrarrestar texto inyectado.
- El tracing necesita un exportador propio porque el incluido oculta argumentos.
Preguntas frecuentes
¿Necesito framework para un primer agente?
No. Un primer agente con tres herramientas es un bucle, una lista de esquemas y una condición de parada. Hacerlo a mano una vez enseña qué haría el framework por ti y mejora mucho la elección posterior.
¿Una plataforma gestionada es una trampa?
No, si mantienes prompts, esquemas y evaluación portables. Las plataformas llegan de verdad rápido a un resultado. El riesgo no es la plataforma: es que tu propiedad intelectual exista solo como configuración dentro.
¿Cuánto afecta el framework a la precisión?
Mucho menos de lo que se cree. La precisión viene del diseño de herramientas, del anclaje y de la evaluación. Los frameworks afectan a velocidad, depuración y funciones operativas.
framework de agentes iamejores frameworks de agentescomparativa librerías agentesorquestación llmelegir stack de agentes