Subagents (Subagentes y Delegación)

1. Visión general del concepto y problema sistémico

En tareas de desarrollo complejas, una parte significativa del tiempo se dedica a la "sucia" labor de exploración: búsqueda por palabras clave en cientos de archivos, lectura de documentación, revisión de registros del sistema o verificación de decenas de dependencias.

Si todas estas operaciones son realizadas por un único agente principal dentro de un solo diálogo:

1. Contaminación del contexto (Context Pollution): Miles de líneas de código y registros crudos desplazan las instrucciones iniciales del sistema del usuario.
2. Pérdida de atención (Lost-in-the-Middle): El agente comienza a confundirse con sus propios borradores intermedios, perdiendo el objetivo original.
3. Cuello de botella secuencial (Sequential Bottleneck): El agente se ve obligado a revisar cada fuente en secuencia, gastando minutos donde se podría paralelizar el trabajo en segundos.

El patrón de subagentes (Subagents) implementa el principio de aislamiento del contexto de ejecución: el agente padre genera ejecutores secundarios con una ventana de atención limpia, delega la rutina y recibe de vuelta solo un resumen refinado y estructurado.

2. Taxonomía arquitectónica y modelo mental

Según la forma de organizar el trabajo de los subagentes, se destacan tres topologías principales:

• 1. Fork-Join (Patrón Map-Reduce): El agente padre divide una gran tarea en $N$ partes independientes (por ejemplo, analizar 4 microservicios separados), lanza simultáneamente 4 subagentes paralelos (Fork), espera su finalización y fusiona los resultados en un único informe (Join).
• 2. Trabajador efímero de inmersión profunda (Transient Deep-Dive Worker): El subagente se genera para una operación específica: por ejemplo, acceder al sitio de documentación, pasar la autorización, encontrar un ejemplo de uso del endpoint y devolver solo 5 líneas de código. Después de esto, el contenedor del subagente se elimina.
• 3. Árbol jerárquico con límite de profundidad (Bounded Delegation Tree): El proceso padre gestiona subagentes de primer nivel, y estos pueden generar trabajadores de segundo nivel según sea necesario. Para evitar el consumo descontrolado de recursos, la profundidad de la recursión se limita estrictamente (max_depth = 2).

3. Pipeline técnico y mecánica interna

El ciclo de vida del trabajo de un subagente:

1. Llamada de Delegación (Delegation Call): El agente principal invoca una herramienta especial de lanzamiento: invoke_subagent(task_name="grep_auth_logs", prompt="...", tools=["grep", "cat"]).
2. Aislamiento del Sandbox de Contexto (Context Sandbox Isolation): El runtime inicia una nueva sesión LLM con un contexto limpio. Se inyecta solo la instrucción para la subtarea y una lista limitada de herramientas permitidas.
3. Ejecución Autónoma (Autonomous Execution): El subagente ejecuta su propio ciclo ReAct, comete errores, prueba hipótesis y forma el resultado final, sin molestar al agente padre con mensajes intermedios.
4. Síntesis y Recolección de Basura (Synthesis & Garbage Collection): El registro crudo del diálogo del subagente se archiva o se destruye. El agente principal recibe un mensaje de la herramienta con un breve resumen (por ejemplo: «Se encontraron 2 fugas de memoria en el archivo worker.ts: líneas 14 y 89»).

4. Escenarios prácticos de ingeniería en producción

01. Auditoría de seguridad paralela de un gran monorepo

El arquitecto principal genera tres subagentes simultáneamente:

• Trabajador 1: escanea el backend en busca de inyecciones SQL y consultas crudas inseguras.
• Trabajador 2: verifica el frontend en busca de XSS y llamadas peligrosas a dangerouslySetInnerHTML.
• Trabajador 3: analiza archivos de configuración de Docker y CI/CD en busca de puertos abiertos y imágenes no endurecidas. Cada subagente lee cientos de archivos, pero el arquitecto principal recibe una tabla resumen compacta con tres puntos críticos.

02. Análisis en segundo plano de grandes registros de servidor

En lugar de pasar 50 megabytes de registros de Nginx al contexto principal, se lanza un subagente analista. Filtra localmente los registros a través de grep/awk, encuentra un pico anómalo de códigos de estado 500 y devuelve al agente principal solo el stack trace destacado.

03. Investigación de bibliotecas externas sin perder el enfoque

Mientras el agente de código diseña la arquitectura del servicio, envía un subagente a leer la documentación oficial de Stripe API. El subagente se familiariza con la sintaxis de los checkouts y devuelve un ejemplo mínimo de código listo.

5. Errores comunes, trampas y seguridad

• Tormenta de tokens y límites de tasa (TPM Spikes): Lanzar 10 subagentes simultáneamente crea un enorme pico de solicitudes al proveedor, lo que lleva a errores en cascada 429 Too Many Requests. Siempre use colas de tareas con un límite de grupo (por ejemplo, un máximo de 3 trabajadores simultáneos).
• Conflictos de escritura paralela (Race Conditions): Si dos subagentes intentan editar el mismo archivo en el repositorio al mismo tiempo, puede ocurrir sobrescritura o corrupción del código. Proporcione a los subagentes de investigación permisos solo de lectura.
• Recursión infinita de delegación (Fork Bomb): Un subagente determina que la tarea es demasiado compleja y genera 5 subagentes más, cada uno haciendo lo mismo. Siempre prohíba a los agentes secundarios invocar la herramienta invoke_subagent.