## Visão geral

Toda vez que a plataforma usa um modelo de IA — o Robô respondendo um cliente, um painel sendo
gerado, o briefing do onboarding, o juiz de qualidade, o copiloto, uma chamada de voz — isso pode gerar
um custo em dólares. Quando a medição e o preço estão confirmados, a aba **Consumo** do Cérebro reúne
esses registros e responde a pergunta que aparece toda vez que chega a fatura: **quanto ESTA conta
gastou, e com o quê**.

Cada valor precificado é uma medição registrada, não uma estimativa. Mas a finalização de um evento só
confirma que ele foi persistido: ela não prova, por si só, que a medição de uso ou o preço estejam
completos. Linha ausente, medição inválida ou preço ainda não confirmado nunca viram zero nem “sem
gasto”; a tela os trata como informação incompleta ou desconhecida.

## Pré-requisitos

- O módulo **Cérebro** precisa estar habilitado na conta.
- Você precisa ser **administrador**. Essa é a única leitura do Cérebro restrita a administradores, e
  o motivo é simples: informação de fatura é diferente de informação de atendimento. Um agente que lê
  a caixa de entrada não precisa ler a conta a pagar.
- O serviço de IA precisa estar acessível. Se não estiver, a tela mostra um **erro**. Um retorno
  incompleto ou desconhecido também é informado como tal — nunca como zero.

## Passo a passo

1. Abra **Cérebro** no menu lateral.
2. Vá até a aba **Consumo**.
3. Escolha o período no canto superior direito: **7**, **30** ou **90 dias**. A janela é a pergunta:
   trocar o período recarrega os números.
4. Leia de cima para baixo:
   - os quatro cartões resumem o período inteiro — custo, chamadas, tokens e tokens em cache — e cada
     um traz embaixo a média que costuma ser a próxima pergunta: custo por dia, chamadas por dia,
     tokens por chamada e **quanto da entrada veio do cache** (é o desconto do provedor: quando essa
     porcentagem cai, a fatura sobe sem o volume mudar);
   - o gráfico mostra o gasto dia a dia, com a escala à esquerda, as datas embaixo, o **dia de pico
     destacado** e, no rodapé, em quantos dias do período houve gasto — uma linha quase reta com
     "3 de 90 dias com gasto" é uma informação, não um gráfico vazio;
   - as listas abaixo quebram o mesmo total por **superfície**, por **modelo** e por **Robô**, cada
     linha com a sua **fatia do total**, o número de chamadas e o **custo por chamada**;
   - a seção **Por conversa** lista as conversas mais caras do período, com **link para abrir a
     conversa**, o custo dela, quantos turnos teve e o **custo por turno**.
5. Use a **barra de filtros** no topo para cruzar as perguntas: superfície, modelo, Robô e conversa.
   Os filtros combinam entre si e refazem a leitura — não escondem linhas na tela, eles mudam a
   consulta. Filtrar por um Robô e ver o total cair é a confirmação de que aquele Robô responde por
   aquela fatia.

Valores abaixo de um centavo aparecem com as casas decimais necessárias (por exemplo `US$ 0,004933`).
Uma chamada de modelo custa frações de centavo: arredondar para duas casas mostraria `US$ 0,00`, que
se lê como "nada foi medido".

### Por conversa

Até aqui a tela respondia "quanto a conta gastou". **Por conversa** responde "quanto ESTA conversa
custou" — que é a pergunta que aparece quando uma conversa específica se arrasta, ou quando alguém
quer saber se um atendimento saiu caro.

O custo de uma conversa inclui o que ela gastou fora do turno de resposta: a transcrição do áudio que
o cliente mandou, o áudio que o Robô respondeu, a chamada de voz. Antes essas coisas ficavam numa
linha que não conseguia ser ligada de volta à conversa que as causou.

**Sub-agente e delegação.** Quando um Robô delega para um sub-agente, os tokens do sub-agente já são
contados no turno de quem chamou. A tela mostra a delegação para você saber que ela aconteceu, mas o
custo dela **não é somado de novo** — somar seria contar os mesmos tokens duas vezes e inflar
justamente o número que esta tela existe para ser confiável.

