Conhecimento de Dominio

O Conhecimento de Dominio ajuda sua equipe a transformar conhecimento espalhado em uma base unica e revisavel. Em vez de cada dashboard, analise ou prompt usar uma definicao diferente, voce registra termos, metricas, relacoes e sugestoes de IA em um lugar que pode ser consultado e evoluido com seguranca.

Por que usar?

• Evita definicoes conflitantes: "cliente ativo", "receita liquida" e outros termos passam a ter um significado oficial.
• Acelera trabalho em equipe: analistas, gestores e revisores passam a falar a mesma lingua.
• Melhora a IA do produto: o contexto aprovado deixa as sugestoes e respostas mais consistentes.
• Cria governanca sem travar o time: voce pode comecar simples e formalizar o dominio aos poucos.

Data Catalog x Conhecimento de Dominio

As duas areas se complementam:

Area	Pergunta principal
Data Catalog	Onde esta o dado?
Conhecimento de Dominio	O que isso significa, como medir e como se relaciona?

Quando usar

Use Data Catalog para tabelas, colunas, descricoes fisicas, amostras e visibilidade. Use Conhecimento de Dominio para termos, regras, metricas oficiais, entidades de negocio e relacoes conceituais.

O que voce encontra aqui

📘 Concepts

Defina termos e regras do negocio em linguagem clara

📊 Semantic Layer

Formalize metricas, entidades e dimensoes compartilhadas

🕸 Ontology

Modele relacoes importantes do dominio quando precisar de mais precisao

🤖 AI Suggestions

Receba sugestoes da IA e publique apenas o que foi revisado

Como usar cada area

Concepts

Comece por aqui. Concepts funciona como um glossario vivo do negocio.

Use quando voce quiser registrar:

• termos importantes;
• regras operacionais;
• definicoes que hoje vivem em planilhas, mensagens ou memoria do time.

Exemplo: "Cliente ativo" = cliente com pelo menos uma compra nos ultimos 90 dias.

Hoje voce pode criar, editar, buscar e arquivar conceitos, alem de vincula-los ao catalogo tecnico quando fizer sentido.

Diferenca entre termo, regra, entidade, metrica e politica

Tipo	Quando usar	Exemplo
Termo	Quando voce quer definir o significado de uma palavra ou expressao usada pelo time	"Cliente ativo"
Regra	Quando voce quer registrar uma condicao, criterio ou decisao operacional	"Pedido acima de R$ 500 exige aprovacao"
Entidade	Quando voce quer nomear um objeto central do negocio que pode virar estrutura semantica ou ontologica	"Cliente", "Contrato", "Campanha"
Metrica	Quando voce quer marcar uma medida oficial ou candidata a medida oficial	"Receita liquida", "CAC", "CPM"
Politica	Quando voce quer documentar uma diretriz, restricao ou orientacao formal do negocio	"Nao reutilizar leads sem consentimento"

Regra pratica:

• use Termo para significado;
• use Regra para comportamento esperado;
• use Entidade para coisas ou atores do negocio;
• use Metrica para numeros que precisam de interpretacao consistente;
• use Politica para normas e limites.

Semantic Layer

A Semantic Layer e a etapa em que um conceito vira uma definicao reutilizavel para analise.

Use quando voce precisar:

• definir uma metrica oficial;
• nomear entidades do negocio de forma consistente;
• registrar como uma medida deve ser interpretada em dashboards e analises.

Exemplo: "Receita liquida" = faturamento menos descontos e devolucoes.

Hoje voce pode manter entidades, metricas, dimensoes e mapeamentos. Recursos mais avancados de modelagem continuam no roadmap.

Ontology

Ontology entra quando so definir termos e metricas nao basta e voce precisa deixar explicitas as relacoes do dominio.

Use quando for importante modelar:

• quem se relaciona com quem;
• eventos e estados importantes;
• hierarquias e regras de associacao.

Exemplo: "Cliente faz Pedido" ou "Contrato pertence a Empresa".

Hoje voce pode manter nos e relacoes e tambem usar Gerar com IA para propor um grafo inicial revisavel a partir dos conceitos entity_hint e da estrutura completa de uma conexao sincronizada.

