Buscar K
Aparência
Indicadores
O módulo Indicadores é o cockpit de métricas de negócio ao vivo da plataforma. Cada indicador configurado vira um card que pulsa com o valor real, mostra variação vs o ciclo anterior e sinaliza o estado com cores (verde / amarelo / vermelho).
O módulo tem um papel duplo: ele é ao mesmo tempo um painel de acompanhamento para os usuários e a raiz de contexto que o Chat com Dados lê para entender o negócio. Cuidar bem dos indicadores melhora ao mesmo tempo o cockpit e as respostas do chat.
Em uma frase
Um indicador curado aparece no cockpit para o usuário E entra no contexto da IA nas conversas. Dois benefícios, uma configuração.
Para entender o que é um indicador e como defini-lo, veja Indicadores: Ensinando seu Negócio. Para entender como o Lumo aprende o comportamento normal de cada indicador e avisa quando ele sai do padrão, veja Monitoramento: o vigia.
O Cockpit
A rota /indicadores é o ponto central do módulo. Ao abrir você encontra um grid de cards, organizados em duas faixas:
- Indicadores curados — todos os indicadores curados dos apps que você tem acesso, reunidos em um único painel cross-app.
- Meus Indicadores — os indicadores que você marcou com estrela (seguiu), na ordem que você definiu.
Cada card mostra:
| Elemento | O que representa |
|---|---|
| Valor | O número atual do indicador (calculado ao vivo) |
| Variação | Diferença vs o ciclo anterior (ex.: semana passada, mês anterior) |
| Status RAG | Verde = dentro do esperado; Amarelo = atenção; Vermelho = crítico |
| Mini-série | Sparkline com a tendência recente |
| Meta | Linha de referência, quando configurada |
| Ícone | Símbolo visual associado ao indicador |
Meus Indicadores
Você monta sua visão pessoal com dois gestos:
- Seguir — clique na estrela do card. O indicador aparece na faixa "Meus Indicadores".
- Reordenar — arraste os cards seguidos para a ordem de importância que faz sentido para você.
Há um teto de 5 indicadores seguidos: a faixa mostra "Seguindo · N de 5". Ao tentar seguir o sexto, aparece o aviso "Giro cheio" pedindo para deixar de seguir um antes. O limite mantém o acompanhamento como um radar: poucos números, olhados de verdade.
Seguir um indicador também é o que liga o monitoramento automático dele para você: mudanças de faixa geram aviso no sino e o indicador entra na sua Home Giro.
INFO
Seguir um indicador curado não cria uma cópia — você está se inscrevendo no indicador existente do app. Se o indicador for atualizado ou removido pelo admin, o seu card reflete a mudança.
Personalizando o card
Cada card tem um editor de apresentação (ícone de engrenagem) onde você ajusta como o indicador é exibido — sem mudar a definição da métrica:
- Formato do número — moeda, porcentagem, casas decimais, etc.
- Ícone e cor — o símbolo do card e a cor de destaque.
O semáforo (verde/amarelo/vermelho) tem casa própria: por padrão ele é automático, aprendido pelo Lumo a partir do histórico, com a opção de faixas manuais. O editor de apresentação tem um atalho direto para esses controles. Veja Monitoramento: o vigia.
A Home Giro (beta)
Para quem participa do beta, a página inicial da plataforma ganha um formato novo, o Giro: uma home pensada para responder em segundos "como está o negócio hoje e o que mudou". Quem já tinha uma home personalizada não perde nada: as duas convivem em abas, "Giro" e "Minha página (clássica)", e a plataforma lembra a última aba que você usou.
O Giro abre com uma saudação e a data do dia, seguido de três blocos:
Meus indicadores
Os até 5 indicadores que você segue, como cards ao vivo (valor, variação, estado). Se você ainda não segue nenhum, o bloco convida: "Escolha até 5 indicadores para acompanhar aqui", com um botão que leva ao cockpit.
Hoje
As exceções das últimas 24 horas: os indicadores seguidos que mudaram de estado. Cada card mostra a transição (de qual cor para qual cor), o valor atual com a variação e o horário ("Saiu da faixa às 09:40" ou "Voltou ao normal às 14:15"). Clicar no card abre o detalhe do indicador já com o "Por quê?" para você investigar.
Num dia calmo, o bloco diz exatamente isso: "Nada fora do esperado. Bom trabalho." A ausência de exceções é a notícia.
Aplicações recentes
Todas as suas aplicações, com busca e três ordenações: Mais usados (padrão, as que você mais abre vêm primeiro), Nome e Recência. Cada card traz a contagem de acessos e há quanto tempo foi o último ("12× · há 2 d").
O que qualifica uma exceção
O bloco "Hoje" lista mudanças reais de estado do monitoramento (piorou ou se recuperou), calculadas de forma determinística sobre os indicadores que você segue. Sem indicadores seguidos, não há o que vigiar, e o bloco avisa isso em vez de mostrar um falso "tudo certo".
Pessoal vs Curado
Todo indicador tem um tipo que determina quem o vê e se ele entra no contexto da IA.
| Pessoal | Curado | |
|---|---|---|
| Quem criou | O próprio usuário, no cockpit | Administrador (ou promovido) |
| Visível para | Só o dono | Todos que acessam o app |
| Alimenta a IA de outros? | Não | Sim |
| Aparece na curadoria do app? | Não | Sim |
Indicador pessoal é um radar privado. O usuário cria para acompanhar algo que importa para ele sem impactar o contexto dos outros. Ele não vaza para a IA nas conversas de terceiros.
Indicador curado é a definição oficial do conceito de negócio naquele app. Ele entra no contexto da IA para todos que usam o app e aparece na tela de curadoria do admin.
Como um indicador torna-se curado
Um administrador pode promover um indicador pessoal para curado — diretamente na tela de curadoria. A partir daí o indicador passa a alimentar a IA e a aparecer para os outros usuários do app.
Indicadores criados pelo admin já nascem curados
Criações pelo editor do app (botão "Novo Indicador", "Gerar com IA", clone, template) são curadas por padrão. Só a criação pelo próprio usuário no cockpit nasce como pessoal.
Criando um indicador
Qualquer usuário pode criar um indicador pessoal direto no cockpit, sem depender de um admin. O botão Criar indicador abre a janela "Novo indicador", organizada em três abas, da mais rápida para a mais detalhada:
Sugestões (aba inicial)
A plataforma sugere indicadores prontos a partir de duas fontes:
- Dos seus painéis: os KPIs que já existem nos seus dashboards, prontos para virar indicador com um clique.
- Populares no seu time: os KPIs mais adotados pelas pessoas do seu time.
Em cada sugestão você escolhe Adicionar (cria direto, com nome e métrica do widget) ou Ajustar antes (leva a configuração para a aba Manual, para refinar).
Com IA
Você escolhe a aplicação e descreve o que quer acompanhar em uma frase, como "Faturamento confirmado por mês" ou "Ticket médio dos pedidos". A IA monta um rascunho e mostra a revisão: o nome (editável), a métrica escolhida, o período e os filtros. Você pode Criar, pedir para Gerar de novo ou Ajustar no manual.
A IA trabalha só com as colunas reais da aplicação escolhida: ela não inventa métrica e nada é criado sem a sua confirmação. Se ela não conseguir montar um indicador para a sua descrição, o aviso sugere descrever de outro jeito ou usar a aba Manual.
Manual
O caminho campo a campo:
- Escolha a aplicação e dê um nome claro (o termo que sua empresa usa no dia a dia).
- Selecione a coluna principal: a medida que o indicador acompanha, com a função de agregação (soma, média, contagem…).
- Em Opções avançadas, se precisar: a coluna de data (usada no ciclo e na série histórica), o período padrão (semana, mês, trimestre…), os filtros que fixam o contexto do conceito (ex.:
Status = "Confirmado") e uma descrição de uma frase.
A coluna de data é opcional. Sem ela, o indicador vira uma "foto do momento" e o Lumo constrói o histórico registrando o valor diariamente; veja Indicador sem coluna de data.
TIP
Use os filtros para fixar o contexto. Um indicador "Faturamento" sem Status = "Confirmado" vai incluir vendas canceladas em todas as visualizações.
Aviso de duplicado
Nas três abas, se já existe um indicador idêntico (mesmo nome, aplicação, data de controle e filtros), a plataforma pergunta antes de criar: "Já existe um indicador idêntico. Criar mesmo assim?". É um aviso, você pode prosseguir; mas na maioria dos casos o melhor é seguir o indicador que já existe.
O indicador criado no cockpit nasce como pessoal. Quando um admin considera que ele representa um conceito relevante para o app, ele pode promovê-lo para curado.
Curadoria — "Indicadores por app"
Administradores têm acesso à tela de curadoria, que lista os indicadores curados organizados por app. Nela é possível:
- Criar um novo indicador curado diretamente.
- Editar ou excluir um indicador existente.
- Promover um indicador pessoal de um usuário para curado.
- Controlar as Colunas IA — quais colunas do app a IA pode enxergar nas conversas.
WARNING
Remover um indicador curado o desvincula de todos os usuários que o seguiam. Use com cuidado; prefira desabilitar antes de excluir caso haja dúvida.
Possíveis duplicados
A tela de curadoria destaca com o selo "Duplicado" os indicadores que têm outros com o mesmo nome, aplicação, data de controle e filtros. O selo é apenas uma dica: cabe ao admin decidir se são de fato o mesmo conceito.
Unificar indicadores
Quando a duplicação é real, o admin seleciona 2 ou mais indicadores do mesmo contexto (mesma aplicação, mesma data de controle, mesmos filtros) e usa Unificar selecionados. Na janela de unificação:
- Escolha qual indicador manter (a sugestão inicial é o que tem mais métricas, mas você pode escolher qualquer um).
- Revise a prévia: as métricas dos selecionados são reunidas no indicador mantido, e os demais serão arquivados.
- Confirme. Quem seguia os indicadores arquivados passa a seguir o mantido automaticamente.
O indicador mantido preserva seu histórico de monitoramento e suas análises. Os arquivados saem do catálogo (e do contexto da IA), mas não são apagados de forma irreversível.
A curadoria é onde o administrador garante que o catálogo de indicadores do app seja enxuto, bem definido e alinhado com o vocabulário da empresa — o que resulta em respostas mais consistentes do chat e um cockpit mais útil.
Detalhe do indicador
Clique em qualquer card para abrir a tela de detalhe (/indicadores/[id]).
O topo da tela concentra o essencial: o valor atual com a variação, o seletor de métrica (quando o indicador tem valores alternativos), a barra de filtros, o botão "Por quê?" (a explicação por IA, veja a seção abaixo) e duas ações:
- Abrir no Explorer: o caminho para a tabela bruta. Abre o Explorer da aplicação já com o recorte do indicador (métrica, período e filtros), para quem quer ver as linhas que compõem o número.
- De onde vem: um cartão de proveniência com a tabela de origem em destaque, a métrica e agregação, a coluna de tempo, os filtros fixos, o período aplicado e quando os dados foram carregados. É a resposta rápida para "posso confiar neste número?".
O corpo da tela é organizado em três abas:
- Análise: a série completa do indicador, com controle de período e granularidade e um overlay do ciclo anterior sobreposto para comparação visual; ao lado, o breakdown: escolha na hora qual dimensão quer usar para decompor o valor (filial, produto, canal, etc.) e veja os maiores contribuintes (top‑N + "Outros"). Clicar numa categoria isola aquela fatia, um filtro indicado por um chip "Filtrado por" no topo (com botão para limpar).
- Monitoramento: o trabalho do vigia, com o veredito do período atual, o gráfico com a faixa esperada, os desvios recentes e o padrão do seu negócio. Detalhes em Monitoramento: o vigia.
- Configuração: as definições do indicador em três sub-abas, Definição (valor principal, valores alternativos, coluna de data, filtros, período), Apresentação (formato, ícone, cores) e Monitoramento (grão, janela, direção, faixas manuais e o aviso no sino).
INFO
O breakdown usa as colunas disponíveis no app — você escolhe na hora qual dimensão quer ver. A dimensão não é parte da definição do indicador; ela pertence à pergunta. (Os "valores alternativos" do indicador, ao contrário, são métricas do mesmo conceito — ex.: Faturamento → Valor Total, Ticket Médio, Margem.)
"Por quê?" — explicação por IA
No detalhe do indicador, o botão "Por quê?" abre um painel lateral com uma análise gerada pela IA sob demanda. Enquanto ela roda, o painel mostra o progresso em três etapas:
- Consultando o período: a IA levanta o panorama de métricas do app, o valor atual de cada uma vs o período de comparação.
- Analisando com IA: o raciocínio sobre o que explica a variação do indicador.
- Estruturando os fatores: a extração dos drivers, os fatores que mais contribuíram, exibidos como destaques junto da explicação.
O resultado vem em linguagem natural, acompanhado da tabela de panorama (métrica, valor atual, anterior, variação %).
A análise fica guardada por indicador e período: abrir o "Por quê?" de novo no mesmo período retorna a mesma análise na hora, sem novo custo. Para forçar uma análise nova (por exemplo, depois de uma carga de dados), use o link "Atualizar" no rodapé do painel. A atualização tem um intervalo mínimo de 10 minutos entre pedidos; antes disso, a plataforma pede para aguardar.
TIP
Use "Por quê?" quando o status virou vermelho e você precisa entender rapidamente o que aconteceu, sem montar um dashboard nem formular uma pergunta no chat.
Notificações
Quando um indicador que você segue piora de status, a plataforma envia uma notificação no sino (canto superior direito):
- Amarelo — o indicador entrou em zona de atenção.
- Vermelho — o indicador está em estado crítico.
- Recuperação — o indicador voltou para verde após um período amarelo ou vermelho.
Clicar na notificação abre o detalhe do indicador já com o "Por quê?", para que você tenha contexto imediato sobre o que mudou.
O que conta como "piorar" ou "recuperar" é decidido pelo monitoramento automático, que reavalia os indicadores de hora em hora.
INFO
Só indicadores que você segue (estrela) geram notificações. Indicadores curados que você não segue não disparam alertas. E o aviso é opcional por indicador: em Configuração → Monitoramento, a chave "Avisar no sino quando mudar de faixa" (ligada por padrão) controla só as suas notificações, sem afetar os outros seguidores.
Indicadores e a IA
Os indicadores curados são a raiz que a Lumia lê para entender o negócio. Quando alguém abre uma conversa no chat sobre uma aplicação, o catálogo de indicadores curados daquele app entra como contexto — e a IA usa esses indicadores para resolver ambiguidades e ancorar as respostas em definições explícitas.
Curar bem os indicadores tem efeito duplo:
- O cockpit fica mais relevante — cards bem definidos mostram o que realmente importa.
- O chat fica mais consistente — definições claras eliminam adivinhações.
O inverso também vale: um catálogo com muitos indicadores parecidos ou mal definidos piora tanto o cockpit (sinal diluído) quanto o chat (ambiguidade aumentada).
TIP
Se o chat está dando respostas inconsistentes, o primeiro lugar para olhar é o catálogo de indicadores. Veja Indicadores: Ensinando seu Negócio para o guia de boas práticas e os anti-padrões a evitar.