Buscar K
Aparência
Indicadores: Ensinando seu Negócio
Um indicador é a forma de explicar para o chat o que cada conceito do seu negócio significa na sua aplicação. É a peça que transforma uma resposta razoável em uma resposta consistente.
Em uma frase
Um indicador é um exemplo de pergunta resolvida que você grava para o chat — você nomeia um conceito ("Faturamento") e mostra qual coluna é a métrica, em qual coluna o tempo é medido e que filtros padrão se aplicam.
Os indicadores têm um papel duplo: além de alimentar a IA com contexto curado, eles aparecem no cockpit de Indicadores — um painel que exibe cada métrica ao vivo com status RAG, variação vs ciclo anterior e série histórica. Cuidar bem dos indicadores melhora ao mesmo tempo a qualidade das respostas e a inteligência do cockpit.
A analogia do analista novo
Imagine que você está sentado no primeiro dia com um analista recém-contratado. Ele tem acesso ao seu modelo de dados, sabe ler tabelas e sabe escrever SQL. Em algum momento alguém entra na sala e pergunta:
"Qual o faturamento de ontem?"
O analista olha pra você confuso — no modelo tem três colunas que poderiam ser "faturamento": valor_bruto, valor_liquido e valor_pago. Tem duas colunas de data: data_emissao e data_competencia. E ele percebeu que vendas têm um status — "Confirmado", "Cancelado", "Pendente".
Você responde:
"Quando alguém aqui fala em Faturamento, é o Valor Líquido da tabela de vendas, considerando apenas o status Confirmado, com o tempo medido pela Data de Emissão."
Pronto. O analista agora sabe. Para a próxima pergunta — "faturamento do trimestre", "faturamento por filial", "faturamento ontem vs hoje" — ele aplica essa mesma definição variando apenas o que a pergunta variou.
É exatamente isso que um indicador faz com o chat.
Por que o chat precisa de indicadores
O chat consegue ver toda a estrutura da sua aplicação — tabelas, colunas, expressões, dashboards. Ele pode responder perguntas mesmo sem nenhum indicador configurado.
O problema é a ambiguidade. Em modelos de dados reais quase sempre existe mais de uma resposta razoável:
- Múltiplas colunas que poderiam ser "vendas" (
valor_bruto,valor_liquido,valor_pago) - Múltiplas datas que poderiam ser "tempo" (emissão, competência, vencimento)
- Filtros sutis que mudam o resultado (
status = "Confirmado",tipo = "Comercial")
Sem indicadores, o chat faz uma escolha razoável a cada conversa — mas a escolha não é determinística. Ele pode acertar hoje e errar amanhã na mesma pergunta, porque mais de um caminho parecia válido.
Um indicador resolve isso sendo um exemplo curado: para este conceito de negócio na esta aplicação, a definição certa envolve estas colunas, esta data e estes filtros padrão.
Indicador é definição, não relatório
Um indicador grava uma definição que o chat usa como ponto de partida toda vez que aquele conceito aparece numa pergunta — independente das variações. "Faturamento do trimestre", "faturamento por filial" e "faturamento ontem vs hoje" são todas a mesma definição com agrupamentos e recortes diferentes. Você define uma vez; o chat aplica em todas as perguntas que tocam o conceito.
Como criar um indicador
Os indicadores vivem dentro do editor da aplicação, na aba Conceitos IA.
- Abra a aplicação no modo de edição (ícone de lápis no menu superior).
- Acesse a aba Conceitos IA.
- Há dois caminhos:
Manualmente — botão "Novo Indicador"
Você preenche os campos diretamente (Nome, Valor Principal, Coluna de Data, etc.). Use quando já sabe exatamente o que quer cadastrar.
Automaticamente — botão "Gerar com IA"
Você descreve em linguagem natural ("faturamento líquido considerando apenas vendas confirmadas, com tempo medido pela data de emissão"). A IA sugere a configuração, você revisa, ajusta se precisar e salva.
TIP
O modo automático é ótimo para popular os primeiros indicadores da aplicação rapidamente. Mas sempre revise — em modelos ambíguos, a sugestão pode escolher uma coluna parecida em vez da que você quer.
Para a referência detalhada da UI (formulário, duplicar, expandir, excluir), veja Aba Conceitos IA.
Os campos em detalhe
Cada indicador é descrito por um pequeno conjunto de campos. Entender o propósito de cada um é o que separa um indicador bom de uma definição vaga.
Nome (obrigatório)
O termo que as pessoas da sua empresa de fato usam quando falam desse conceito. Em português, sem jargão técnico.
✅ "Faturamento", "Ticket Médio", "Inadimplência", "Pedidos em Aberto"
❌ "SUM_VLR_LIQ", "FAT_2024", "Vendas_Mensal_Por_Filial"O nome é o sinal mais forte que o chat usa para identificar quando aplicar o indicador. Se você o nomear "Vendas" mas a sua empresa fala "Faturamento", o indicador perde valor.
Descrição (opcional)
Texto livre com a nuance do conceito. Use para diferenciar conceitos parecidos ou registrar uma regra de negócio sutil que o nome sozinho não carrega:
Descrição: "Faturamento comercial. Considera apenas vendas confirmadas
do canal direto. Não inclui receita financeira (juros, multas)."A descrição não substitui um indicador novo
Se a descrição está crescendo a ponto de "explicar dois conceitos diferentes em um só indicador", isso é sinal de que você precisa de dois indicadores, não de uma descrição maior.
Valor Principal (obrigatório)
A coluna ou expressão que representa a métrica desse conceito. Tem que ser uma medida — algo que se soma, conta ou agrega.
Valor Principal: [Fato Vendas]."VALOR_LIQUIDO" (soma)Valores Alternativos (opcional, mas muito importante)
Outras métricas que compartilham o mesmo contexto desse indicador — mesma tabela, mesma data, mesmos filtros. É aqui que você evita criar indicadores redundantes.
Exemplo: o indicador "Faturamento" tem Valor Líquido como principal, e Lucro, Margem (%), Ticket Médio e Quantidade Vendida como alternativos. Quando alguém pergunta "qual o ticket médio do mês?", o chat usa o mesmo indicador Faturamento, só troca a métrica.
Alternativos são métricas, não dimensões
Valores Alternativos são outras medidas do mesmo contexto (Lucro, Margem, Ticket Médio). Dimensões de quebra — como Filial, Produto, Cliente — não pertencem ao indicador: elas vêm das colunas da aplicação e o usuário escolhe na hora de fazer a pergunta.
Coluna de Data (opcional, mas quase sempre presente)
A coluna usada quando a pergunta envolve tempo. Sem ela, "faturamento do mês passado" não tem ancoragem temporal e o chat precisa adivinhar entre as datas disponíveis.
Coluna de Data: [Calendário]."DATA" (mapeada para Data de Emissão)Filtros Padrão (recomendado)
Contexto fixo que sempre se aplica a esse conceito. Use quando o conceito tem uma regra de negócio que não pode ser esquecida.
Filtros Padrão: Status = "Confirmado"Sem esse filtro, "faturamento" passaria a incluir vendas canceladas e pendentes — distorcendo todas as respostas. Filtros padrão são a forma de garantir que o conceito chega íntegro em qualquer pergunta.
Comportamento que você precisa entender
Esse é o ponto onde a maioria das pessoas se enrosca, então vale entender devagar:
Todos os indicadores da aplicação são carregados em cada conversa
Quando alguém abre uma conversa com o chat sobre uma aplicação, o catálogo inteiro de indicadores daquela aplicação entra junto como contexto. O chat olha pra esse catálogo e escolhe os indicadores relevantes pra responder.
Esse comportamento tem uma consequência direta:
- Poucos indicadores bem definidos → o chat olha 10 ou 20 cartas na mesa, identifica rapidamente o conceito certo, responde com clareza.
- Muitos indicadores parecidos → o chat precisa filtrar entre centenas de opções similares. Ele gasta mais tempo decidindo, pode misturar definições de indicadores próximos e tende a alucinar mais.
Em outras palavras: excesso de indicadores piora o chat. A qualidade sobe com indicadores curados e cai quando o catálogo vira um inventário pulverizado.
Custo cresce junto com o catálogo
Esse mesmo catálogo entra no processamento a cada mensagem da conversa — incluindo respostas triviais como "oi, bom dia" ou "obrigado". Em uma aplicação com centenas de indicadores cadastrados, mesmo um simples cumprimento puxa o catálogo inteiro pra dentro do turno, o que se traduz em consumo de tokens (e custo) muito maior por interação. Catálogos enxutos não só respondem melhor — respondem mais barato.
O anti-padrão "dicionário gigante"
A intuição errada mais comum é: "quanto mais indicadores eu cadastrar, melhor o chat fica". É o oposto. Quando o catálogo passa de algumas dezenas, o chat perde foco — passa a hesitar entre opções parecidas e mistura definições.
Padrões a evitar
| Padrão errado | Por quê é ruim |
|---|---|
| Criar um indicador para cada variação de pergunta ("Vendas", "Vendas Mensais", "Vendas por Filial", "Vendas Ontem"…) | Todas são a mesma definição de "Vendas". Agrupamento, período e recorte são como o chat usa o indicador, não definições novas. |
| Criar um indicador por dimensão de quebra ("Receita por Cliente", "Receita por Produto", "Receita por Cidade"…) | A dimensão é decidida pela pergunta. Um indicador "Receita" cobre todas. |
| Replicar o mesmo indicador com filtros temporais diferentes ("Faturamento de 2024", "Faturamento Mensal", "Faturamento Diário") | Filtro de tempo o chat aplica sozinho. O recorte temporal pertence à pergunta, não à definição. |
| Criar um indicador para cada métrica relacionada quando elas compartilham o mesmo contexto (mesma data, mesmos filtros) | Use o campo Valores Alternativos dentro de um indicador. Um indicador "Faturamento" pode listar Lucro, Margem, Ticket Médio, Quantidade como alternativos. |
O nome "dicionário gigante" é literal: cada possível pergunta vira um verbete. O catálogo cresce sem parar, fica difícil de manter, e o chat fica pior, não melhor.
Sinais de mau dimensionamento
Alguns sinais práticos de que o catálogo está virando dicionário gigante:
- Mais de 50 indicadores numa única aplicação. Tipicamente um app de negócio tem entre 5 e 25 conceitos genuinamente diferentes. Acima de 50 quase sempre indica pulverização.
- Você consegue agrupar indicadores em "famílias" óbvias. Se cinco indicadores da lista são "Vendas X", "Vendas Y", "Vendas Z" — provavelmente é um único indicador "Vendas" com Valores Alternativos e a dimensão variando na pergunta.
- Dois indicadores têm o mesmo Valor Principal, mesma Coluna de Data, mesmos Filtros Padrão. São o mesmo indicador com nomes diferentes. Consolide.
- Existem indicadores cujo nome só faz sentido para quem cadastrou. Se ninguém na empresa fala assim no dia a dia, ninguém vai perguntar assim — e o indicador vira ruído.
- As respostas do chat ficaram inconsistentes depois que o catálogo cresceu. É sintoma de excesso de indicadores parecidos competindo entre si.
Heurística
Se você tem mais de 50 indicadores numa única aplicação, provavelmente está virando catálogo telefônico. Vale auditar.
Boas práticas
Pergunte antes: "quantos conceitos genuinamente diferentes existem aqui?"
Tipicamente são 5 a 25 indicadores por aplicação. Faça a lista no papel primeiro, depois cadastre. Comece pelos conceitos que as pessoas perguntam, não pelos que existem no banco.
Um indicador = um conceito de negócio
A pergunta-teste: se duas pessoas diferentes da empresa, ao ouvir o nome do indicador, descrevem a mesma métrica, é um conceito. Se elas descrevem coisas ligeiramente diferentes, talvez sejam dois indicadores genuínos — ou talvez seja um conceito mal nomeado.
Agrupe métricas relacionadas em "Valores Alternativos"
Se cinco métricas (Receita, Lucro, Margem, Ticket Médio, Quantidade) compartilham mesma data, mesma tabela, mesmos filtros padrão, são um único indicador com cinco valores. Não cinco indicadores.
Use o campo Descrição para nuance, não para criar outro indicador
Se a diferença entre dois indicadores é uma frase ("este desconsidera estornos"), a Descrição do indicador resolve. Se a diferença é genuína (tabelas diferentes, datas diferentes, filtros diferentes), então sim, são dois indicadores.
Cuide do nome
Linguagem que sua empresa de fato usa, em português, sem siglas técnicas. O nome do indicador é o canal pelo qual a IA reconhece "esta pergunta é sobre este conceito" — se o nome não bate com o vocabulário da empresa, o indicador passa despercebido.
Revise periodicamente
- Se um indicador nunca é usado, remova ou consolide.
- Se dois indicadores sempre são chamados juntos na mesma pergunta, consolide num só com Valores Alternativos.
- Se o chat erra consistentemente em algum conceito, o indicador relacionado pode estar mal definido (coluna errada, filtro faltando).
Quando estiver na dúvida, menos é mais
Você sempre pode adicionar um indicador novo depois. É muito mais difícil descobrir que o catálogo cresceu demais e ter que limpar 400 indicadores.
Próximos passos
- Veja Exemplos de Indicadores para casos práticos lado a lado: indicadores bem feitos vs anti-exemplos do "dicionário gigante".
- Entenda Como o chat responde para ver onde os indicadores entram no processo de uma pergunta.
- Consulte a Aba Conceitos IA para a referência detalhada da UI (formulário, duplicar, expandir, excluir).
- Explore o Cockpit de Indicadores para ver como os indicadores curados aparecem como cards ao vivo para os usuários.