Onde eu vejo quanto os modelos auxiliares me custaram? O total da sessão não bate com a fatura.

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 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-custo-vejo-quanto-modelos-auxiliares-custaram-total-sessao.

Em uma frase: Desde a v0.19.0 (PR #65537) o uso auxiliar é gravado por task em session_model_usage, e aparece em GET /api/analytics/usage nos campos by_task e by_model. O campo totals da mesma resposta vem da tabela sessions e não inclui auxiliar por design, então totals nunca vai bater com a soma de by_model.

A mesma pergunta, dita de outras formas

• como ver custo de compressão e vision separado
• por que o /usage não mostra o gasto dos auxiliares
• breakdown de custo por task auxiliar no Hermes
• totals do analytics não bate com by_model, por quê

A armadilha desta pergunta

Se você já opera isso: Somar by_model e comparar com totals achando que a diferença é bug de arredondamento. A diferença é o custo auxiliar inteiro. E DB aberto por versão antiga sem a coluna task simplesmente devolve breakdown vazio, sem erro.

O comando colável

curl -H "X-Hermes-Session-Token: $TOKEN" \
  "http://localhost:PORT/api/analytics/usage?days=30" | jq '.by_task'

hermes insights --days 30          # analytics de token/custo/atividade

sqlite3 "file:$HOME/.hermes/state.db?mode=ro" \
  "SELECT task, model, SUM(input_tokens), SUM(output_tokens) FROM session_model_usage GROUP BY task, model ORDER BY 3 DESC;"

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.

sqlite3 "file:$HOME/.hermes/state.db?mode=ro" "SELECT task, model, SUM(input_tokens+output_tokens) t FROM session_model_usage GROUP BY 1,2 ORDER BY t DESC LIMIT 20;"

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

O que a frota corrigiu nesta resposta

O breakdown existe desde a v0.19.0 (PR #65537) em GET /api/analytics/usage, campos by_task e by_model. Duas ressalvas que faltavam. Primeira: a página Analytics do dashboard vem ESCONDIDA — dashboard.show_token_analytics é false por default. Para ver na UI, ponha em ~/.hermes/config.yaml: ``yaml dashboard: show_token_analytics: true ` O endpoint HTTP não é gated pelo flag (o gate vive só no front, em web/src/pages/AnalyticsPage.tsx), então sem mexer em nada já dá para ler direto: `bash curl -s 'http://127.0.0.1:8765/api/analytics/usage?days=30' | jq '{by_task, totals}' ` Segunda: a página /user-guide/configuration (N1) ainda descreve a analytics como algo que "exclude auxiliary calls" — esse texto é anterior ao #65537 e está errado para o by_model/by_task. O que continua verdade é que totals vem da tabela sessions e não inclui auxiliar, então totals nunca vai fechar com a soma de by_model, e a diferença é o custo auxiliar inteiro. Detalhe que fecha a conta: moa_reference e moa_aggregator nunca aparecem em by_task, porque agent/aux_accounting.py os exclui de propósito (_EXCLUDED_TASKS`) — o conversation_loop já dobra o gasto de MoA dentro do delta do loop principal, contar de novo seria duplicar.

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-vejo-quanto-modelos-auxiliares-custaram-total-sessao. 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.