Nas novas medições, se uma solicitação do trabalho delegado ainda não tiver conclusão confirmada ou
parte do preço estiver desconhecida, o detalhamento mostra **Subtotal medido**, com somente o piso
conhecido. O custo completo fica sem confirmação; quando não há parte tarifada conhecida, fica sem
valor. Isso vale também para o detalhamento por conversa, sem somar a delegação novamente ao total.
**Registros anteriores a esta versão seguem a medição da época**, com a exibição que já tinham;
a ConversaLabs não recalcula o histórico. Um aviso de limite de leitura indica somente que o
detalhamento não conseguiu ler todos os registros, uma situação diferente de medição incompleta.

### Superfícies sem preço

Nem tudo que consome IA chega com uma medição válida e uma tabela de preço confirmada. Transcrição de
áudio é cobrada por segundo, síntese de voz por caractere, imagem e vídeo por unidade. Se a
transcrição de áudio (ASR) não tiver uma medição válida e durável, o campo de ASR fica sem valor
(desconhecido), em vez de mostrar zero. Se a unidade foi medida mas o preço ainda não está confirmado,
a superfície aparece **contada e etiquetada como sem preço**: `cost_priced=false` significa “medido,
mas sem preço”, nunca `US$ 0,00`. Ela permanece na unidade dela ("3.412 caracteres sintetizados"),
e **nunca como `US$ 0,00`**.

A distinção é o ponto: `US$ 0,00` se lê como "isso foi de graça". Uma superfície sem preço se lê como
"isso consumiu, e a plataforma ainda não sabe quanto custou". Nesses casos, o subtotal com preço é
explicitamente **parcial** — ou fica indisponível se não houver nenhuma linha com preço confirmado — e
não deve ser confundido com a fatura inteira. Tecnicamente, `cost_usd` só representa o custo completo;
quando a medição está incompleta, ele fica `null`. `measured_subtotal_usd` é um subtotal opcional que
mostra apenas o piso realmente medido e tarifado. `total_is_floor=true`, `measurement_complete`,
`incomplete_observed` e `unpriced_reason` explicam por que esse subtotal não é um custo final.

## Configurações & opções

Não há o que configurar aqui: a aba é somente leitura. O que muda os números é o uso — quantas
conversas o Robô atende, quantos painéis são gerados, se o juiz de qualidade está amostrando turnos, e
qual modelo cada Robô usa.

Para mudar o modelo (e portanto o custo por chamada) de um Robô, use a tela de **Robôs**. Para mudar
quem grada a qualidade, use a atribuição de superfície do Cérebro.

## Casos de uso

- **Fechar o mês.** Você recebe a fatura do provedor e quer saber quanto dela é desta conta.
- **Descobrir onde está o gasto.** Quase sempre a resposta é "respostas ao cliente" — é a superfície
  que roda mais vezes. Quando não é, vale olhar: um painel gerado repetidamente ou um juiz apontado
  para um modelo caro aparecem imediatamente na lista por superfície.
- **Comparar Robôs.** A quebra por Robô mostra qual deles consome mais, o que costuma refletir volume
  de conversa, não desperdício — mas às vezes reflete um modelo caro escolhido sem necessidade.
- **Ver o efeito do cache.** Tokens em cache são cobrados com desconto. Um número alto ali significa
  que o prompt do sistema está estável e sendo reaproveitado; uma queda brusca costuma indicar que
  algo no prompt mudou.
- **Investigar uma conversa cara.** A seção **Por conversa** ordena pelo custo. Abrir a mais cara e
  olhar quantos turnos ela teve separa duas causas diferentes: uma conversa longa (muitos turnos
  baratos) e uma conversa pesada (poucos turnos caros, normalmente modelo grande ou muito contexto).
- **Descobrir o custo de voz.** Filtre pelas superfícies de áudio para ver quanto de transcrição e de
  síntese a conta consumiu — em segundos e caracteres, já que preço em dólar não existe para elas.

## Dicas, limites e boas práticas

- **Os valores são em dólar (US$).** É a moeda em que o provedor cobra e em que a medição foi feita.
  Converter aqui para real inventaria uma taxa de câmbio que a plataforma nunca observou.
- **A quebra por modelo é parcial, e a tela diz isso.** As respostas ao cliente são medidas sem
  guardar qual modelo respondeu, então o custo delas entra no total, na quebra por superfície e no
  gráfico diário, mas não na lista por modelo. Quando isso acontece, aparece uma linha dizendo quanto
  daquele total a lista cobre. Somar só a lista por modelo e achar que é a conta toda é o erro que
  essa linha existe para evitar.
