Skip to content

Chat com Dados

O Chat com Dados é o assistente de IA do Lumo: você pergunta em linguagem natural e ele responde olhando seus dados reais. Ele enxerga as aplicações, executa consultas e devolve insights ancorados nos seus números.

Nomenclatura

O assistente do Lumo é chamado Lumia por padrão. Em ambientes whitelabel ele pode ser renomeado pelo administrador do tenant, então ao longo da documentação preferimos os termos genéricos — "o chat", "o assistente", "a IA do Lumo".


Onde o chat aparece

O chat está disponível em vários pontos da plataforma:

  • Sidebar de Insights — no menu lateral esquerdo, ícone de chat. Ocupa um painel lateral persistente, ideal para conversas longas ou quando você está alternando entre dashboards.
  • Janela Flutuante — abre como popup, útil para perguntas rápidas sem sair do que está vendo.
  • Dentro de uma aplicação — o botão de chat continua acessível enquanto você navega num dashboard, como uma forma rápida de complementar com perguntas o que já está sendo exibido.

"Perguntar ao chat" vs "olhar o dashboard"

São formas complementares de consumir dados.

DashboardChat
FormaVisual fixo, definido por quem construiuResposta sob demanda, em texto
Bom paraAcompanhar métricas conhecidas, comparações pré-pensadasPergunta nova, exploração ad-hoc, cruzamento incomum
VelocidadeImediato — já está montadoAlguns segundos — precisa consultar
ProfundidadeLimitado ao que foi montadoPode investigar dimensões diferentes a cada pergunta

A regra prática: se você já sabe o que quer ver toda semana, faça dashboard. Se você quer perguntar coisas que mudam a cada vez, use o chat.


Modos de resposta

O chat oferece dois modos, selecionáveis acima da caixa de mensagem:

  • Rápido — para perguntas diretas e métricas pontuais. Responde em segundos.
  • Raciocínio — para análises mais complexas (investigação de causa, comparativos com várias dimensões). Mais lento, mas mais cuidadoso.

A regra prática: comece em Rápido. Se a resposta vier rasa demais, refaça a pergunta em Raciocínio.


Escolher qual agente responde

Por padrão, quem responde no chat é o assistente do Lumo. Mas você pode ter criado agentes próprios — personas de investigação com instruções e escopo específicos, como "Analista de inadimplência" ou "Vigia do funil comercial". Um seletor no topo do chat deixa você escolher qual deles conduz a conversa.

No seletor aparecem o assistente padrão e todos os agentes marcados como "Disponível no chat". Ao trocar de agente, as próximas perguntas passam a ser respondidas com a persona, o escopo de aplicações e o esforço configurados naquele agente — sem que você precise repetir contexto a cada mensagem.

Quando trocar de agente

Use o assistente padrão para perguntas gerais e exploração livre. Escolha um agente próprio quando quer uma investigação sempre com o mesmo recorte — as mesmas aplicações, o mesmo jeito de responder — como se tivesse um analista dedicado àquele assunto.

Os agentes são criados e testados no módulo Agentes de IA. Lá você também decide quais deles ficam disponíveis aqui no chat.


Como ele "pensa", em alto nível

Quando você pergunta algo, o chat:

  1. Descobre quais dados estão disponíveis na aplicação (tabelas, colunas, indicadores configurados).
  2. Resolve nomes mencionados (ex.: "cliente acme" vira "ACME Indústrias S.A.").
  3. Executa consultas reais sobre seus dados — os números vêm direto do banco.
  4. Consolida os números em uma resposta em linguagem natural.

Por isso a resposta vem como insight ("vendas caíram 12% no comparativo semanal, puxado pela Filial Centro") e não como tabela bruta. Para a tabela bruta, use o Explorer ou um Relatório.

Para o detalhe do processo, veja Como o chat responde.


Como você ensina o seu negócio

O chat consegue responder mesmo sem nenhuma configuração — ele lê a estrutura da aplicação por conta própria. Mas o modelo de dados real quase sempre tem ambiguidade: múltiplas colunas que poderiam ser "vendas", múltiplas datas que poderiam ser "tempo".

Sem configuração, o chat faz uma escolha razoável a cada conversa — mas a escolha não é determinística. Para que a resposta seja consistente, você configura indicadores: definições explícitas de cada conceito do seu negócio (qual coluna é a métrica, qual a data, quais filtros padrão).

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 dos indicadores é cuidar ao mesmo tempo da qualidade das respostas e da inteligência do cockpit.

Comece pelos indicadores

Se você nota o chat dando respostas inconsistentes, é quase sempre porque faltam indicadores — ou porque tem indicadores demais competindo entre si. Veja Indicadores: Ensinando seu Negócio para entender o conceito e os erros comuns.


IA pode errar

O chat sempre consulta seus dados reais para chegar nos números — ele não inventa valores. Mas pode interpretar a pergunta de outro jeito que você esperava, ou tirar conclusões além do que os dados sustentam.

A linha que aparece no rodapé do chat — "IA pode cometer erros. Verifique informações importantes." — é literal. Para decisões importantes, vale conferir os números no dashboard ou no Explorer.


Próximos passos

  • Como o Chat Responde — o caminho de uma pergunta, modos Rápido vs Raciocínio, memória entre conversas, aprendizado tácito.
  • Indicadores: Ensinando seu Negócio — a peça central. O que é um indicador, por que importa, e o anti-padrão "dicionário gigante".
  • Exemplos de Indicadores — casos práticos: indicadores bem feitos, anti-exemplos, e quando vale separar de verdade.
  • Agentes de IA — criar personas de investigação próprias e escolher quais respondem aqui no chat.
  • Aba Conceitos IA — referência detalhada da UI de cadastro de indicadores na aplicação.
  • Cockpit de Indicadores — painel ao vivo com status RAG, variação vs ciclo anterior e seus indicadores favoritos.