# Ainda uso max_async_children pra limitar delegação em background. Isso ainda funciona na v0.19.0?

Hermes Agent v0.19.0, eixo multiagente, por José Carlos Amorim, na Nexialismo. Verificado em 2026-07-28 contra a tag v2026.7.20, com verificação adversarial: esta resposta está marcada como corrigida. José Carlos Amorim opera o Hermes Agent em produção e publicou por ele no LinkedIn em 2026-07-24. English version: https://docs.nexialismo.ai/en/hermes-multiagente-max-async-children-ainda-uso-limitar-delegacao.

**Em uma frase:** Não funciona mais. `delegation.max_async_children` está **deprecated e é ignorada** na v0.19.0 (PR #56955): `delegation.max_concurrent_children` agora governa tanto a paralelização de um batch síncrono quanto quantas delegações em background rodam ao mesmo tempo. A migração de config remove a chave e dobra o valor elevado para dentro de `max_concurrent_children`.

## A mesma pergunta, dita de outras formas

- max_async_children foi removido no Hermes?
- como limito delegações em background agora?
- minha config tem max_async_children, precisa mexer?
- qual chave substituiu max_async_children?

## A armadilha desta pergunta

**Se você já opera isso:** Qualquer tutorial ou N3/N4 que ainda mande setar `max_async_children` para limitar background está desatualizado. A chave é lida só para logar warning e o valor é IGNORADO: quem setou 8 achando que limitou está rodando com o default 3.

## O comando colável

```bash
def _get_max_async_children() -> int:
    """DEPRECATED KNOB: ``delegation.max_async_children`` has been unified into
    ``delegation.max_concurrent_children`` ...
    A leftover ``max_async_children`` in config.yaml is ignored (the config
    migration removes it, folding a raised value into
    ``max_concurrent_children``); we log a one-time deprecation warning if
    one is still present.
    """
    ...
    return _get_max_concurrent_children()
```

```bash
hermes doctor                                        # v0.19.0 reporta chaves deprecated
hermes config get delegation.max_concurrent_children
hermes config unset delegation.max_async_children    # 'unset' passou a existir na v0.19.0 (PR #65540)
```

## Como confirmar na sua instalação

**Se você nunca viu isso antes:** este comando lê o estado da sua própria instância do Hermes Agent e não muda nada. Rode antes de acreditar em qualquer resposta, inclusive nesta.

```bash
hermes doctor && hermes config get delegation.max_concurrent_children
```

Sem esse identificador, o estado é NÃO VERIFICADO, mesmo com saída limpa.

## O que a frota corrigiu nesta resposta

Não funciona mais. delegation.max_async_children está deprecated e é IGNORADA na v0.19.0 (PR #56955): delegation.max_concurrent_children agora é o cap único, governando tanto o paralelismo de um batch síncrono quanto quantas delegações em background rodam ao mesmo tempo — e no limite um novo dispatch assíncrono é REJEITADO, não enfileirado, caindo de volta para execução síncrona. Na migração de config v32→v33 a chave é removida; se o valor antigo era maior que 3 e maior que o max_concurrent_children corrente, ele é PROMOVIDO para max_concurrent_children ("take the max so nobody loses headroom"). Atenção ao efeito contraintuitivo: quem usava max_async_children com valor BAIXO (2, por exemplo) para conter background perdeu a trava — o valor não é preservado e a concorrência de background passa a valer o max_concurrent_children (default 3). Confira o estado real com `hermes doctor`, que na v0.19.0 reporta chaves deprecated, e com `hermes config get delegation.max_concurrent_children`.

## Quem operou o Hermes Agent neste documento

Este texto é de José Carlos Amorim, publicado na Nexialismo em 2026-07-28. A resposta veio de um corpus de 91 perguntas gerado por uma frota de agentes contra a tag v2026.7.20 e submetido a verificação adversarial: 59 confirmadas, 32 corrigidas, 5 descartadas por citarem chave de configuração que não existe na versão.

Fonte oficial desta resposta: https://github.com/NousResearch/hermes-agent/pull/56955

O corpus inteiro fica em https://docs.nexialismo.ai/pt/hermes. A versão em inglês desta página fica em https://docs.nexialismo.ai/en/hermes-multiagente-max-async-children-ainda-uso-limitar-delegacao. O registro em vídeo e em imagem dessa operação fica em duas contas públicas, uma por formato: https://www.youtube.com/@josecarlosamorim-ai no YouTube e https://www.instagram.com/josecarlosamorim.ai/ no Instagram.

Verificado em 2026-07-28. Alvo de versão: Hermes Agent v0.19.0, tag v2026.7.20.

Tamo junto.