Indicadores

Tipo

Conceito

Para

Analista, Administrador do Tenant, Desenvolvedor

Um Indicador é a definição de um número do negócio, gravada uma vez numa Aplicação: qual métrica calcular, com qual filtro fixo e em qual coluna de data medir o tempo. A tela Indicadores e Relatórios, o Chat com Dados, o MCP do Lumo, as skills e as investigações leem a mesma definição. É essa definição compartilhada que o mercado chama de camada semântica.

Coluna, métrica e Indicador

As três palavras aparecem juntas e querem dizer coisas diferentes.

A coluna é o dado guardado na tabela: VALOR, STATUS, DT_APROVACAO. A métrica é como somar esse dado: uma coluna com uma agregação (soma, contagem, média, mínimo, máximo) ou uma expressão da Aplicação. A métrica não tem filtro nem data. O Indicador junta a métrica, um filtro fixo e uma coluna de data, e recebe o nome que a empresa fala em voz alta.

"Aprovado", por exemplo, é a soma de VALOR onde STATUS é aprovado, medida pela DT_APROVACAO. Cada pedaço dessa frase foi uma decisão, e o Indicador guarda as três juntas.

Por que a IA erra sem Indicador

Pense numa tabela de títulos onde convivem contas a pagar e a receber, com valor do título, valor baixado, data de emissão e data de baixa. Alguém pergunta quanto a empresa recebeu no mês passado.

Para responder, a IA precisa escolher qual coluna é o valor, se filtra pelo tipo de título e qual das duas datas define "mês passado". Nas três escolhas existe uma alternativa defensável. Somar o valor do título traz o faturado no lugar do que entrou no caixa. Esquecer o filtro de tipo soma pagamentos com recebimentos. Usar a emissão traz títulos que ainda não foram pagos.

Qualquer um desses erros produz um número inteiro e bem formatado. A resposta errada não parece errada, e a mesma pergunta pode sair diferente amanhã, porque mais de um caminho parecia válido.

Com o Indicador salvo, a IA lê a definição e consulta uma vez: coluna, filtro e data já estão decididos. Sem ele, ela abre a Aplicação, escolhe a coluna que parece certa e procura os valores dessa coluna para descobrir se está escrito APROVADO, APROVADA ou Autorizado. Se ela escolhe APROVADO e a base também tem APROVADA, o total sai menor e ninguém fica sabendo.

Quando dois números são o mesmo Indicador

Outro filtro ou outra coluna de data forma outro Indicador, mesmo que a métrica seja a mesma. "Orçado" pela data do orçamento e "Aprovado" pela data de aprovação são dois Indicadores sobre a mesma soma de VALOR, porque respondem perguntas diferentes.

Com o mesmo filtro e a mesma data, outra agregação (uma contagem, um ticket médio) é alternativa do mesmo Indicador. Ela entra em Valores alternativos, dentro do "Aprovado".

O período padrão fica fora dessa conta. "Aprovado no mês" e "Aprovado no ano" são o mesmo Indicador visto em dois recortes. Quem quebra por filial, produto ou cliente também não cria Indicador novo: a quebra vem da pergunta e das colunas da Aplicação.

Dois Indicadores com o mesmo nome e contas diferentes confundem a IA e quem lê os cards. Quando a conta muda, o nome muda junto. Os exemplos de certo e errado estão em Desenhar bons Indicadores.

Pessoal e publicado

Todo Indicador nasce de um de dois jeitos, e isso decide quem o vê.

	Pessoal	Publicado
Quem cria	Qualquer pessoa com acesso a Indicadores, pelo botão Criar indicador	Quem administra, pela curadoria, ou publicando um pessoal
Quem vê	Só quem criou	Todos que acessam a Aplicação
Entra na IA	Só nas conversas de quem criou	No chat, no MCP e nas skills de todos que acessam a Aplicação

Publicar não tem volta: o Indicador publicado não volta a ser pessoal. Só publica quem é administrador do Tenant ou tem a função Publicar indicadores liberada no grupo.

O que chega à IA

Nome, descrição, métrica, valores alternativos, coluna de data e filtros orientam o chat, o MCP e as skills. Formato do número, ícone, cor e as faixas de monitoramento ficam só na tela de Indicadores e não mudam resposta nenhuma. Gaste o tempo no nome, no filtro e na data.

A cada mensagem, o catálogo das Aplicações que a pessoa acessa vai junto para o modelo, com os Indicadores publicados e os pessoais dela. Vinte definições precisas orientam. Oitenta aproximadas competem entre si, e a IA passa a escolher a errada justamente porque duas parecem servir. Catálogo grande também gasta mais créditos de IA por pergunta.

Onde cada conta fica

A mesma conta pode ser escrita em três lugares, e a escolha muda quem a enxerga. O Indicador guarda o número com nome, filtro e data, e é o que a IA e a tela de Indicadores consultam. A expressão da Aplicação guarda uma fórmula reutilizável dentro de uma Aplicação, e um Indicador pode usá-la como métrica. A expressão na tabela do HorusDW guarda a fórmula no dado, e toda Aplicação que usa a tabela a recebe pronta.

Cada Indicador pertence a uma Aplicação. O mesmo número em duas Aplicações são dois registros, cada um com a sua definição. Quando uma métrica serve a várias Aplicações, escreva-a na tabela, para que todas leiam a mesma fórmula.

Onde isso aparece

Para acompanhar os números, seguir e criar Indicadores, veja a tela Indicadores e Relatórios. Quem administra cuida do catálogo em Curadoria de Indicadores. A faixa esperada de cada número está em Monitoramento.

Pelo Lumo CLI

Os Indicadores também podem ser escritos e versionados em YAML, na lista indicators: da Aplicação. O nome antigo, facts:, ainda é aceito com aviso no lumo lint, e lumo scaffold indicator imprime um modelo comentado. Veja a referência de app.