Botei ${MINHA_CHAVE} no config.yaml e não deu erro nenhum, mas também não funcionou. Como descubro se a substituição rodou?

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 confirmada. 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-minha-chave-botei-config-yaml-deu-nenhum-funcionou.

Em uma frase: Se a variável referenciada não existe, o Hermes mantém o placeholder verbatim: ${UNDEFINED_VAR} continua a string literal ${UNDEFINED_VAR}. Não há erro. E só a sintaxe ${VAR} é suportada: $VAR sem chaves não é expandido, nunca. Confirme com hermes config get <chave> e veja se sai o valor ou o placeholder.

A mesma pergunta, dita de outras formas

substituição de variável de ambiente no config.yaml do Hermes
por que meu ${VAR} no config.yaml ficou literal?
posso usar $VAR sem chaves no config do Hermes?
o Hermes avisa quando a variável referenciada no config não existe?

A armadilha desta pergunta

Se você já opera isso: Esperar erro. Não vem. 'Não deu erro logo funcionou' é exatamente a inferência errada aqui: variável ausente devolve o placeholder literal e a falha reaparece disfarçada no provider, longe da causa. Segunda armadilha: escrever $VAR por hábito de shell. Nunca expande, também sem avisar.

O comando colável

# ~/.hermes/config.yaml
auxiliary:
  vision:
    api_key: ${GOOGLE_API_KEY}
    base_url: ${CUSTOM_VISION_URL}

delegation:
  api_key: ${DELEGATION_KEY}

# o valor resolvido. Se aparecer ${...}, a substituição NÃO rodou.
hermes config get auxiliary.vision.api_key

# a variável está mesmo no ambiente que o Hermes enxerga?
grep -n 'GOOGLE_API_KEY' ~/.hermes/.env
env | grep GOOGLE_API_KEY

# caça rápida a placeholders não resolvidos no seu config
grep -nE '\$\{[A-Z_][A-Z0-9_]*\}' ~/.hermes/config.yaml

# e o erro de sintaxe: bare $VAR nunca expande
grep -nE '(^|[^$\{])\$[A-Z_][A-Z0-9_]*' ~/.hermes/config.yaml

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.

grep -nE '\$\{[A-Z_][A-Z0-9_]*\}' ~/.hermes/config.yaml && hermes config get <a.chave.em.questao>

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

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://hermes-agent.nousresearch.com/docs/user-guide/configuration

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-minha-chave-botei-config-yaml-deu-nenhum-funcionou. 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.