Estou chamando `hermes -z` dentro de um pipeline. Como registro quanto cada invocação custou?

Hermes Agent v0.19.0, eixo custo, 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-custo-estou-chamando-hermes-dentro-pipeline-registro.

Em uma frase: Use hermes -z "prompt" --usage-file /caminho/uso.json. Ele escreve um JSON com estimated_cost_usd, contagem de tokens (incluindo cache read/write e reasoning), api_calls, model, provider, session_id e service_tier. O relatório é escrito mesmo quando a run falha, com um campo failure extra.

A mesma pergunta, dita de outras formas

• medir custo por chamada de hermes -z
• hermes oneshot relatório de uso em JSON
• --usage-file do hermes existe? não achei na doc de CLI
• contabilizar spend por item num batch com Hermes

A armadilha desta pergunta

Se você já opera isso: Procurar a flag em /reference/cli-commands e concluir que não existe. A página está incompleta nesse ponto. Outra armadilha: tratar estimated_cost_usd como custo total da invocação, quando ele cobre o loop principal e não o gasto auxiliar da mesma run.

O comando colável

hermes -z "resuma este arquivo" --usage-file /tmp/uso.json < entrada.txt
jq '.estimated_cost_usd, .total_tokens, .service_tier' /tmp/uso.json

SID=$(jq -r .session_id /tmp/uso.json)
sqlite3 "file:$HOME/.hermes/state.db?mode=ro" \
  "SELECT task, model, input_tokens, output_tokens FROM session_model_usage WHERE session_id='$SID';"

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.

hermes -z "responda apenas OK" --usage-file /tmp/uso.json && cat /tmp/uso.json

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.

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-custo-estou-chamando-hermes-dentro-pipeline-registro. 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.