Expédition manuelle de segments via des modules d’extension
Les développeurs d’applications d’unités business peuvent envoyer des segments manuels avec leurs applications pour fournir des recherches enregistrées spécifiques au domaine qui fonctionnent dès l’installation de l’application.
Vue d’ensemble de l’expédition
Les segments manuels sont le moyen recommandé d’envoyer des recherches enregistrées spécifiques à un domaine avec votre application. Ils reçoivent une priorité sur les segments automatisés pendant la recherche, et le LLM a pour instruction de conserver tous leurs filtres à moins qu’ils ne soient complètement non pertinents, alors que les filtres de segment automatisés sont critiqués individuellement.
La livraison de segments manuels avec votre module d’extension garantit que les utilisateurs peuvent immédiatement poser des questions en langage naturel sur les données de votre application à l’aide de la terminologie métier, sans attendre que des segments automatisés soient générés à partir des modèles d’utilisation.
Comment expédier des segments manuels
- Créez vos enregistrements de configuration de segment manuel dans une instance de développement.
- Vérifiez qu’ils se synchronisent correctement et produisent les résultats de recherche attendus.
- Incluez les enregistrements sn_query_gen_segment_table_config dans l’ensemble de mises à jour de votre application.
Comportement d’installation du module d’extension
Il est important de comprendre le comportement des segments manuels lors de l’installation du module d’extension pour définir des attentes appropriées :
- Les règles métier sont contournées lors de l’installation du module d’extension : la synchronisation asynchrone ne se déclenchera pas automatiquement au moment de l’installation.
- Les enregistrements seront synchronisés dans sn_query_gen_segment la prochaine exécution de la tâche planifiée Générer une couche sémantique (après l’installation) ou lors de l’exécution de la tâche hebdomadaire Synchroniser les segments .
- Assurez-vous que votre module d’extension n’envoie pas d’enregistrements en double. Il n’y a pas de contrainte unique au niveau de la base de données : les administrateurs doivent s’assurer qu’il n’y a pas de noms en double par entité.
Exemple : configuration complète d’une table
L’exemple suivant montre des segments manuels pour la table d’incidents qui peuvent être envoyés avec une application ITSM :
Prérequis : La table d’incidents doit avoir un enregistrement dans sn_query_gen_table_config avec enable_semantic_generation = true et une entité active.
| Nom | Description | Table | Filtre |
|---|---|---|---|
| Incidents ouverts critiques | Incidents de priorité élevée actuellement ouverts et non résolus. Inclut tous les groupes d’affectation. | incident | priority=1^State !=7^State !=8 |
| Incidents en retard de mon équipe | Incidents affectés au groupe de l’utilisateur actuel ayant dépassé la date d’échéance du SLA. | incident | assignment_group=javascript :getMyGroups()^sla_due<javascript :gs.nowDateTime()^state !=7 |
| Escalades P1/P2 récentes | Incidents de priorité 1 et 2 escaladés au cours des 7 derniers jours. | incident | priority<=2^escalation=1^sys_updated_on>=javascript :gs.daysAgoStart(7) |
Bonnes pratiques pour les segments d’expédition
- Se concentrer sur les tables à forte valeur ajoutée et à trafic élevé
- Concentrez les segments manuels sur les tables sur lesquelles vos utilisateurs demandent le plus. Une poignée de segments bien conçus sur les tables primaires de votre application auront plus d’impact qu’une couverture étendue sur des tables rarement interrogées.
- Utiliser le langage métier, pas les codes techniques
- Les noms de segment doivent correspondre à la façon dont les utilisateurs parlent naturellement de votre domaine. « Incidents ouverts critiques » est préférable à « P1_OPEN_INC ».
- Fournir des descriptions pour la désambiguïsation
- Si vous expédiez plusieurs segments pour la même table, les descriptions aident le LLM à choisir le bon. Sans description, le LLM peut choisir arbitrairement entre des correspondances similaires.
- Tester avant expédition
- Vérifiez dans un environnement de tests que les segments se synchronisent correctement et apparaissent dans les résultats de recherche pour les énoncés pertinents. Vérifiez les journaux des requêtes pour confirmer le comportement correspondant.
- Éviter de dupliquer les segments automatisés
- Avant de créer un segment manuel, vérifiez si un segment automatisé couvre déjà le même filtre. S’il en existe un mais qu’il a un mauvais nom, envisagez d’améliorer la source plutôt que de créer un doublon.
Liste de vérification avant expédition
Vérifiez les points suivants avant d’inclure des segments manuels dans votre module d’extension :
- Chaque table cible a une entité active dans la couche sémantique (sn_query_gen_table_config avec enable_semantic_generation = true)
- Les noms des segments sont rédigés dans un langage utilisateur simple, et non dans un raccourci technique
- Des descriptions sont fournies pour les segments où le nom seul peut être ambigu
- Les filtres sont des requêtes codées valides et inférieures à 2 000 caractères pour une inclusion optimale de l’invite LLM
- Aucun enregistrement en double (même nom + combinaison de table) n’existe dans votre ensemble de mises à jour
- Tous les enregistrements sn_query_gen_segment_table_config sont inclus dans l’ensemble de mises à jour de votre application
- Vous avez vérifié dans un environnement de tests que les segments se synchronisent correctement et apparaissent dans les résultats de recherche pour les énoncés pertinents
Surveillance après le déploiement
Après l’expédition manuelle de segments avec votre application :
- Surveiller les segments correspondants dans les journaux de requêtes
- Vérifiez que les requêtes générées sont correctes pour les cas d’utilisation prévus
- Recueillir les commentaires des utilisateurs sur l’exactitude et la couverture des requêtes
- Itération sur les noms et les descriptions des segments en fonction des modèles d’utilisation
Si un segment correspond mais produit des résultats erronés, le problème est généralement que le nom est trop générique ou que le filtre est trop large. Affinez le nom et la description avant d’ajuster les propriétés système.