Personalize descrições de entidade para a camada semântica

Crie descrições de entidade personalizadas na tabela Configuração da tabela semântica para que as personalizações possam ser transferidas entre instâncias por meio de conjuntos de atualizações.

Antes de Iniciar

Função necessária: sn_query_gen.admin ou superior

Por Que e Quando Desempenhar Esta Tarefa

. Geração de consultas A camada semântica usa descrições em linguagem natural para ajudar a IA a entender o que cada tabela representa. Por padrão, as descrições são derivadas automaticamente da tabela Rótulo de campo [sys_documentation], mas você pode substituir essas descrições por descrições personalizadas que explicam melhor a finalidade comercial de suas tabelas. Quando você limpa uma descrição personalizada, o sistema retorna para o valor Rótulo do campo.

Este procedimento usa a tabela Configuração da tabela semântica. As personalizações feitas dessa maneira podem ser transferidas entre instâncias por meio de conjuntos de atualizações e descrições de substituição definidas diretamente na tabela de entidades. Para testes de instância única mais simples, você pode editar o campo Descrição semântica diretamente na tabela Entidade [sn_query_gen_entity].

Nota:

Os rótulos de entidade e as instruções de uso no nível de entidade só podem ser definidos na tabela Entidade [sn_query_gen_entity]. A tabela Configuração da tabela semântica é compatível somente com descrições de entidade.

Procedimento

1. Navegar até Geração de consulta > Configuração da tabela semântica.
2. Abra o registro da sua tabela ou crie um registro, se não existir um.

   Se estiver criando um novo registro, defina Nome da tabela para o nome da tabela e. Habilite a geração semântica para selecionado. Para obter mais informações, consulte Adicione uma tabela à camada de dados semânticos.

3. Em Descrição semântica da entidade insira sua descrição personalizada.

   Máximo de 4 000 caracteres. Escreva a descrição em linguagem comercial simples que explique o que a tabela representa, quem a usa e sua finalidade comercial.

4. Selecione Atualizar.
   O sistema sincroniza automaticamente a descrição personalizada com o registro da entidade na camada semântica.

Resultado

A descrição da entidade personalizada está ativa e será usada por Geração de consultas ao processar consultas para esta tabela. Como essa personalização é armazenada na tabela Configuração da tabela semântica, ela pode ser incluída em um conjunto de atualizações e transferida para outras instâncias. Para obter mais informações, consulte System update sets.

Descrições da entidade

Este exemplo mostra a diferença entre descrições geradas automaticamente e personalizadas:

Tabela 1. Exemplos de descrição da entidade

Tabela	Gerado automaticamente (ruim)	Personalizado (bom)
incidente	Tabela de incidentes	Incidentes DE TI, indisponibilidades, interrupções de serviço e tíquetes de suporte de TI
alm_ai_digital_asset	Rastreia registros de ativos digitais de IA.	Tabela de inventário de base para todos os ativos digitais relacionados à IA na estrutura de governança da Torre de controle de IA (AICT). Cada registro representa um artefato de IA: Modelo, prompt, conjunto de dados, habilidade, agente, ou: rastreado para governança, conformidade e gestão de ciclo de vida. As equipes de governança, gerentes de produto e proprietários de plataformas de IA usam esta tabela para supervisão centralizada do inventário de IA, prontidão para auditoria e rastreabilidade.

O que Fazer Depois

Teste sua descrição personalizada fazendo perguntas sobre a tabela em Geração de consultas e verificando se a tabela correta está selecionada.