Documentação HorusBI
Buscar K

Aparência

Como o Chat Responde ​

Esta página explica, em alto nível, o que acontece entre você enviar uma pergunta e receber uma resposta — o suficiente para entender por que o chat se comporta como se comporta e o que você pode fazer para que ele responda melhor.

O caminho de uma pergunta ​

1. Identifica a aplicação ​

O chat enxerga todas as aplicações que você tem acesso e decide qual usar com base no texto da pergunta. Se a pergunta menciona claramente uma área ("qual o faturamento de ontem?", "como está o estoque?"), ele identifica a aplicação pelos termos. Se for ambígua, ele pode perguntar de qual aplicação você está falando ou listar as disponíveis.

TIP

Vale citar a aplicação no início da conversa quando há risco de ambiguidade — especialmente se conceitos parecidos existem em mais de uma aplicação (ex.: "faturamento" pode estar em "Vendas" e em "Financeiro" com definições diferentes).

2. Descobre dados e fatos disponíveis ​

O chat enxerga a estrutura da aplicação — tabelas, colunas, expressões, dashboards — e carrega o catálogo de fatos da aplicação. É a partir dessa visão que ele decide como responder.

Por que os fatos importam aqui

Os fatos entram nesta etapa, como ponto de partida curado. Em vez de o chat decidir do zero "qual coluna é faturamento?", ele vê que existe um fato Faturamento definido pela aplicação e usa a definição diretamente. Sem fatos, ele faz uma escolha razoável examinando colunas e nomes — mas a escolha pode variar entre conversas.

Veja Fatos: Ensinando seu Negócio para entender como configurá-los.

3. Resolve nomes mencionados ​

Se a pergunta tem termos aproximados ("cliente acme", "produto x"), o chat faz uma busca textual nos valores das colunas para resolver o nome exato — "cliente acme" pode virar "ACME Indústrias S.A." no banco.

Essa resolução é uma das partes mais valiosas do chat: ela isola você de saber a forma exata como cada valor está cadastrado.

4. Executa uma ou mais consultas ​

Com aplicação identificada, contexto de fatos carregado e nomes resolvidos, o chat executa consultas reais no seu modelo de dados. Os números que entram no insight final são lidos diretamente do banco a cada pergunta.

Uma única pergunta pode envolver várias consultas em sequência. Por exemplo, "compare o faturamento desta semana com a média das últimas 4" envolve duas consultas — uma para o período atual, outra para o histórico — depois um cálculo de comparação.

5. Consolida o insight ​

Por fim, o chat consolida os dados em uma mensagem em linguagem natural: número, contexto, comparação, interpretação. É por isso que o chat raramente devolve tabelas brutas — a entrega é o insight interpretado.

Por que vem como insight e não como tabela

Se você quer a tabela bruta, use o Explorer da aplicação ou um Relatório. O chat é a ferramenta certa quando você quer a resposta interpretada, não a planilha pra interpretar.

O chat funciona sem fatos? ​

Sim. O chat consegue ler a estrutura da aplicação por conta própria e responder mesmo sem nenhum fato cadastrado.

O que muda sem fatos é a consistência:

  • Em modelos reais sempre há ambiguidade — múltiplas colunas que poderiam ser "vendas", múltiplas datas que poderiam ser "tempo".
  • Sem fatos, o chat faz uma escolha razoável em cada conversa. Mas a escolha não é determinística — pode acertar hoje e errar amanhã na mesma pergunta, porque mais de um caminho parecia válido.

Com fatos, o chat tem um ponto de partida fixo: para o conceito "Faturamento" nesta aplicação, a definição certa envolve esta coluna, esta data e estes filtros. A ambiguidade desaparece.

Modos: Rápido vs Raciocínio ​

Acima da caixa de mensagem há um seletor de modelo:

ModoQuando usar
RápidoPerguntas diretas, métricas pontuais, comparações simples. Responde em segundos.
RaciocínioAnálises mais complexas, investigação de causa, comparações com várias dimensões. Mais lento, mas responde melhor.

A regra prática: comece no Rápido. Se a resposta vier rasa demais para a complexidade da pergunta, repita a pergunta no Raciocínio.

O modo de raciocínio consome mais processamento de IA — é mais caro pelo tenant. Use quando o ganho de qualidade compensa.

Memória entre conversas ​

O chat tem dois níveis de memória, e vale entender a diferença.

Dentro da conversa atual ​

Mensagens anteriores da mesma conversa ficam no contexto. Se você pergunta "qual o faturamento de março?" e depois "e em abril?", o chat entende que "em abril" se refere à mesma métrica — ele lembra do que você perguntou antes.

Entre conversas diferentes ​

Conversas diferentes começam do zero. Se você abre uma "Nova Conversa", o chat não traz memória da conversa anterior. Para retomar um fio de raciocínio, abra a conversa antiga na lista.

TIP

Use a lista de Conversas para retomar análises em andamento. Cada conversa fica salva — você pode voltar dias depois.

Aprendizado tácito ​

Existe um mecanismo separado dos fatos que melhora o chat com o tempo: quando alguém pergunta usando um nome aproximado (ex.: "cliente acme") e o chat resolve para o valor exato no banco ("ACME Indústrias S.A."), essa associação fica gravada. A próxima pergunta com "acme" já parte do nome resolvido — não precisa refazer a busca.

Esse aprendizado é silencioso e contínuo. É diferente dos fatos: fatos são definições explícitas de conceitos; o aprendizado tácito é só uma memória de "qual valor as pessoas chamam por qual apelido".

A consequência prática: quanto mais o chat é usado, melhor ele resolve nomes aproximados em valores — mas a definição dos conceitos continua dependendo dos fatos que você cadastra.

O chat não inventa números ​

O chat sempre executa consultas reais para chegar nos números que reporta. Se ele diz "vendas caíram 12%", esse 12% saiu de uma consulta de fato — não de estimativa.

O que o chat pode errar é:

  • Interpretar a pergunta de outro jeito que você esperava (especialmente sem fatos, onde a ambiguidade é maior).
  • Escolher uma coluna ou filtro diferente do que você teria escolhido.
  • Concluir além do que os dados suportam (ex.: tirar causa-raiz com base em correlação fraca).

A frase que aparece no rodapé do chat — "IA pode cometer erros. Verifique informações importantes." — é literal. Trate o chat como assistente: quando uma resposta vai virar decisão importante, confira os números no dashboard ou no Explorer.

Próximos passos ​