Geracao automatica de ontologia

Na tela Ontology, voce pode usar Gerar com IA para criar sugestoes pendentes de nos e relacoes do grafo de conhecimento.

Pre-requisitos:

• existir pelo menos um conceito com type = entity_hint;
• existir pelo menos uma conexao sincronizada com metadata tabular disponivel.

Contexto usado na v1:

• todos os conceitos entity_hint ativos ou draft da empresa;
• a estrutura tabular completa da conexao escolhida (table + view);
• todos os relacionamentos persistidos dessa conexao;
• contexto adicional opcional digitado pelo usuario.

Comportamento da v1:

• roda de forma assincrona;
• usa openai/gpt-5.4 para gerar o lote;
• cria apenas sugestoes pendentes para revisao humana;
• reconcilia com a ontologia ja existente para sugerir update quando houver match seguro e create quando nao houver;
• pode criar sugestoes de relacao dependentes de sugestoes de nos ainda nao aceitas;
• exige que os nos dependentes sejam aceitos antes da aceitacao da nova relacao.

AI Suggestions

A IA ajuda a acelerar a documentacao do dominio, mas a publicacao continua controlada pela sua equipe.

Use quando voce quiser:

• receber rascunhos de descricoes;
• promover conceitos para metricas ou relacoes mais formais;
• gerar sugestoes de novos conceitos a partir de dominios de negocio, texto adicional e arquivos de apoio;
• revisar rapidamente o que faz sentido e descartar o que nao representa o negocio.

Toda sugestao passa por revisao antes de virar conhecimento publicado.

Geracao automatica de conceitos

Na tela Concepts, voce pode usar Gerar com IA para criar sugestoes pendentes de novos conceitos ou ajustes em conceitos existentes.

Pre-requisito:

• a empresa precisa ter ao menos um Dominio de Negocio cadastrado em Configuracoes > Empresa > Dominios de Negocio.

Contexto opcional aceito na v1:

• texto adicional livre;
• um arquivo .docx, .xlsx, .csv, .tsv, .txt ou .md.

Comportamento da v1:

• usa todos os dominios de negocio cadastrados como contexto base;
• envia para a IA o snapshot atual de conceitos active e draft como base ja existente;
• roda de forma assincrona;
• cria apenas sugestoes pendentes para revisao humana;
• pode sugerir enriquecimento completo de conceito existente (name, description, type, aliases, tags) ou criacao de novo conceito;
• quando uma nova geracao termina com sugestoes validas, ela substitui o lote pendente anterior gerado em batch;
• se a nova geracao terminar vazia ou falhar, o lote pendente anterior e preservado.

Jornada recomendada

1. Comece registrando os termos mais usados pelo time em Concepts.
2. Revise as sugestoes de IA para acelerar a primeira versao dessa base.
3. Promova para Semantic Layer o que precisar virar metrica, entidade ou dimensao oficial.
4. Use Ontology apenas quando as relacoes do dominio precisarem ser modeladas com mais clareza.
5. Mantenha apenas conhecimento revisado como referencia para chats, analises e dashboards.

Governanca, Permissoes e Multi-Tenancy

• o conhecimento pertence a empresa;
• team continua como extensao futura de aplicabilidade;
• a area opera com isolamento entre empresas.

Regra importante

A revisao de sugestoes e separada da publicacao das mudancas. Isso ajuda a manter controle sobre o que entra como conhecimento oficial.

O que ja esta disponivel e o que vem depois

Tema	Situacao
Concepts	Disponivel hoje
Semantic Layer	Disponivel hoje
Ontology	Disponivel hoje
Revisao de sugestoes de IA	Disponivel hoje
Uso do conhecimento aprovado nas experiencias de IA do produto	Disponivel hoje
Modelagem semantica mais avancada	Planejado
Ontologia mais formal e detalhada	Planejado
Enriquecimento em escala com mais automacao	Disponivel hoje para geracao de conceitos e ontologia
Aplicabilidade por time	Planejado

Veja Tambem

• Data Catalog
• Approval Cycle
• API de Conhecimento de Dominio