Tutorial 22: Delegación de Subagentes | Easy Understand Hermes Agent

Esto es parte de la serie oficial de tutoriales de Hermes Agent. Ver todos los tutoriales

Imagina que eres el líder de equipo en un proyecto. Podrías hacerlo todo tú mismo, pero eso es lento. En su lugar, repartes tareas específicas a tus compañeros, les das los detalles que necesitan y esperas a que te informen. Eso es exactamente lo que hace la Delegación de Subagentes en Hermes Agent: permite que tu agente principal contrate “trabajadores” temporales para manejar tareas en segundo plano.

Paso 1: Entiende la Idea Básica

Cuando llamas a delegate_task, Hermes crea uno o más agentes hijos (subagentes). Cada hijo:

Obtiene una conversación completamente nueva — no sabe nada de tu historial de chat.
Tiene acceso a las mismas herramientas que el agente principal.
Se ejecuta en su propia sesión de terminal aislada.
Devuelve solo un resumen final al agente principal.

Piénsalo como enviar a un colega a investigar un tema. No se sienta a escuchar toda tu reunión — solo le entregas una nota con la tarea y el contexto, y vuelve con un informe.

Paso 2: Delega una Tarea Única

El caso de uso más simple: una tarea, un subagente.

delegate_task(
    goal="Depurar por qué fallan los tests",
    context="Error: aserción en test_foo.py línea 42"
)

El goal le dice al subagente qué hacer. El context le da todo lo que necesita para hacerlo.

Paso 3: Delega Múltiples Tareas en Paralelo

¿Necesitas hacer varias cosas a la vez? Pasa una lista de tareas. Por defecto, Hermes ejecuta hasta 3 subagentes simultáneamente (puedes cambiar esto — no hay un límite estricto).

delegate_task(tasks=[
    {"goal": "Investigar el tema A", "context": "Enfócate en fuentes primarias recientes"},
    {"goal": "Investigar el tema B", "context": "Compara las explicaciones principales"},
    {"goal": "Arreglar la compilación", "context": "Raíz del proyecto: /home/usuario/proyecto"}
])

Cada subagente trabaja de forma independiente. El agente principal espera a todos y luego combina los resultados.

Paso 4: La Regla de Oro — Los Subagentes No Saben Nada

Este es el punto más importante, así que presta atención:

Los subagentes comienzan con cero conocimiento de tu conversación.

Si dices “Arregla el error” sin explicar qué es “el error”, el subagente estará perdido. Debes pasar todo el contexto necesario en los campos goal y context.

Aquí tienes un mal ejemplo:

# MAL - el subagente no tiene idea de qué es "el error"
delegate_task(goal="Arreglar el error")

Y la versión buena:

# BIEN - el subagente tiene todo el contexto que necesita
delegate_task(
    goal="Arreglar el TypeError en api/handlers.py",
    context="""El archivo api/handlers.py tiene un TypeError en la línea 47:
    'NoneType' object has no attribute 'get'.
    La función process_request() recibe un dict de parse_body(),
    pero parse_body() devuelve None cuando falta Content-Type.
    El proyecto está en /home/usuario/miproyecto y usa Python 3.11."""
)

Piensa en el context como un documento informativo. Cuanto más específico seas, mejor será el trabajo del subagente.

Paso 5: Úsalo para Flujos de Trabajo del Mundo Real

Investigación en Paralelo

Reúne información sobre múltiples temas a la vez:

delegate_task(tasks=[
    {
        "goal": "Investigar el estado actual de WebAssembly en 2025",
        "context": "Enfócate en: soporte de navegadores, runtimes fuera del navegador, soporte de lenguajes"
    },
    {
        "goal": "Investigar el estado actual de la adopción de RISC-V en 2025",
        "context": "Enfócate en: chips para servidores, sistemas embebidos, ecosistema de software"
    },
    {
        "goal": "Investigar el progreso de la computación cuántica en 2025",
        "context": "Enfócate en: avances en corrección de errores, aplicaciones prácticas, actores clave"
    }
])

Revisión de Código + Corrección

Entrega un trabajo completo de revisión y corrección a un contexto nuevo:

delegate_task(
    goal="Revisar el módulo de autenticación en busca de problemas de seguridad y corregir los encontrados",
    context="""Proyecto en /home/usuario/webapp.
    Archivos del módulo de autenticación: src/auth/login.py, src/auth/jwt.py, src/auth/middleware.py.
    El proyecto usa Flask, PyJWT y bcrypt.
    Enfócate en: inyección SQL, validación de JWT, manejo de contraseñas, gestión de sesiones.
    Corrige cualquier problema encontrado y ejecuta la suite de tests (pytest tests/auth/)."""
)

Resumen

La delegación de subagentes es tu forma de paralelizar el trabajo en Hermes Agent. Recuerda estos puntos clave:

Usa delegate_task para una tarea o un lote de tareas.
Siempre proporciona contexto completo — los subagentes empiezan desde cero.
Hasta 3 subagentes simultáneos por defecto, configurable si necesitas más.
Cada subagente devuelve un resumen estructurado — qué hizo, qué encontró, archivos modificados, problemas encontrados.

Es como tener un equipo de asistentes que solo saben lo que les dices — así que diles todo lo que necesiten.