Créer un segment manuel
Les segments manuels sont des recherches enregistrées créées par l’administrateur avec des noms conviviaux qui relient les questions en langage naturel et les filtres de base de données pour la couche sémantique Génération de requête.
Avant de commencer
Rôle requis : sn_query_gen.admin ou un rôle supérieur
Pourquoi et quand exécuter cette tâche
Utilisez des segments manuels pour envoyer des recherches enregistrées spécifiques à un domaine avec votre application. Ils bénéficient d’une augmentation de priorité par rapport aux segments automatisés pendant la recherche. Ce boost est défini dans sn_query_gen.segments.manual_segment_scale_factor. Le LLM conserve tous ses filtres, sauf s’ils ne sont pas pertinents, tandis que les filtres de segment automatisés sont critiqués individuellement.
- Votre organisation dispose d’une terminologie standard qui correspond à des filtres spécifiques (par exemple, « Sev1 », « VIP », « en retard »)
- Les utilisateurs posent à plusieurs reprises la même question filtrée et le système ne récupère pas automatiquement le bon filtre
- Vous souhaitez coder une logique métier qui ne peut pas être déduite des seules valeurs de champ (par exemple, « comptes à risque » = combinaison de plusieurs conditions)
- La terminologie spécifique de votre organisation n’est pas traduite avec précision dans les conditions de filtre
Lors de la création de noms de segments, utilisez la même langue qu’un utilisateur utiliserait pour poser une question. Le nom est le champ primaire auquel le LLM correspond pendant la recherche sémantique. Évitez les abréviations, les codes internes ou le jargon technique. Pensez à la façon dont un utilisateur formulerait la question à laquelle ce segment répond.
Directives de dénomination
Suivez ces instructions lors de la création de noms et de descriptions de segments :
- Utilisez un langage simple
- Écrivez les noms dans la même langue que celle que les utilisateurs utiliseraient pour poser des questions. Évitez les abréviations techniques ou les codes internes que les utilisateurs ne reconnaîtraient pas.
- Pensez comme vos utilisateurs
- Réfléchissez à la façon dont les utilisateurs formuleraient les questions sur ces données. Le nom du segment doit correspondre à leurs modèles de langage naturel.
- Soyez précis mais clair
- Les noms doivent être suffisamment descriptifs pour se distinguer des segments similaires tout en restant compréhensibles pour votre public.
- Utiliser des descriptions pour le contexte
- Lorsque les noms de segments peuvent être ambigus, utilisez le champ Description pour fournir un contexte supplémentaire à l’aide de termes couramment utilisés.
Procédure
Résultats
Le segment manuel est actif et disponible pour Génération de requête les recherches.
Segments manuels pour la table d’incidents
Les exemples suivants montrent des segments manuels bien conçus pour la table d’incidents :
| 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 et 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) |