Base de Conhecimento

O que é a Base de Conhecimento?

A Base de Conhecimento do Mitra permite que um projeto funcione como fonte central de dados dentro de um workspace.

A partir desse projeto base, é possível criar novos projetos já conectados aos dados, utilizando Tags para definir exatamente quais informações cada projeto terá acesso.

Esse modelo garante:

• Centralização da lógica de dados

• Padronização das informações

• Atualizações automáticas para projetos dependentes

• Menos retrabalho e menos risco de inconsistência

Conceito geral de funcionamento

Dentro de um mesmo workspace:

• Existe um projeto definido como Base de Conhecimento

• Esse projeto organiza seus dados por meio de Tags

• As Tags agrupam:

  • Tabelas físicas do banco

  • Tabelas Online (consultas SQL reutilizáveis)

Quando um novo projeto é criado a partir da Base de Conhecimento:

• O usuário seleciona uma ou mais Tags

• O Mitra conecta automaticamente os dados correspondentes ao novo projeto

Após criado, não é possível alterar as Tags vinculadas a um projeto.

Projeto Base de Conhecimento

O que define um projeto como Base de Conhecimento?

• Qualquer projeto pode ser definido como Base de Conhecimento

• Em cada workspace, apenas um projeto pode exercer esse papel

• Ao marcar um novo projeto como base, o anterior é automaticamente desmarcado

Essa definição não cria um tipo especial de projeto, apenas atribui uma função central de compartilhamento de dados.

Tags

O que são Tags?

Tags são rótulos de organização de dados criados dentro do projeto Base de Conhecimento.

Elas permitem agrupar informações relacionadas, como:

• Vendas

• Financeiro

• RH

• Operações

Cada Tag pode estar associada a:

• Tabelas físicas do banco

• Tabelas Online

Governança e histórico das Tags

As Tags ficam registradas na tabela INT_TAG, que mantém histórico completo de criação e alteração, incluindo:

• Usuário que criou a Tag

• Data de criação

• Usuário da última alteração

• Data da última alteração

Isso garante rastreabilidade e governança na Base de Conhecimento.

Tabelas Online

O que são Tabelas Online?

Tabelas Online são consultas SQL nomeadas, que funcionam como tabelas virtuais dentro do Mitra.

Elas:

• Não criam tabelas físicas

• Não criam views no banco

• Podem ser usadas diretamente em componentes

• Centralizam regras de negócio e cálculos

Para o usuário, se comportam como tabelas comuns.

Atenção importante: Não se deve criar uma tabela online com nome igual ao nome da tabela orignal do banco!

Conexão JDBC das Tabelas Online

Ao criar uma Tabela Online, é obrigatório escolher uma conexão JDBC.

Essa conexão não pode apontar para o próprio projeto onde a Tabela Online está sendo criada.

A Tabela Online deve sempre apontar para:

• O banco de dados da Base de Conhecimento, ou

• Um banco de dados externo, como ERP, CRM ou outro sistema corporativo

Com isso:

• A IA do Mitra passa a conhecer essas tabelas externas

• É possível solicitar à IA a criação de componentes e dashboards utilizando esses dados

Esse modelo evita dependências circulares e garante clareza na origem dos dados.

Como funcionam tecnicamente (conceito importante)

No momento em que um componente executa uma consulta, o Mitra expande automaticamente a Tabela Online utilizando cláusulas WITH (CTEs).

Exemplo:

-- O que o usuário escreve:
SELECT * FROM receita_mensal WHERE regiao = 'SP'

O Mitra transforma internamente essa consulta em algo equivalente a:

WITH receita_mensal AS (
  SELECT mes, SUM(valor) 
  FROM pedidos 
  GROUP BY mes
)
SELECT * FROM receita_mensal WHERE regiao = 'SP'

Uso de Tabelas Online com a IA

Ao conversar com a IA do Mitra:

• A IA enxerga as Tabelas Online como tabelas normais

• É possível pedir a criação de componentes e dashboards usando essas tabelas

• A IA conhece a query que define a Tabela Online

Uma boa prática é incluir comentários na query explicando:

• O propósito da tabela

• Como ela deve ser utilizada

• Regras de negócio importantes

Esses comentários ajudam a IA a gerar componentes mais alinhados ao contexto do negócio.

Ocultar a query de uma Tabela Online da IA

Se for necessário impedir que a IA tenha acesso ao conteúdo da query, é possível configurar o sistema com o script:

INSERT INTO INT_PARAMETER 
VALUES ('SKIP_ONLINE_TABLE_QUERY_ALIAS_CONTENT','true')

Com essa configuração:

• A IA continua utilizando a Tabela Online

• Mas não conhece a lógica SQL interna

Relacionamento entre Tags e Dados

As Tags definem quais dados fazem parte de cada contexto.

Quando uma Tag é utilizada por um projeto:

• Alterações em Tabelas Online da Tag refletem automaticamente no projeto

• Novas tabelas vinculadas à Tag passam a estar disponíveis

• Tabelas removidas da Tag deixam de ser acessíveis no projeto

Esse comportamento é automático e centralizado.

Criação de projetos a partir da Base de Conhecimento

Durante a criação de um novo projeto, o usuário pode:

• Escolher a Base de Conhecimento

• Selecionar as Tags desejadas

O Mitra realiza toda a configuração necessária.

Após a criação, não é possível alterar as Tags vinculadas ao projeto.

Boas práticas

• Planeje bem as Tags antes de criar projetos consumidores

• Use Tabelas Online para dados externos e regras de negócio

• Centralize lógicas importantes na Base de Conhecimento

• Utilize comentários nas queries para orientar a IA

• Evite mudanças frequentes em Tags amplamente utilizadas