English 中文 العربية 日本語 Português

Hermes Agent: Delegação

Última atualização: 2026-08-31

Delegação é a capacidade de gestão do Hermes Agent — diante de tarefas complexas, ele cria sub-Agents para trabalhar em paralelo e depois agrega resultados, como um gerente de projeto distribuindo tarefas para a equipe.

💡 Dica: Delegação é a capacidade-chave do Hermes para tarefas complexas. O Agent principal decompõe, distribui para sub-Agents, monitora progresso e agrega resultados para execução paralela eficiente.

📋 Pré-requisitos: Lição 7 — Sistema de Habilidades, Lição 8 — Ferramentas e Conjuntos

1. O Que Você Vai Aprender

# Conteúdo
❶ Princípios do mecanismo de delegação
❷ Criação e configuração de sub-Agents
❸ Decomposição e distribuição de tarefas
❹ Execução paralela e coordenação
❺ Agregação de resultados e verificação de qualidade

2. História

(1) Problema: Tarefas Grandes em Série São Lentas

Bob pede ao Agent para analisar um projeto grande. O Agent revisa arquivo por arquivo, 20 arquivos levam 30 minutos. Bob pensa: não dá para várias pessoas revisarem ao mesmo tempo?

(2) Solução: Delegar para Sub-Agents em Paralelo

BASH 
me: Revise a qualidade do código de todo o projeto
Agent: O projeto tem 20 arquivos, vou criar 5 sub-Agents para revisão paralela:
  🤖 Sub-Agent-1: src/api/ (4 arquivos)
  🤖 Sub-Agent-2: src/models/ (5 arquivos)
  🤖 Sub-Agent-3: src/utils/ (4 arquivos)
  🤖 Sub-Agent-4: src/views/ (4 arquivos)
  🤖 Sub-Agent-5: tests/ (3 arquivos)
  
  [Executando em paralelo...] Completado em 8 minutos
  
  📊 Relatório consolidado:
  - Problemas de segurança: 3
  - Problemas de performance: 5
  - Problemas de tipos: 7
  - Recomendações: ...

3. Princípios do Mecanismo de Delegação

(1) Arquitetura Agent Principal → Sub-Agent

100% 
graph TB
    A[Agent Principal] --> B[Decomposição de Tarefa]
    B --> C1[Sub-Agent 1]
    B --> C2[Sub-Agent 2]
    B --> C3[Sub-Agent 3]
    
    C1 --> D[Agregação de Resultados]
    C2 --> D
    C3 --> D
    
    D --> E[Verificação de Qualidade]
    E --> F[Saída Final]
    
    A -.->|Monitorar| C1
    A -.->|Monitorar| C2
    A -.->|Monitorar| C3

(2) Tipos de Delegação

Tipo Descrição Cenário
Paralela Sub-Agents executam simultaneamente Revisão de múltiplos arquivos, busca em múltiplas fontes
Serial Sub-Agents executam sequencialmente Tarefas com dependências
Condicional Próximo passo baseado no resultado Etapas que precisam de confirmação humana
Recursiva Sub-Agent cria seus próprios sub-Agents Tarefas em larga escala

4. Criação e Configuração de Sub-Agents

(1) Criação Automática

BASH 
me: Analise a qualidade do código de todos os arquivos Python deste repositório

Agent: Identificados 15 arquivos Python, criando 3 sub-Agents para análise paralela:
  - Sub-Agent "analyzer-1": 5 arquivos
  - Sub-Agent "analyzer-2": 5 arquivos
  - Sub-Agent "analyzer-3": 5 arquivos
  
  Configuração de cada sub-Agent:
  - Modelo: gpt-4o-mini (economia de custo)
  - Ferramentas: fs_read, code_python
  - Habilidade: python-quality-check

(2) Configuração Manual de Sub-Agent

YAML 
delegate:
  sub_agent_template:
    model: "gpt-4o-mini"
    max_tokens: 2048
    timeout: 120
    tools:
      - fs_read
      - code_python
      - web_search
    skills:
      - code-review
      - test-runner
  strategy:
    max_sub_agents: 5
    min_task_size: 1
    cost_limit: 0.10

5. Decomposição e Distribuição de Tarefas

(1) Decomposição Automática

BASH 
me: Pesquise as novidades do React 19, Vue 4 e Svelte 5

Agent: [Decomposição de tarefa]
  Tarefa total: pesquisa de 3 frameworks
  Estratégia: distribuir por framework
  
  🤖 Sub-Agent-1: Pesquisar React 19
  🤖 Sub-Agent-2: Pesquisar Vue 4
  🤖 Sub-Agent-3: Pesquisar Svelte 5
  
  [Execução paralela...]

(2) Regras de Decomposição Personalizadas