- **“Sem gasto” exige prova positiva.** `no_usage` só aparece quando o ciclo confirma zero operações.
  Ausência de linhas, linha expirada, medição inválida, TTL, erro ou preço pendente aparece como
  informação incompleta ou desconhecida — nunca como “sem gasto” nem como `US$ 0,00`.
- **Finalizado não significa medido nem precificado por completo.** Finalização confirma persistência;
  `measurement_complete` informa a cobertura de medição de forma independente. Um evento `final` pode
  manter `cost_usd=null` e, ainda assim, exibir somente `measured_subtotal_usd` parcial, sem ser
  `no_usage`.
- **Uma resposta medida não confirma todas as solicitações do turno.** Se outra solicitação ao
  modelo ainda não tiver conclusão confirmada, a ConversaLabs mantém o consumo do turno incompleto.
  Os tokens e o custo já medidos continuam no subtotal. Em uma chamada, **Subtotal medido** e
  **Pelo menos** indicam o piso conhecido; o custo completo permanece sem confirmação. Esse estado
  também pode aparecer quando o restante da chamada ou do atendimento terminou normalmente.
- **ASR sem medição fica vazio/desconhecido; subtotal parcial continua parcial.** Se uma linha tiver
  unidade medida, mas preço não confirmado, ela não é somada como gratuita e o motivo da ausência do
  preço permanece visível.
- **A leitura de liveness não certifica uso.** `liveness_known=true` só informa que a leitura no Redis
  ocorreu. Ausência conhecida do marcador continua `unknown` enquanto não houver prova durável;
  `no_usage` exige prova positiva de zero operações, nunca lista vazia, TTL ou erro.
- **IA fica separada dos custos do WhatsApp.** Os valores de IA são sempre exibidos em US$ e nunca são
  somados à moeda de cobrança WABA/Meta.
- **A janela máxima é de 365 dias.** Períodos maiores são recortados, não recusados.
- **Um dia sem gasto aparece no gráfico como um dia sem gasto** — não como um buraco na linha.

## Solução de problemas

**A aba não aparece.** O módulo Cérebro está desabilitado na conta, ou você não é administrador.

**Aparece um erro em vez dos números.** O serviço de IA não respondeu. Nada é mostrado como zero de
propósito: um valor inventado aqui seria pior que a ausência dele. Use **Tentar de novo**; se
persistir, é caso para o responsável pela instalação.

**A tela informa dados incompletos ou desconhecidos.** Isso não prova que não houve uso. Pode faltar
uma linha durável, uma medição válida ou um preço confirmado. Mesmo que o evento esteja finalizado, a
finalização só confirma a persistência; `measurement_complete` continua independente. Nesse caso,
`cost_usd` fica `null` e só o `measured_subtotal_usd`, se houver, mostra o piso conhecido.

**O custo não bate com a fatura do provedor.** Duas causas comuns: a fatura cobre a instalação inteira
(todas as contas) e esta tela cobre uma conta; e o custo completo pode estar indisponível porque alguma
medição ou preço ainda não foi confirmado. Nessa situação, `measured_subtotal_usd` é apenas o piso
conhecido, não um total. A tabela de preços usada na medição também pode estar desatualizada em relação
ao provedor. Fale com o responsável pela instalação.

**A lista por modelo soma menos que o total.** É esperado, e a tela avisa — veja "Dicas, limites e
boas práticas" acima.

**Uma superfície aparece com chamadas e sem valor em dólar.** É de propósito quando a unidade foi
medida, mas não há preço confirmado. A medição fica na unidade própria (segundos, caracteres,
unidades); `measured_subtotal_usd` inclui somente o piso tarifado e `cost_usd` não finge ser completo.
Se a medição de ASR estiver ausente ou inválida, o campo de ASR fica desconhecido, não zero. Isso é
diferente de custo zero, e a etiqueta existe exatamente para você não confundir as duas coisas.

**As somas por superfície e por conversa não fecham exatamente.** Uma conversa só aparece em "Por
conversa" se o gasto dela pôde ser ligado a ela. Trabalho da conta que não pertence a nenhuma conversa
— um painel gerado, o briefing do onboarding, o ciclo diário de melhoria — entra no total e nas
superfícies, e corretamente não entra em nenhuma conversa.

## Veja também

- [Análises e dashboards generativos](/hc/ajuda/articles/maestro-brain-analises-e-dashboards-generativos-pt-br)
- [Ajustes avançados do modelo](/hc/ajuda/articles/maestro-brain-ajustes-avancados-do-modelo-pt-br)