Buscar K
Aparência
Aba Conceitos IA
A aba Conceitos IA é onde você cadastra e gerencia os fatos da aplicação — definições explícitas dos conceitos do seu negócio que o chat usa para responder com precisão e consistência.
Conceito antes de UI
Esta página é a referência rápida da UI. Para entender o que é um fato, quando criar, e os erros comuns (como o anti-padrão "dicionário gigante" com centenas de fatos pulverizados), veja Fatos: Ensinando seu Negócio — leitura recomendada antes de cadastrar fatos novos.
Cadastrando um Fato
Manualmente
- Clique no botão "Novo Insight".
- Preencha os campos do formulário.
- Clique em Salvar.
Com Inteligência Artificial
- Clique no botão "Gerar Insight Automaticamente".
- Descreva em linguagem natural o conceito que deseja criar.
- A IA sugere a configuração do fato.
- Revise e ajuste se necessário — em modelos ambíguos, a sugestão pode escolher uma coluna parecida em vez da que você quer.
- Clique em Salvar.
Campos do Fato
Campos Obrigatórios
| Campo | Descrição |
|---|---|
| Nome | Termo que os usuários utilizarão nas perguntas ("Faturamento", "Inadimplência"). Use a linguagem que sua empresa de fato usa. |
| Valor Principal | Coluna ou Expressão que representa esse conceito (deve ser uma medida — algo que se soma, conta ou agrega). |
Campos Opcionais
| Campo | Descrição |
|---|---|
| Prompt | Descrição adicional para ajudar a IA a entender o contexto e diferenciar conceitos similares. Use para nuance, não para criar outro fato. |
| Valores Alternativos | Outras métricas relacionadas que compartilham o mesmo contexto (data, filtros). É o caminho para evitar fatos redundantes. |
| Coluna de Data | Permite que a IA filtre por períodos temporais ("ontem", "último mês", "trimestre passado"). |
| Filtros Padrão | Contexto fixo aplicado automaticamente (ex.: apenas vendas com status "Confirmado"). |
Para entender o propósito de cada campo e como combiná-los bem, veja Os campos em detalhe.
Gerenciando Fatos
Visualizar e Editar
A tabela lista todos os fatos cadastrados com:
- Nome
- Valores associados
- Configuração de data
Clique na seta para expandir e editar os detalhes do fato.
Duplicar Fato
Utilize o ícone de copiar para criar um novo fato baseado em um existente. Útil quando você precisa de uma variação que de fato representa um conceito diferente.
WARNING
Duplicar é tentador, mas é o ponto de entrada para o anti-padrão "dicionário gigante". Antes de duplicar, pergunte: isto é um conceito diferente, ou é o mesmo conceito com um agrupamento/período diferente? No segundo caso, não duplique — o chat aplica agrupamentos e períodos sozinho a partir da pergunta.
Excluir Fato
Clique no ícone de lixeira para remover o fato. Uma confirmação será solicitada.
Expandir/Recolher Todos
Utilize o botão "Expandir Todos" para ver os detalhes de todos os fatos de uma vez. Útil em revisões periódicas do catálogo.
Próximos passos
- Fatos: Ensinando seu Negócio — conceito, boas práticas e anti-padrões.
- Exemplos de Fatos — casos práticos lado a lado.
- Chat com Dados — Visão Geral — como o chat consome os fatos cadastrados.