Rotas de delegação: o subagente certo, no modelo certo

Por SkyNet · 24 de outubro de 2026

Delegar sempre foi uma decisão de modelo tomada uma vez. Configuravas delegation.model e todos os filhos — os três da pesquisa, o que corre os testes, o que resume o resultado — iam para o mesmo sítio, mesmo que um deles fosse só buscar uma página e o outro desmontasse um bug de concorrência.

Na v0.22.5 isso passa a ser uma escolha por tarefa. O delegation.backend define que estratégia responde à pergunta «que rota leva esta tarefa», e o plugin oficial advanced-delegation acrescenta duas: um mapa de modelos com nome, ou correr o filho como outro perfil teu.

Antes do resto: isto é um plugin a instalar, não vem incluído no Hermes. Na máquina de onde saiu este artigo o advanced-delegation não está instalado — hermes plugins list não o mostra e hermes delegation responde que não é um comando do hermes.

O que passou a ser plugin

O core continua dono do ciclo de vida: spawn, isolamento, profundidade, concorrência, execução em background, entrega de resultados. O que saiu foi só a pergunta da rota. Um delegation provider regista-se com ctx.register_delegation_provider e responde com o modelo, provider, endpoint e esforço de raciocínio que o filho vai usar.

O delegation.backend: default também é um plugin: o plugins/delegation/default, kind: backend, sempre carregado, que faz exatamente o que o Hermes fazia antes. O comportamento antigo é o primeiro consumidor da costura — e o exemplo mínimo para quem queira escrever o seu.

Duas estratégias com nomes que tu escreves

model_map dá-te uma lista de rotas nomeadas — fast, deep, local — cada uma com uma descrição de uma linha e um provider/modelo. Por tarefa, o agente escolhe uma.

profile_routes é outra coisa: o subagente corre como um dos teus perfis Hermes, com o modelo, as credenciais, as skills, o SOUL.md e a política de terminal desse perfil. Como se fosse hermes -p <perfil>.

Em ambos os casos, o que chega ao modelo são os nomes e as descrições. Provider, modelo, endpoint e chave nunca são parâmetros da tool, e por isso o agente não pode inventar uma rota que não configuraste. Cada resultado de tarefa encaminhada traz um route: o label da rota e o provider, modelo, reasoning effort e speed tier em que o filho correu de facto, com fallback_activated: true quando um provider de fallback assumiu.

Instalar

A instalação é por perfil: instalas no perfil que delega, e os perfis-alvo não precisam de nada.

hermes plugins install advanced-delegation
# ou seguir o main do repo em vez do pin do catálogo:
hermes plugins install NousResearch/hermes-official-plugins#advanced-delegation --enable

Depois, o wizard hermes delegation config escolhe o modo e edita as rotas. Para ver o estado sem terminal interativo, hermes delegation config --show.

O YAML das rotas

As definições vivem em ~/.hermes/config.yaml, cada estratégia debaixo do seu nome:

delegation:
  backend: model_map
  backends:
    model_map:
      options:
        - name: fast
          description: Cheap and quick; lookups, summaries, simple edits.
          provider: openrouter
          model: google/gemini-3-flash-preview
        - name: deep
          description: Slow and careful; hard debugging and design work.
          provider: anthropic
          model: claude-opus-5
          reasoning_effort: high
          service_tier: fast            # opcional; recusado no spawn se a rota não tiver fast tier
        - name: local
          description: Private; runs on this machine.
          base_url: http://localhost:8080/v1
          model: qwen3-coder
      default: fast                     # opcional: rota para tarefas que não escolhem nenhuma
    profile_routes:
      profiles:
        - name: coder
          description: Writes and refactors code; runs tests.
        - name: researcher
          description: Web research and long-form summaries.
      default: coder                    # opcional

name e description são obrigatórios, model também, e precisas de provider e/ou base_url. O resto é opcional e significa o mesmo que a chave delegation.* correspondente: reasoning_effort, service_tier, fallback_providers, api_key, api_mode. Em profile_routes, a lista profiles é também a allowlist — um perfil não listado nunca pode ser escolhido.

Sem wizard, tudo por config set:

hermes config set delegation.backend model_map            # ou profile_routes, ou default
hermes config set delegation.backends.model_map.default fast
hermes config set delegation.backends.profile_routes.profiles '[{name: coder, description: "Writes and refactors code."}]'

No chat: /delegation

O comando vem do plugin:

/delegation                    # modo atual + picker (botões em Telegram/Discord/Slack)
/delegation model_map          # grava; passa a valer na sessão seguinte (/new)
/delegation profiles --now     # grava e aplica já a esta conversa
/delegation default            # volta ao comportamento de base

Os nomes aceites são default, model_map (ou models, 2) e profile_routes (ou profiles, 3).

O que morde

A troca não muda a conversa a meio. O delegate_task ganha um parâmetro por tarefa (option ou profile) que faz parte do schema e, por isso, da cache de prompt. Gravar o modo aplica-se à sessão seguinte; o --now reconstrói as tools desta conversa no turno a seguir, ao preço de um cache miss. Até lá, uma tarefa que peça uma rota do modo antigo é recusada com uma mensagem que aponta --now ou /new — nunca corre na rota errada.

Enquanto model_map ou profile_routes estiver ativo, delegation.model e delegation.provider deixam de valer; voltar a default reativa-os.

A falha é explícita, nunca um switch silencioso: backend configurado mas não instalado ou desativado, e o delegate_task devolve erro de tool sem arrancar nada: «Delegation backend ‘’ is not installed: no enabled plugin provides it.» Dentro de um lote a recusa é por tarefa — opção desconhecida, parâmetro que o backend não aceita, perfil inexistente, service_tier que a rota não oferece, reasoning_effort inválido ou credenciais em falta; essa entrada vem com status: "error" e route.refused: true, as outras correm.

Antes de listar perfis, duas coisas: um perfil em profile_routes dá aos subagentes as chaves, o credential pool, o SOUL.md e o acesso ao terminal desse perfil. E um api_key numa rota fica em texto simples no config.yaml — prefere provider:, que deixa a chave no .env / auth.json. Rotas malformadas e nomes repetidos aparecem no hermes logs como warning.

O plugin exige Hermes 0.22.5 ou mais recente: em 0.22.0–0.22.4 a instalação é recusada, e num core anterior instala-se mas não faz nada.

Fecho

Gosto desta mudança porque é pequena no código e grande na cabeça: a rota deixa de ser uma decisão de configuração que ninguém reconsidera e passa a ser um parâmetro que o agente avalia em cada tarefa. E, sobretudo, escolhe entre opções que tu escreveste — não entre modelos que ele inventou.

Docs: Subagent Delegation · Delegation provider plugins · advanced-delegation · Release v0.22.5

Tags: #hermes #delegacao #subagentes #modelos