Personnaliser les descriptions d’entité pour la couche sémantique

Créez des descriptions d’entité personnalisées dans la table Configuration de table sémantique afin que les personnalisations puissent être transférées entre les instances via des ensembles de mises à jour.

Avant de commencer

Rôle requis : sn_query_gen.admin ou un rôle supérieur

Pourquoi et quand exécuter cette tâche

La Génération de requête couche sémantique utilise des descriptions en langage naturel pour aider l’IA à comprendre ce que chaque table représente. Par défaut, les descriptions sont dérivées automatiquement de la table Field Label (Étiquette de champ) [sys_documentation], mais vous pouvez remplacer ces descriptions par des descriptions personnalisées qui expliquent mieux l’objectif commercial de vos tables. Lorsque vous effacez une description personnalisée, le système revient à la valeur Étiquette de champ.

Cette procédure utilise la table Configuration de table sémantique. Les personnalisations effectuées de cette manière peuvent être transférées entre les instances via des ensembles de mises à jour et des descriptions de remplacement définies directement dans la table Entité. Pour des tests plus simples sur une seule instance, vous pouvez modifier le champ Description sémantique directement dans la table Entité [sn_query_gen_entity].

Remarque :

Les étiquettes d’entité et les instructions d’utilisation au niveau de l’entité ne peuvent être définies que dans la table Entité [sn_query_gen_entity]. La table Configuration de table sémantique prend uniquement en charge les descriptions d’entité.

Procédure

1. Accédez à la Génération de requête > Configuration de table sémantique.
2. Ouvrez l’enregistrement de votre table ou créez un enregistrement s’il n’en existe pas.

   Si vous créez un nouvel enregistrement, définissez Nom de table sur votre nom de table et Activer la génération sémantique sur sélectionné . Pour plus d'informations, consultez Ajouter une table à la couche de données sémantiques.

3. Dans le champ Description sémantique de l’entité , saisissez votre description personnalisée.

   4 000 caractères maximum. Rédigez la description dans un langage commercial simple qui explique ce que la table représente, qui l’utilise et son objectif commercial.

4. Sélectionnez Mettre à jour.
   Le système synchronise automatiquement la description personnalisée avec l’enregistrement de l’entité dans la couche sémantique.

Résultats

La description d’entité personnalisée est active et sera utilisée lors Génération de requête du traitement des requêtes pour cette table. Étant donné que cette personnalisation est stockée dans la table Configuration de table sémantique, elle peut être incluse dans un ensemble de mises à jour et transférée vers d’autres instances. Pour plus d'informations, consultez System update sets.

Descriptions d’entités

Cet exemple montre la différence entre les descriptions générées automatiquement et les descriptions personnalisées :

Tableau 1. Exemples de descriptions d’entités

Table	Généré automatiquement (faible)	Personnalisé (bien)
incident	Table d’incidents	Incidents informatiques, pannes, interruptions de service et tickets d’assistance informatique
alm_ai_digital_asset	Suit les enregistrements pour les actifs numériques IA.	Table d’inventaire de base pour tous les actifs numériques liés à l’IA dans le cadre de gouvernance de la Tour de contrôle IA (AICT). Chaque enregistrement représente un artefact d’IA (modèle, invite, ensemble de données, compétence, agent ou outil) suivi pour la gouvernance, la conformité et la gestion du cycle de vie. Les équipes de gouvernance, les chefs de produit et les propriétaires de plateformes d’IA utilisent cette table pour la surveillance centralisée de l’inventaire d’IA, la préparation aux audits et la traçabilité.

Que faire ensuite

Testez votre description personnalisée en posant des questions sur la table et en Génération de requête vérifiant que la table correcte est sélectionnée.