# O hermes doctor começou a reclamar de max_async_children depois que eu atualizei. Isso vai parar de funcionar? Troco por quê?

Hermes Agent v0.19.0, eixo topologia, 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-topologia-max-async-children-hermes-doctor-comecou-reclamar.

**Em uma frase:** `delegation.max_async_children` está deprecated. O substituto exato reportado pelo `hermes doctor` é `delegation.max_concurrent_children` (default 3, piso 1, sem teto rígido). O aviso é warn-only e **não** auto-migra nem apaga nada: a chave velha continua sendo lida por back-compat, mas você deve trocar na mão.

## A mesma pergunta, dita de outras formas

- max_async_children ainda existe no Hermes?
- quais chaves de config estão deprecated na v0.19.0?
- o que o hermes doctor reporta como deprecated?
- como limito concorrência de subagentes agora que max_async_children foi deprecado?

## A armadilha desta pergunta

**Se você já opera isso:** Material N3/N4 ainda ensina `max_async_children` como a chave para limitar concorrência de delegação. Ela é deprecated desde o PR #56955 e o doctor a denuncia desde o PR #67370. Segunda armadilha: interpretar o aviso como 'o Hermes migrou pra mim'. Ele é explicitamente 'warn-only; not auto-migrated here' — se você não trocar na mão, a chave velha fica lá e o aviso volta em todo doctor.

## O comando colável

```bash
# 1. veja o valor atual
grep -n -A5 '^delegation:' ~/.hermes/config.yaml

# 2. escreva a chave nova
hermes config set delegation.max_concurrent_children 3

# 3. remova a velha (unset é novo na v0.19.0)
hermes config unset delegation.max_async_children

# 4. confirme
hermes doctor 2>&1 | grep -i deprecat
```

## 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 2>&1 | grep -i -E 'deprecat|Replace ' ; grep -nE 'max_async_children|tool_progress_overrides|summary_(model|provider|base_url)' ~/.hermes/config.yaml
```

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

## O que a frota corrigiu nesta resposta

Cortar a citação do PR #67370 para apenas a parte que ficou de pé: '`hermes doctor` reports deprecated config keys / legacy env vars with their modern replacements.' Remover a oração 'Unknown top-level config keys now warn (naming the key) instead of being silently ignored' — essa metade do PR foi desfeita antes da tag v2026.7.20 e não descreve a v0.19.0. Todo o resto do Q&A permanece.

## 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.

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-topologia-max-async-children-hermes-doctor-comecou-reclamar. 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.