## Visão geral

O Cérebro da Conta traz duas formas de enxergar a operação a partir dos dados que a plataforma já
tem:

- **Matriz de análise consultiva** — uma aba com **KPIs reais** dos módulos nativos (conversas
  abertas, tempo de primeira resposta, tempo de resolução, CSAT, MRR, valor de pipeline do CRM,
  follow-ups ativos, pedidos do Catálogo e métricas de Vendas como metas, atingimento, moedas e
  comissões) mais **séries** (volume de conversas dos últimos dias e distribuição por status), cada
  gráfico com uma leitura consultiva de uma linha.
- **Dashboards generativos** — você **descreve em linguagem natural** o painel que quer e o Maestro
  monta uma especificação declarativa (cards de KPI, gráficos, tabelas e um texto-resumo) já com os
  **valores reais** sobrepostos.

A matriz é só leitura e está sempre disponível; os dashboards generativos você cria, revisa, salva e
organiza do seu jeito.

## Pré-requisitos

- Conta com o **Cérebro da Conta** habilitado.
- Permissão de **administrador** para **gerar, salvar, reordenar e descartar** dashboards. **Qualquer
  membro** da conta pode **ver** a matriz e os dashboards salvos (leitura).
- **Módulos nativos ativos e com dados** para os KPIs aparecerem com valores reais (por exemplo,
  Pagamentos para MRR, CRM para o pipeline, Catálogo para pedidos, Vendas para metas e comissões).

## Passo a passo

### Ver as análises (matriz)

1. Abra o **Cérebro da Conta** e vá até a aba **Análises**.
2. Acompanhe os **cards de KPI** e os **gráficos** (volume e status).
3. Onde houver um relatório nativo correspondente, clique no KPI para **abrir o relatório** com o
   detalhe.
4. Se aparecer o selo **em cache**, o motor de análise estava fora no momento e a aba mostrou um
   cálculo nativo de fallback — os dados continuam válidos e a aba **nunca quebra**.

### Criar um dashboard generativo

1. Vá até a aba **Dashboards**.
2. No campo de geração, **descreva em linguagem natural** o painel que quer (você também pode **ditar
   por voz**). Exemplo: "mostre CSAT, MRR e o volume de conversas das últimas duas semanas".
3. Clique em **Gerar**. O Maestro devolve uma especificação declarativa com cards e gráficos, já com
   os **valores reais** dos KPIs nativos sobrepostos.

### Revisar, salvar e organizar

1. **Revise** a proposta na tela (ela ainda **não fica salva**).
2. Clique em **Salvar** para mantê-la — ela vira um **dashboard nativo da conta**, persistido por
   conta.
3. **Reordene os widgets** (mover para cima/baixo) para ajustar o layout.
4. **Salvar de novo** atualiza o dashboard existente; gerar sem um `id` cria um novo.
5. Para remover, use o **descartar** (com confirmação) — é uma exclusão suave (soft-delete).

## Configurações & opções

- **KPIs nativos**: conversas abertas, tempo de primeira resposta, tempo de resolução, resoluções,
  CSAT, MRR, valor de pipeline, follow-ups ativos, pedidos do Catálogo e métricas de Vendas. Cada um
  retorna **0** quando o módulo está inativo ou ainda não tem dados.
- **Drill-down**: KPIs com relatório nativo viram link para o relatório (os demais ficam como card).
- **Filtros declarativos**: chips (por exemplo, período/intervalo) que ajustam e **regeneram** o
  painel — disponíveis para administradores.
- **Layout por conta**: a ordem dos widgets é personalizada por conta e **espelhada no dashboard
  salvo** ao salvar.
- **Proveniência (fontes)**: quando o resumo é embasado na sua base de conhecimento, aparecem chips
  de **fonte**; clicar abre o **Corpus**.
- **Comportamento cache-first**: a aba sempre devolve um formato estável; com o motor fora, usa o
  cálculo nativo (selo **em cache**). Conta nova rende KPIs zerados e séries vazias — nunca um erro.

## Casos de uso

- Ter uma **visão recorrente** da operação (CSAT, MRR, pipeline) em um dashboard salvo.
- Montar rapidamente um painel para uma pergunta específica ("quero ver pedidos do Catálogo por
  semana").
- Combinar **período** com métricas para comparar janelas de tempo.
- Abrir o relatório nativo direto de um KPI para investigar um número.

## Dicas, limites e boas práticas

- Peça **métricas específicas** e combine com filtros (ex.: período) para painéis mais úteis.
- Use **dashboards salvos** como a visão padrão da equipe — eles persistem por conta.
- A especificação gerada **só é mantida depois de salvar**; se você regenerar ou sair, uma proposta
  não salva é perdida.
- KPIs em **0** geralmente significam módulo inativo ou ainda sem dados, não erro.

## Solução de problemas

- **KPI em 0**: o módulo correspondente está inativo ou ainda não há dados (por exemplo, sem
  assinaturas → MRR 0; sem negócios no CRM → pipeline 0).
- **Ação bloqueada**: **gerar, salvar, reordenar e descartar** são **só para administradores** —
  membros têm acesso de leitura.
- **Perdi o dashboard gerado**: a proposta não fica salva até você clicar em **Salvar**.
- **Selo "em cache"**: o motor de análise estava fora no momento; a aba usou o cálculo nativo de
  fallback e segue funcional.

## Veja também

- [Departamentos, análise de risco e insights](/hc/ajuda/articles/maestro-brain-departamentos-risco-insights-pt-br)
- [Copiloto generativo: propor, confirmar e executar](/hc/ajuda/articles/maestro-brain-copiloto-generativo-pt-br)
- [O que é o Maestro IA e o Cérebro da Conta](/hc/ajuda/articles/maestro-brain-overview-pt-br)