Een semantische verrijking maken

Voordat u een verrijking maakt

Denk na over het type context dat u wilt bieden:

• Bent u een bedrijfsterm of meetgegeven aan het definiëren?
• Leg je uit hoe je iets moet berekenen?
• Biedt u richtlijnen voor gegevenskwaliteit voor een specifiek veld?
• Beschrijft u een relatie tussen objecten?
• Stelt u een standaardfilter of -voorwaarde in?

Dit helpt bij het bepalen van het juiste bereik (gegevensruimte, object of veld) en hoe de verrijkingsinstructie moet worden geformuleerd.

Een verrijking maken

1. Navigeer naar de lijstweergave Semantische verrijkingen.
2. Klik op Nieuwe semantische verrijking.
3. Geef een naam op die het doel van de verrijking duidelijk aangeeft. Voorbeeld: "Actieve klantdefinitie" of "Omzetveldbegeleiding".
4. Selecteer het bereik:
   • Object: Van toepassing op een specifiek gegevens-lakeobject (Data Lake Object, DLO) of gegevensmodelobject (Data Model Object, DMO). Gebruik dit voor objectspecifieke begeleiding.
   • Veld: Geldt voor een specifiek veld binnen een object. Gebruik dit voor interpretatie op veldniveau.
5. Als u Object of Veldbereik hebt geselecteerd, kiest u het doelobject of -veld in de vervolgkeuzelijst.
6. Schrijf in het veld Semantische verklaring uw verrijking in duidelijke, duidelijke taal. Wees specifiek over wanneer en hoe de regel wordt toegepast. U kunt verrijkingen met meerdere zinnen schrijven voor complexe bedrijfsregels. Voorbeelden:
   • "Actieve klanten zijn klanten met status = 'Actief' en minstens één order in de afgelopen 90 dagen."
   • "Gebruik amount_usd__c voor omzetberekeningen. Dit veld vertegenwoordigt de dealgrootte in Amerikaanse dollars."
   • "Gebruik bij het filteren van email_address altijd kleine-lettervergelijkingen, omdat sommige oudere gegevens gemengde hoofdletterwaarden hebben."
   • "Opportunities met een hoge waarde worden gedefinieerd als amount_usd__c groter dan $ 100.000 en de fase is gelijk aan 'Voorstel' of 'Onderhandeling'. Gebruik voor regionale analyse het veld region__c, niet de factuuradresstatus. Historische opportunities met een hoge waarde van vóór 2023 gebruikten een andere drempelwaarde van 50.000 dollar vanwege inflatieaanpassingen."
7. (Optioneel) Voeg tags toe om gerelateerde verrijkingen te organiseren. Gebruik consistente tags zoals "omzet", "klantsegmentering" of "gegevenskwaliteit" om verrijkingen later gemakkelijker te vinden en te beheren. Tags zijn alleen voor organisatie en hebben geen invloed op welke verrijkingen de agent ophaalt.
8. (Optioneel) Controleer Kritiek als deze verrijking altijd door de agent moet worden overwogen. Gebruik deze voor basisbedrijfsregels of beperkingen voor gegevenskwaliteit. Het markeren van te veel verrijkingen als Kritiek leidt tot een opgeblazen context en vertraagt query's, dus gebruik het spaarzaam.
9. (Optioneel, maar aanbevolen) Voeg opzoeksamenvattingen toe om het ophalen van semantische verrijking te verbeteren. Dit zijn trefwoorden of frasen die naar verwachting worden weergegeven in vragen van gebruikers. Als de semantische instructie bijvoorbeeld Levenswaarde van klant definieert, voegt u opzoeksamenvattingen toe zoals "CLV" en "Levenswaarde van klant".
10. Klik op Opslaan.

Effectieve semantische statements schrijven

Een semantische instructie leert de agent hoe een vraag in platte taal kan worden omgezet in de juiste query op uw gegevens. Elke effectieve verklaring beantwoordt drie vragen:

• Wat is de regel? De instructie die de agent moet volgen.
• Waarom bestaat het? De redenering erachter.
• Wat gebeurt er als het wordt genegeerd? Het verkeerde antwoord dat je probeert te voorkomen.

Het waarom is het belangrijkste. Een regel zonder redenering wordt letterlijk gevolgd en breekt op elke vraag die u niet had verwacht. Een regel met redenering laat de agent cases afhandelen die u nooit hebt opgeschreven. Vergelijk een zwakke verklaring die alleen de regel geeft met een sterke verklaring die de redenering en consequentie toevoegt:

