Tutorial 22: Delega dei Sottoagenti | Easy Understand Hermes Agent

Questo fa parte della serie di tutorial ufficiali di Hermes Agent. Vedi tutti i tutorial

Immagina di essere il capo progetto di un team. Potresti fare tutto da solo, ma sarebbe lento. Invece, affidi compiti specifici ai tuoi colleghi, fornisci loro i dettagli necessari e aspetti che ti riferiscano i risultati. È esattamente ciò che fa la Delega ai Sottoagenti per Hermes Agent — permette al tuo agente principale di assumere “lavoratori” temporanei per gestire i compiti in background.

Passo 1: Comprendi l’Idea di Base

Quando chiami delegate_task, Hermes crea uno o più agenti figli (sottoagenti). Ogni figlio:

Ottiene una conversazione completamente nuova — non sa nulla della tua cronologia chat.
Ha accesso agli stessi strumenti dell’agente padre.
Opera nella propria sessione terminale isolata.
Restituisce solo un riepilogo finale al padre.

Pensalo come mandare un collega a fare ricerche su un argomento. Non assiste all’intera riunione — gli consegni solo un appunto con il compito e il contesto, e torna con un rapporto.

Passo 2: Delega un Singolo Compito

Il caso d’uso più semplice: un compito, un sottoagente.

delegate_task(
    goal="Debug why tests fail",
    context="Error: assertion in test_foo.py line 42"
)

Il goal dice al sottoagente cosa fare. Il context gli fornisce tutto ciò di cui ha bisogno per farlo.

Passo 3: Delega Più Compiti in Parallelo

Ti servono più cose fatte contemporaneamente? Passa una lista di compiti. Di default, Hermes esegue fino a 3 sottoagenti in contemporanea (puoi cambiarlo — non c’è un limite rigido).

delegate_task(tasks=[
    {"goal": "Research topic A", "context": "Focus on recent primary sources"},
    {"goal": "Research topic B", "context": "Compare the leading explanations"},
    {"goal": "Fix the build", "context": "Project root: /home/user/project"}
])

Ogni sottoagente lavora in modo indipendente. Il padre attende che tutti finiscano, poi combina i risultati.

Passo 4: La Regola d’Oro — I Sottoagenti Non Sanno Nulla

Questo è il punto più importante, quindi ascolta bene:

I sottoagenti partono con zero conoscenza della tua conversazione.

Se dici “Correggi l’errore” senza spiegare cos’è “l’errore”, il sottoagente sarà perso. Devi passare tutto il contesto necessario nei campi goal e context.

Ecco un esempio sbagliato:

# BAD - subagent has no idea what "the error" is
delegate_task(goal="Fix the error")

E la versione corretta:

# GOOD - subagent has all context it needs
delegate_task(
    goal="Fix the TypeError in api/handlers.py",
    context="""The file api/handlers.py has a TypeError on line 47:
    'NoneType' object has no attribute 'get'.
    The function process_request() receives a dict from parse_body(),
    but parse_body() returns None when Content-Type is missing.
    The project is at /home/user/myproject and uses Python 3.11."""
)

Pensa al context come a un documento informativo. Più sei specifico, migliore sarà il lavoro del sottoagente.

Passo 5: Usalo per Flussi di Lavoro Reali

Ricerca in Parallelo

Raccogli informazioni su più argomenti contemporaneamente:

delegate_task(tasks=[
    {
        "goal": "Research the current state of WebAssembly in 2025",
        "context": "Focus on: browser support, non-browser runtimes, language support"
    },
    {
        "goal": "Research the current state of RISC-V adoption in 2025",
        "context": "Focus on: server chips, embedded systems, software ecosystem"
    },
    {
        "goal": "Research quantum computing progress in 2025",
        "context": "Focus on: error correction breakthroughs, practical applications, key players"
    }
])

Revisione + Correzione del Codice

Affida un lavoro completo di revisione e correzione a un contesto nuovo:

delegate_task(
    goal="Review the authentication module for security issues and fix any found",
    context="""Project at /home/user/webapp.
    Auth module files: src/auth/login.py, src/auth/jwt.py, src/auth/middleware.py.
    The project uses Flask, PyJWT, and bcrypt.
    Focus on: SQL injection, JWT validation, password handling, session management.
    Fix any issues found and run the test suite (pytest tests/auth/)."""
)

Riepilogo

La delega ai sottoagenti è il tuo modo per parallelizzare il lavoro in Hermes Agent. Ricorda questi punti chiave:

Usa delegate_task per un singolo compito o un lotto di compiti.
Fornisci sempre il contesto completo — i sottoagenti partono da zero.
Fino a 3 sottoagenti in contemporanea di default, configurabile se ti servono di più.
Ogni sottoagente restituisce un riepilogo strutturato — cosa ha fatto, cosa ha trovato, file modificati, problemi incontrati.

È come avere un team di assistenti che sanno solo ciò che gli dici — quindi digli tutto ciò di cui hanno bisogno.

Prossimo: Tutorial 23 — Kanban: una board condivisa e persistente per la collaborazione multi-agente.