Tutorial 22: Delegação de Subagentes | Easy Understand Hermes Agent

Isto faz parte da série oficial de tutoriais do Hermes Agent. Ver todos os tutoriais

Imagine que você é o líder de um projeto. Você poderia fazer tudo sozinho, mas isso é lento. Em vez disso, você distribui tarefas específicas para seus colegas, dá a eles os detalhes necessários e espera que eles reportem de volta. É exatamente isso que a Delegação de Subagentes faz pelo Hermes Agent — ela permite que seu agente principal contrate “trabalhadores” temporários para lidar com tarefas em segundo plano.

Passo 1: Entenda a Ideia Básica

Quando você chama delegate_task, o Hermes cria um ou mais agentes filhos (subagentes). Cada filho:

Começa com uma conversa totalmente nova — ele não sabe nada sobre o seu histórico de chat.
Tem acesso às mesmas ferramentas que o agente pai.
Executa em sua própria sessão de terminal isolada.
Retorna apenas um resumo final para o agente pai.

Pense nisso como enviar um colega para pesquisar um tópico. Ele não participa da sua reunião inteira — você apenas entrega a ele uma nota com a tarefa e o contexto, e ele volta com um relatório.

Passo 2: Delegue uma Única Tarefa

O caso de uso mais simples: uma tarefa, um subagente.

delegate_task(
    goal="Depurar por que os testes falham",
    context="Erro: assertion em test_foo.py linha 42"
)

O goal diz ao subagente o que fazer. O context fornece tudo o que ele precisa para fazer.

Passo 3: Delegue Múltiplas Tarefas em Paralelo

Precisa de várias coisas ao mesmo tempo? Passe uma lista de tarefas. Por padrão, o Hermes executa até 3 subagentes simultaneamente (você pode mudar isso — não há limite rígido).

delegate_task(tasks=[
    {"goal": "Pesquisar tópico A", "context": "Focar em fontes primárias recentes"},
    {"goal": "Pesquisar tópico B", "context": "Comparar as principais explicações"},
    {"goal": "Corrigir o build", "context": "Raiz do projeto: /home/user/project"}
])

Cada subagente trabalha de forma independente. O agente pai espera por todos e depois combina os resultados.

Passo 4: A Regra de Ouro — Subagentes Não Sabem de Nada

Este é o ponto mais importante, então preste atenção:

Subagentes começam com zero conhecimento da sua conversa.

Se você disser “Corrija o erro” sem explicar o que é “o erro”, o subagente ficará perdido. Você deve passar todo o contexto necessário nos campos goal e context.

Aqui está um exemplo ruim:

# RUIM - o subagente não tem ideia do que é "o erro"
delegate_task(goal="Corrigir o erro")

E a versão boa:

# BOM - o subagente tem todo o contexto necessário
delegate_task(
    goal="Corrigir o TypeError em api/handlers.py",
    context="""O arquivo api/handlers.py tem um TypeError na linha 47:
    'NoneType' object has no attribute 'get'.
    A função process_request() recebe um dict de parse_body(),
    mas parse_body() retorna None quando Content-Type está ausente.
    O projeto está em /home/user/myproject e usa Python 3.11."""
)

Pense no context como um documento de briefing. Quanto mais específico você for, melhor será o trabalho do subagente.

Passo 5: Use para Fluxos de Trabalho Reais

Pesquisa Paralela

Reúna informações sobre vários tópicos ao mesmo tempo:

delegate_task(tasks=[
    {
        "goal": "Pesquisar o estado atual do WebAssembly em 2025",
        "context": "Focar em: suporte de navegadores, runtimes fora do navegador, suporte de linguagens"
    },
    {
        "goal": "Pesquisar o estado atual da adoção de RISC-V em 2025",
        "context": "Focar em: chips de servidor, sistemas embarcados, ecossistema de software"
    },
    {
        "goal": "Pesquisar o progresso da computação quântica em 2025",
        "context": "Focar em: avanços em correção de erros, aplicações práticas, principais players"
    }
])

Revisão de Código + Correção

Passe um trabalho completo de revisão e correção para um contexto novo:

delegate_task(
    goal="Revisar o módulo de autenticação para problemas de segurança e corrigir qualquer um encontrado",
    context="""Projeto em /home/user/webapp.
    Arquivos do módulo de auth: src/auth/login.py, src/auth/jwt.py, src/auth/middleware.py.
    O projeto usa Flask, PyJWT e bcrypt.
    Focar em: injeção de SQL, validação de JWT, manipulação de senhas, gerenciamento de sessão.
    Corrija qualquer problema encontrado e execute a suíte de testes (pytest tests/auth/)."""
)

Resumo

A delegação de subagentes é a sua maneira de paralelizar o trabalho no Hermes Agent. Lembre-se destes pontos-chave:

Use delegate_task para uma tarefa ou um lote de tarefas.
Sempre forneça contexto completo — subagentes começam do zero.
Até 3 subagentes simultâneos por padrão, configurável se precisar de mais.
Cada subagente retorna um resumo estruturado — o que fez, o que encontrou, arquivos alterados, problemas encontrados.

É como ter uma equipe de assistentes que só sabem o que você conta a eles — então conte tudo o que eles precisam.