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 ‘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