Journaux de génération de requête

Chaque appel à un générateur de requêtes et ses résultats sont consignés dans la table Journal de génération de requête [sn_query_gen_log].

Utilisation des journaux

Accéder à Génération de requête > Administration > Journaux pour inspecter les requêtes ayant échoué ou incorrectes.

1. Recherchez l’entrée par utilisateur, date ou énoncé.
2. Vérifier le nombre d’entités sémantiques/dimensions/segments
3. Ouvrez la sortie du constituant de la requête pour voir ce qui a été sélectionné.
4. Comparer avec le résultat du filtre sémantique pour les correspondances sémantiques brutes.

Tableau 1. Explorateur IA de données Guide de dépannage

Symptôme	Cause probable	Corriger
Réponse « Impossible de comprendre »	Le système ne trouve pas de table correspondante	Améliorer la description de l’entité ; reformuler avec le nom du tableau ; vérifier que la recherche IA est en cours d’exécution ; Vérifiez que toutes les sources indexées sont entièrement traitées.
Table sélectionnée incorrecte	Noms de tables similaires, pas de désambiguïsation	Ajoutez des instructions d’utilisation sémantique pour différencier.
Table sélectionnée incorrecte (autorisations)	L’utilisateur n’a pas accès en lecture à la table ou aux champs prévus.	Vérifiez et attribuez des ACL de lecture de table et de champ pour les données prévues.
Réponse « Erreur d’accès aux données de table » ou « Accès au périmètre non accordé »	Certaines données se trouvent dans des périmètres d’application protégés auxquels l’accès Explorateur IA de données est impossible.	Créez des ACL accordant l’accès au champ d’application pour Explorateur IA de données. Approuvez les enregistrements d’accès restreint pour l’appelant (RCA) générés par la suite. Pour plus d'informations, consultez Permettre l’accès aux applications du périmètre protégé pour Explorateur IA de données et Génération de requête.
Champ manquant dans les résultats	Dimension désactivée, étiquette peu claire ou champ non dans la couche sémantique	Vérifier que la dimension est active ; Mettre à jour l’étiquette.
Champs connexes non extraits	Table référencée manquante dans la couche sémantique ou la dimension de référence désactivée	Ajoutez et activez l’entité de table référencée ; Activez la dimension de référence.
Filtre incorrect appliqué	Mauvaise correspondance de segment	Corriger le nom et la description du segment ; Désactivez le segment.
Aucun filtre quand attendu	Aucun segment correspondant ; Formulation trop vague	Créer un segment manuel ; Reformulez la question.
Le segment du rapport est incorrect	Le segment généré automatiquement a un filtre périmé ou non pertinent	Désactivez la source du segment de rapport ou le segment spécifique.

Tableau 2. Colonnes du journal de génération de requête

Colonne	Description	Affiché par défaut ?
Date de création	Horodatage de l’appel à Génération de requête	Oui
Utilisateur	L’utilisateur de la table Utilisateur [sys_user] qui a passé l’appel. Si ce champ est vide, essayez Créé par.	Oui
Énoncé	Question en langage clair posée par l’utilisateur	Oui
Statut	Réussite ou non de l’appel	Oui
Message d'erreur	Si l’état est « erreur », il s’agit du message d’erreur renvoyé à l’utilisateur.	Oui
Temps total	Temps en millisecondes nécessaire à l’IA pour traiter la requête et renvoyer la réponse	Oui
Heure « X »	Temps en millisecondes que chaque composant X a passé à traiter la requête	Oui
Résultats du filtre sémantique	Champs des tables de couche sémantique auxquelles la requête fait référence, au format JSON	Oui
Résultats de la banque d'énoncés	Questions similaires à la question de l’utilisateur (énoncé) qui ont été trouvées dans la banque d’énoncés et utilisées pour interpréter la question de l’utilisateur, au format JSON	Oui
Réponse	Réponse JSON à la requête	Oui
Entités	Les enregistrements de la table Entités qui sont référencés par la requête. Chaque enregistrement correspond à une table de faits.	Oui
Sortie du constituant de la requête	JSON de la requête générée	Oui
Source	Application à partir de laquelle la question a été posée. Si la question a été posée à partir du Now Assist panneau lorsqu’il était ouvert dans une page qui ne fait pas partie d’une application, l’UUID de cette page s’affiche à la place.	Oui
Réponse	Réponse renvoyée par le LLM	Oui
Journal d'IA générative	LLM utilisé pour la requête	Oui
Conversation	ID de conversation de messagerie instantanée unique, par exemple dans une conversation de génération de requête du panneau Now Assist	Oui
Temps ACL	Temps nécessaire pour valider l’accès ou la sécurité de l’utilisateur pour la table sous-jacente	Non
Informations supplémentaires	Heure de début, nombre total d’appels et autres métadonnées relatives à l’exécution Recherche IA	Non
Créé par	Personne ayant créé la requête. Inclut les ServiceNow® membres du personnel connectés en tant que technicien de maintenance.	Non
Domaine	Domaine dans lequel la requête a été créée	Non
À remontée pas à pas	Si la requête incluait une remontée pas à pas entre les tables (vrai/faux)	Non
L’entité a un score d’utilisation	Si l’entité a un score d’utilisation (vrai/faux)	Non
Source de l’entité	Indique si la source était dans ENTITIES, USER SENSE ou SEGMENTS	Non
Code d'erreur	Le code d’erreur, le cas échéant	Non
Suivi généré	Nombre de questions de suivi que le LLM a générées en réponse à la requête	Non
Suivi renvoyé	Nombre de questions de suivi générées qui sont réellement renvoyées. Les questions doivent faire référence à des tables auxquelles l’utilisateur demandeur peut accéder et qui se trouvent dans la couche sémantique, par exemple.	Non
Temps LLM	Temps passé par le grand modèle de langage (LLM) sur la requête	Non
Temps du constructeur de requête	Temps passé par le constructeur de requête sur la requête	Non
Temps RAG	Temps passé par la génération augmentée de récupération (RAG) sur la requête	Non
Nombre de dimensions sémantiques	Nombre d’enregistrements de table (dimensions) examinés pour la requête	Non
Nombre d'entités sémantiques	Nombre de tables (entités) examinées pour la requête	Non
Résultats du filtre sémantique	Résultats de l’exécution du filtre sémantique	Non
Temps du filtre sémantique	Temps passé par le filtre sémantique	Non
Nombre de segments sémantiques	Nombre de segments examinés pour la requête	Non
Table source	Nom de la table correspondant à l’ID source	Non
Étiquettes	Toutes les balises que vous ajoutez au journal	Non
Mis à jour	Horodatage de la dernière mise à jour de l’entrée de journal	Non
Mis à jour par	Utilisateur responsable de la dernière mise à jour de l’entrée de journal	Non
Mises à jour	Nombre de mises à jour de l’entrée de journal	Non
Résultats de la banque d’énoncés	Exemples similaires extraits de la banque d’énoncés	Non
Temps de la banque d’énoncés	Temps passé à rechercher dans la banque d’énoncés	Non

Concepts associés

• Problèmes courants Explorateur IA de données et correctifs