YAML 
delegate:
  decomposition:
    - trigger: "revisar projeto"
      strategy: "by_file_type"
      group_by: "extension"
    - trigger: "analisar repositório"
      strategy: "by_directory"
      max_per_group: 10
    - trigger: "pesquisar"
      strategy: "by_topic"
      identify_entities: true

6. Execução Paralela e Coordenação

(1) Monitoramento de Execução

BASH 
/delegate status

# ┌─────────────┬──────────┬─────────┬──────────┐
# │ Sub-Agent   │ Status   │ Progress│ Cost     │
# ├─────────────┼──────────┼─────────┼──────────┤
# │ analyzer-1  │ ✅ Done  │ 5/5     │ $0.03    │
# │ analyzer-2  │ 🔄 Run   │ 3/5     │ $0.02    │
# │ analyzer-3  │ ⏳ Wait  │ 0/5     │ $0.00    │
# └─────────────┴──────────┴─────────┴──────────┘

(2) Tratamento de Erros

YAML 
delegate:
  error_handling:
    on_sub_agent_fail: "retry"
    max_retries: 2
    retry_delay: 5
    on_timeout: "partial_result"
    timeout_per_task: 120
    on_cost_exceed: "warn"

(3) Agregação de Resultados

BASH 
Agent: [Agregando resultados dos sub-Agents]
  
  📊 Relatório de Análise Consolidado
  
  Fonte: 3 sub-Agents, 15 arquivos analisados
  
  Estatísticas de problemas:
  ├── 🔴 Crítico: 2
  │   ├── api/auth.py: Risco de SQL injection
  │   └── utils/crypto.py: Chave hardcoded
  ├── 🟡 Aviso: 5
  └── 🔵 Sugestão: 8
  
  Prioridade de correção: resolver 2 problemas críticos primeiro
  Tempo estimado de correção: 30 minutos

7. Cenários Avançados de Delegação

(1) Delegação Recursiva

BASH 
me: Analise a qualidade do código do monorepo inteiro

Agent: Monorepo com 5 packages, criando 5 sub-Agents:
  Cada sub-Agent decompõe internamente por diretório...
  
  🤖 Sub-Agent-frontend → Cria 3 sub-sub-Agents
  🤖 Sub-Agent-backend → Cria 4 sub-sub-Agents
  🤖 Sub-Agent-shared → Processa diretamente
  🤖 Sub-Agent-infrastructure → Processa diretamente
  🤖 Sub-Agent-tests → Cria 2 sub-sub-Agents

(2) Delegação Humano-Agent

BASH 
me: Ajude-me com o processo de release

Agent: O processo requer confirmação humana, vou executar em etapas:
  
  Step 1: [Auto] Revisão de código → ✅ Passou
  Step 2: [Auto] Executar testes → ✅ Passou
  Step 3: [Aguardando] Deploy para staging?
  me: Confirmar
  Step 4: [Auto] Deploy staging → ✅ Completo
  Step 5: [Aguardando] Deploy para production?
  me: Confirmar
  Step 6: [Auto] Deploy production → ✅ Completo
  Step 7: [Auto] Notificar equipe → ✅ Completo

❓ Perguntas Frequentes

P: Sub-Agents compartilham memória com o Agent principal? R: Compartilham memória de longo prazo e modelo do usuário, mas memória de trabalho é independente. Sub-Agents conhecem preferências do usuário sem interferir no contexto da conversa principal.

P: Máximo de sub-Agents? R: Padrão 5, configurável via delegate.strategy.max_sub_agents. Excessivo aumenta custo e overhead de coordenação.

P: Sub-Agents usam qual modelo? R: Padrão gpt-4o-mini para economia. Configurável para usar o mesmo modelo do Agent principal.

P: Execução paralela causa conflitos? R: Escrita de arquivos usa lock automático para evitar conflitos concorrentes. Leitura sem restrições.

P: Como calcular custo da delegação? R: Tokens de sub-Agents são contados separadamente mas unificados na conta principal. /delegate status mostra custo em tempo real.

P: Sub-Agent falhando afeta o todo? R: Depende da configuração. Padrão: pula tarefas falhas e agrega as completadas. Configurável para abortar tudo.

📖 Resumo

📝 Exercícios

  1. Básico (⭐): Peça ao Agent para buscar paralelamente 3 tópicos diferentes, observe criação de sub-Agents e agregação de resultados.
  2. Intermediário (⭐⭐): Configure sub-Agents usando modelo diferente (gpt-4o-mini), verifique economia de custo, compare tempo vs execução serial.
  3. Avançado (⭐⭐⭐): Desenhe um esquema de delegação recursiva para revisão de código de monorepo completo, incluindo tratamento de erros e estratégia de controle de custo.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%