Versand manueller Segmente über Plugins
Anwendungsentwickler des Geschäftsbereichs können manuelle Segmente mit ihren Anwendungen versenden, um domänenspezifische gespeicherte Suchen bereitzustellen, die ab dem Zeitpunkt der Installation der App funktionieren.
Versandübersicht
Manuelle Segmente sind die empfohlene Möglichkeit, domänenspezifische gespeicherte Suchen mit Ihrer Anwendung zu versenden. Sie erhalten während der Suche eine Prioritätssteigerung gegenüber automatisierten Segmenten, und das LLM wird angewiesen, alle ihre Filter beizubehalten, es sei denn, sie sind völlig irrelevant – während automatisierte Segmentfilter einzeln kritisiert werden.
Durch den Versand manueller Segmente mit Ihrem Plugin wird sichergestellt, dass Anwender sofort Fragen in natürlicher Sprache zu den Daten Ihrer Anwendung mithilfe von Geschäftsterminologie stellen können, ohne darauf zu warten, dass automatisierte Segmente aus Nutzungsmustern generiert werden.
So versenden Sie manuelle Segmente
- Erstellen Sie Ihre Datensätze für die manuelle Segmentkonfiguration in einer Entwicklungsinstanz.
- Stellen Sie sicher, dass sie korrekt synchronisiert werden und die erwarteten Suchergebnisse liefern.
- Schließen Sie ein sn_query_gen_segment_table_config Datensätze im Update-Satz Ihrer App.
Verhalten der Plugin-Installation
Das Verständnis des Verhaltens manueller Segmente während der Plugin-Installation ist wichtig, um die richtigen Erwartungen festzulegen:
- Business-Regeln sind Umgangen Während der Plugin-Installation: Die asynchrone Synchronisierung wird zum Zeitpunkt der Installation nicht automatisch ausgelöst.
- Die Datensätze werden mit synchronisiert sn_query_gen_segment Beim nächsten Mal Generieren Sie Die Semantische Ebene Geplante Aufgabe wird ausgeführt (nach der Installation) oder wenn wöchentlich Segmente Synchronisieren Auftrag wird ausgeführt.
- Stellen Sie sicher, dass Ihr Plugin keine doppelten Datensätze sendet. Auf Datenbankebene gibt es keine eindeutige Einschränkung – Administratoren müssen sicherstellen, dass keine doppelten Namen pro Entität vorhanden sind.
Beispiel: Vollständige Konfiguration für eine Tabelle
Das folgende Beispiel zeigt manuelle Segmente für Incident Tabelle, die mit einer ITSM-Anwendung geliefert werden könnte:
Voraussetzung: Die Incident Tabelle muss einen Datensatz in enthalten sn_query_gen_table_config Mit enable_semantic_generation = trueUnd eine aktive Entität.
| Name | Beschreibung | Tabelle | Filter |
|---|---|---|---|
| Kritische Offene Incidents | Incidents mit hoher Priorität, die derzeit offen und ungelöst sind. Schließt alle Zuweisungsgruppen ein. | Incident | Priorität=1^State!=7^State!=8 |
| Überfällige Incidents meines Teams | Incidents, die der Gruppe des aktuellen Anwenders zugewiesen sind und ihr SLA-Fälligkeitsdatum überschritten haben. | Incident | Zuweisungsgruppe=javascript:getMyGroups()^sla_due<javascript:gs.nowDateTime()^state!=7 |
| Letzte P1/P2-Eskalationen | Incidents mit Priorität 1 und 2, die in den letzten 7 Tagen eskaliert wurden. | Incident | Priorität<=2^Eskalation=1^sys_updated_on>=javascript:gs.daysAgoStart(7) |
BEST Practices für Versandsegmente
- Konzentrieren Sie sich auf Tabellen mit hohem Wert und hohem Datenverkehr
- Konzentrieren Sie manuelle Segmente auf die Tabellen, nach denen Ihre Anwender am häufigsten fragen. Eine Handvoll gut gestalteter Segmente in den primären Tabellen Ihrer App hat mehr Auswirkungen als eine breite Abdeckung für selten abgefragte Tabellen.
- Verwenden Sie Geschäftssprache, keine technischen Codes
- Segmentnamen sollten übereinstimmen, wie Anwender natürlich über Ihre Domäne sprechen. „Kritische offene Incidents“ ist besser als „P1_OPEN_INC“.
- Geben Sie Beschreibungen für die Unmehrdeutigkeit an
- Wenn Sie mehrere Segmente für dieselbe Tabelle versenden, helfen Beschreibungen dem LLM, das richtige Segment auszuwählen. Ohne Beschreibungen kann der LLM willkürlich zwischen ähnlichen Übereinstimmungen wählen.
- Vor dem Versand testen
- Stellen Sie in einer Testumgebung sicher, dass Segmente korrekt synchronisiert und in den Suchergebnissen für relevante Äußerungen angezeigt werden. Überprüfen Sie die Abfrageprotokolle, um das Übereinstimmungsverhalten zu bestätigen.
- Vermeiden Sie das Duplizieren automatisierter Segmente
- Überprüfen Sie vor dem Erstellen eines manuellen Segments, ob ein automatisiertes Segment bereits denselben Filter abdeckt. Wenn eine vorhanden ist, aber einen schlechten Namen hat, sollten Sie die Quelle verbessern, anstatt ein Duplikat zu erstellen.
Prüfliste vor dem Versand
Überprüfen Sie Folgendes, bevor Sie manuelle Segmente in Ihr Plugin aufnehmen:
- Jede Zieltabelle hat eine aktive Entität in der semantischen Ebene ( sn_query_gen_table_config Mit enable_semantic_generation = true)
- Segmentnamen werden in einfacher Anwendersprache und nicht in technischer Kurzform geschrieben
- Beschreibungen werden für Segmente bereitgestellt, bei denen der Name allein mehrdeutig sein kann
- Filter sind gültige codierte Abfragen mit weniger als 2.000 Zeichen für eine optimale Aufnahme von LLM-Prompts
- In Ihrem Update-Satz sind keine doppelten Datensätze (Kombination aus gleichem Namen und Tabelle) vorhanden
- Alle sn_query_gen_segment_table_config Datensätze sind im Update-Satz Ihrer App enthalten
- Sie haben in einer Testumgebung verifiziert, dass Segmente korrekt synchronisiert und in den Suchergebnissen für relevante Äußerungen angezeigt werden
Überwachung nach Bereitstellung
Nach dem Versand manueller Segmente mit Ihrer Anwendung:
- Überwachen Sie, welche Segmente in den Abfrageprotokollen abgeglichen werden
- Stellen Sie sicher, dass generierte Abfragen für die beabsichtigten Anwendungsfälle korrekt sind
- Sammeln Sie Anwenderfeedback zur Genauigkeit und Abdeckung der Abfrage
- Iterieren Sie anhand von Segmentnamen und -Beschreibungen basierend auf Nutzungsmustern
Wenn ein Segment übereinstimmt, aber falsche Ergebnisse liefert, liegt das Problem normalerweise daran, dass der Name zu generisch ist oder der Filter zu breit ist. Verfeinern Sie den Namen und die Beschreibung, bevor Sie die Systemeigenschaften anpassen.