CCDV-P · Arquitectura avanzada de agentes y orquestación
Patrones multiagente en producción y cómo fallan entre sí
Un sistema de conciliación de facturas usa un supervisor que reparte el trabajo entre cinco subagentes. En producción, a veces una factura se procesa dos veces, a veces ninguna, y el supervisor reporta “todo listo” aunque un subagente haya devuelto un error vacío. Nadie tocó el modelo: las fallas están en las fronteras entre agentes.
Qué patrón para qué
En orquestación multiagente (multi-agent orchestration) los patrones se evalúan por lo que cuestan y por cómo fallan, no por lo vistosos:
| Patrón | Sirve cuando | Cómo falla |
|---|---|---|
| Supervisor y trabajadores (supervisor/worker) | la tarea se descompone en partes que se reparten y se integran | el supervisor se vuelve cuello de botella o integra mal resultados incompletos |
| Subagentes en paralelo | las partes son independientes entre sí | conflictos al escribir lo mismo, costo que se multiplica, resultados que llegan en desorden |
| Jerarquías de más de dos niveles | dominios muy separados | se pierde contexto en cada traspaso y cada nivel suma latencia y costo |
| Un solo agente con buenas herramientas | la mayoría de los casos | contexto que se llena en tareas muy largas |
La regla de partida es la misma que en Foundations: no se agregan agentes sin un problema medido que lo justifique.
Límites de delegación y de contexto
Cada subagente corre en su propia ventana de contexto. Eso es una ventaja (el supervisor no se llena de ruido) y un riesgo (el subagente no sabe nada de lo que no le pasaron). El aislamiento de contexto (context isolation) exige un contrato explícito:
- Qué recibe: la tarea, los datos que necesita y el criterio de terminado. No “lo que se habló antes”.
- Qué devuelve: un resultado estructurado y breve, con estado (éxito, parcial, error) y el motivo del error. Un error que vuelve como texto libre o como lista vacía se confunde con “no hay resultados”.
- Qué puede hacer: solo las herramientas de su tarea.
Un subagente que falla en silencio es la causa más común de supervisores que informan éxito falso.
Comunicación y trabajo repetido
Cuando los agentes comparten estado (una cola, una base, un archivo), las escrituras tienen que ser idempotentes y las tareas tienen que tener identificador: así, si un trabajador se cae y la tarea se reasigna, no se procesa dos veces. Los resultados se integran por identificador de tarea, no por orden de llegada.
Humano en el circuito y aprobaciones
Un flujo de aprobación (approval flow) pide a una persona que autorice lo que el sistema no debería decidir solo: acciones irreversibles, montos altos, comunicaciones externas. Se diseña con tres piezas: el punto donde el agente se frena, qué ve la persona (la acción propuesta y la evidencia, no todo el historial) y qué pasa si nadie responde (esperar, escalar o cancelar; nunca seguir). Pedir aprobación para todo genera fatiga y aprobaciones sin leer.
Las trampas típicas
- Sumar agentes para “dividir responsabilidades” sin evidencia de que un solo agente no alcanza.
- Pasarle al subagente todo el historial para que “tenga contexto”.
- Dejar que los errores de los subagentes se pierdan o se conviertan en resultados vacíos.
- Paralelizar tareas que escriben sobre el mismo recurso.
- Aprobación humana en cada paso, o en ninguno.
En el examen
Si el escenario muestra un resultado perdido, duplicado o un éxito falso, buscá la opción que arregla el contrato entre agentes: resultados estructurados con estado y causa, identificadores de tarea e idempotencia. Descartá “agregar otro agente que revise al primero” si el problema es de comunicación, y “pasar más contexto” si el problema es de aislamiento.
Pregunta rápida
Una pregunta del simulacro sobre este dominio. Cuenta para tu progreso.
A market-intelligence assistant answers questions such as "How is competitor X positioned across five regions?" A single agent researches the regions one after another, so a typical question takes eleven minutes, mostly waiting on web searches. Its context also fills with raw search results from the early regions, and the answers about the last regions are noticeably weaker.
The regional research tasks do not depend on one another. Only the final comparison needs the findings of all five, and the product team wants answers in about three minutes.
How should the team restructure the system?