• Zwak (alleen regel): "Altijd Status filteren = 'Actief'."
• Sterk (regel, redenering en gevolg): "Filter altijd Status = 'Active' voor elke query. De tabel slaat zowel actieve als gearchiveerde klantrecords op. Zonder dit filter worden resultaten gemengd in gearchiveerde klanten die niet langer relevant zijn. Dit geldt zelfs wanneer de gebruiker vraagt naar één bij naam genoemde klant."

Volg deze richtlijnen wanneer u een verklaring schrijft:

Wees specifiek

Schrijf in plaats van "Gebruik het omzetveld" "Gebruik amount_usd__c voor omzetberekeningen, omdat het de dealgrootte in Amerikaanse dollars vertegenwoordigt en consistent wordt ingevuld."

Leg uit waarom

Geef niet zomaar een regel op—leg de reden uit. "Filteren op status = 'Actief', omdat inactieve klanten niet moeten worden weergegeven in rapportage."

Voorbeelden gebruiken

Toon bij het definiëren van berekeningen de formule of logica. "Levenswaarde van klant = totale_omzet / maanden_actief * gemiddelde_levensduur_maanden van_klant."

Voorwaarden duidelijk vermelden

Als een regel alleen in bepaalde gevallen van toepassing is, zegt u wanneer. "Voor opportunityquery's sluit u fase = 'Gesloten verloren' uit, tenzij hier expliciet om wordt verzocht."

Jargon vermijden

Schrijf in duidelijke taal die de agent kan parseren. Als u domeinspecifieke termen moet gebruiken, definieert u deze.

Best practices voor semantische verklaringen

• Eén regel per instructie. Combineer geen niet-gerelateerde regels. Wanneer de agent een instructie ophaalt, wordt alles opgehaald, waardoor een instructie die vijf onderwerpen bestrijkt, vier irrelevante regels toevoegt telkens wanneer er een overeenkomt.
• Begin met de regel en leg dan uit waarom. Geef eerst de instructie op, dan de redenering, dan de consequentie van het verkeerd doen.
• Zeg wat je niet moet doen. Als twee velden of waarden gemakkelijk door elkaar te halen zijn, moet u het verkeerde expliciet benoemen. "Gebruik nooit de verzenddatum voor omzetvragen" is zo waardevol als het juiste veld benoemen.
• Spelleer waarden die de agent niet kan raden. De agent ziet veldnamen, niet de waarden erin. Vermeld de geldige set wanneer deze kort en niet voor de hand liggend is.
• Verduidelijk notaties en eenheden. Als een getal is opgeslagen als een vermenigvuldiger, een percentage of in cent, zegt u dat. Anders wordt "minder dan 2x" of "meer dan 50%" verkeerd gelezen.
• Voeg elke instructie bij het smalste correcte doel bij. Een regel voor één veld hoort bij dat veld. Een regel die meerdere velden bestrijkt, hoort bij het object. Zo blijven niet-gerelateerde vragen schoon en wordt de juiste regel op het juiste moment zichtbaar.
• Gebruik Kritiek alleen voor regels die op bijna elke vraag van toepassing zijn. Een kritieke verklaring wordt altijd toegepast. Niet-kritieke instructies worden alleen opgehaald wanneer de vraag overeenkomt met hun opzoeksamenvattingen. Reserve kritiek voor universele regels en houd het aantal klein.
• Schrijf opzoeksamenvattingen in de woorden die uw gebruikers daadwerkelijk typen. Dit zijn de triggerfrasen die een niet-kritieke verklaring naar boven halen. Gebruik echte frasen, synoniemen en afkortingen, geen technische beschrijvingen.

Typen context die u kunt toevoegen

Semantische verklaringen kunnen vele soorten zakelijke context vastleggen. Veel voorkomende typen zijn:

Uw verrijking testen

Nadat u een verrijking hebt gemaakt, test u deze door de agent een vraag te stellen die de verrijking moet activeren. Controleer de reactie van de agent en controleer de sectie Meer details weergeven om te zien of de verrijking correct is toegepast. Als de agent de verrijking niet zoals verwacht heeft gebruikt:

• Zorg ervoor dat de verrijking Actief is.
• Controleer of het bereik (gegevensruimte, object of veld) overeenkomt met uw vraag.
• Pas de semantische instructie aan om specifieker te zijn of voeg relevante tags toe.
• Als de verrijking fundamenteel is, markeert u deze als Kritiek.

Volgende stappen

Zie Semantische verrijkingen beheren voor informatie over het bewerken, deactiveren of verwijderen van verrijkingen naarmate uw gegevensmodel zich ontwikkelt.