Een kennisarchief bouwen voor betrouwbaardere Genie-ruimten

Met het Genie-kennisarchief kunt u uw ruimte cureren en verbeteren via gelokaliseerde metagegevens, promptkoppeling en gestructureerde SQL-instructies. Deze functies helpen Genie inzicht te krijgen in uw gegevens en nauwkeurigere en relevante antwoorden te genereren.

Wat is een kennisarchief?

Een kennisopslag is een verzameling gecureerde semantische definities die het begrip van Genie van uw gegevens verbetert en de nauwkeurigheid van de respons verhoogt.

Het kennisarchief bestaat uit:

• Aanpassing van metagegevens op ruimteniveau: ruimtespecifieke beschrijvingen voor tabellen, kolommen en zakelijke termen en synoniemen.
• Aanpassing van gegevens op ruimteniveau: Vereenvoudigde, gerichte gegevenssets zonder de onderliggende Unity Catalog-tabellen te wijzigen.
• Prompt matching: Voorbeelden waarmee Genie waarden kan matchen die het meest relevant zijn voor de vraag van de gebruiker en spelfouten in gebruikersprompts kunnen corrigeren. Dit omvat ondersteuning bij indelingen en entiteitskoppeling.
• Join-relaties: Gedefinieerde relaties tussen tabellen voor nauwkeurige JOIN query's.
• SQL-expressies: gestructureerde definities van metingen, filters en dimensies die bedrijfslogica vastleggen.

Alle configuraties van het kennisarchief zijn gericht op uw Genie-ruimte en hebben geen invloed op metagegevens van Unity Catalog of andere Azure Databricks-assets.

Metagegevens van kennisarchief beheren

Leer Genie over de gegevens in uw ruimte door lokale tabel- en kolombeschrijvingen op te geven en kolom synoniemen toe te voegen die overeenkomen met algemene zakelijke termen. Vereenvoudig gegevenssets door onnodige of dubbele kolommen te verbergen om Genie gefocust te houden.

Deze procedures verbeteren de bruikbaarheid voor gebruikers die geen directe machtigingen hebben voor de onderliggende tabellen, en ze ondersteunen ook snellere iteraties bij het bijwerken van instructieversies.

Als u toegang wilt krijgen tot metagegevens op ruimteniveau, klikt u op Gegevens configureren > in uw Genie-ruimte. Klik vervolgens op een tabelnaam om de bijbehorende metagegevens en kolommen weer te geven.

Kolommen weergeven

Klik op een tabelnaam om een overzicht van de kolomnamen en details weer te geven. In het volgende voorbeeld ziet u een voorbeeld uit een tabel met de naam accounts.

• Beschrijving: Genie gebruikt metagegevens om uw gegevens te begrijpen en nauwkeurige antwoorden te genereren. De standaardtabelbeschrijving toont de Unity Catalog-metagegevens die zijn gekoppeld aan uw gegevensasset. Bewerk deze beschrijving om specifieke aanwijzingen toe te voegen waarmee Genie SQL voor uw ruimte kan schrijven. Klik op Opnieuw instellen om de beschrijving van de Unity-catalogus te herstellen.

• Kolommen: Kolomnamen en beschrijvingen worden opgenomen in de lijst met kolommen. Elke kolom wordt gelabeld met tags die aangeven of deze ondersteuning voor opmaak of entiteitskoppeling bevat. Zie Overzicht van promptmatching.

Relevante kolommen verbergen of weergeven

Kolommen kunnen afzonderlijk of bulksgewijs worden beheerd. Gebruik de volgende instructies om kolommen te verbergen of weer te geven.

• Eén kolom verbergen: klik op het naast de kolomnaam.
• Meerdere kolommen verbergen:
  • Schakel de selectievakjes in voor de kolommen die u wilt verbergen.
  • Selecteer geselecteerde kolommen verbergen in het menu Acties.
• Wijzigingen ongedaan maken: herhaal dezelfde stappen om een kolom weer te geven die is verborgen.

Kolommetagegevens bewerken

U kunt het volgende aanpassen voor elke kolom:

• Beschrijving: Ruimtespecifieke kolombeschrijvingen die het begrip van Genie verbeteren.
• Synoniemen: zakelijke termen en trefwoorden waarmee gebruikerstaal kan worden vergeleken met kolomnamen.
• Geavanceerde instellingen: instellingen voor promptafstemming.
  • Hulp bij opmaak: steekproeven van representatieve waarden inschakelen of uitschakelen.
  • Entiteitskoppeling: entiteitskoppeling voor categorische kolommen in- of uitschakelen.

Kolommetagegevens bewerken:

1. Klik op het naast een kolomnaam.
2. Bewerk de beschrijving en synoniemen voor de kolom.
3. Klik zo nodig op Geavanceerde instellingen om promptkoppelingsbesturingselementen te openen.
4. Klik op Opslaan om de wijzigingen te behouden en sluit het dialoogvenster.

Overzicht van overeenkomende prompts

Met promptkoppeling kan Genie kolommen en waarden vinden die het meest relevant zijn voor de vraag van de gebruiker en spelproblemen in gebruikersprompts corrigeren. Dit verbetert de nauwkeurigheid van Genie en helpt bij het genereren van betrouwbaardere SQL-query's.

Wanneer een gebruiker een vraag stelt in Genie, is de formulering vaak conversationeel en kan dit fouten bevatten, zoals spelfouten. In dergelijke gevallen komen de waarden in de prompt mogelijk niet overeen met de structuur of waarden in de gegevens. Dit kan ertoe leiden dat Genie de vraag verkeerd interpreteert en onjuiste SQL genereert.

Example

Bekijk het volgende voorbeeld:

Toon de verkoop van auto's in Florida in het eerste kwartaal.

Als voor de gegevens staatsafkortingen (zoals FL) worden gebruikt en Genie geen toegang heeft tot de waarden voor die kolom, kan Genie SQL genereren die bevat ILIKE '%Florida%', wat geen resultaten oplevert.

Door entiteitskoppeling in de state kolom in te schakelen, heeft Genie toegang tot representatieve waarden. Met deze context kan Genie herkennen dat FL dit overeenkomt met 'Florida' en nauwkeurigere SQL genereren.

Zonder entiteitskoppeling	Met entiteitskoppeling
WHERE state ILIKE '%Florida%'	WHERE state = 'FL'

Overeenkomende onderdelen activeren

• Hulp bij het opmaken: Hulp bij het opmaken biedt representatieve waarden voor alle in aanmerking komende kolommen, zodat Genie gegevenstypen en opmaakpatronen begrijpt. Representatieve waarden voor promptkoppeling worden gegenereerd met behulp van de gegevensmachtigingen van de auteur. Deze waarden worden onderdeel van de gedeelde context van de ruimte en helpen Genie gebruikersprompts nauwkeuriger te interpreteren voor alle ruimtedeelnemers.
• Entiteitskoppeling: Entiteitskoppeling biedt gecureerde lijsten met afzonderlijke waarden voor maximaal 120 kolommen waar gebruikers waarschijnlijk verwijzen naar specifieke vermeldingen, zoals statussen en productcategorieën. Dit helpt Genie gebruikersterminologie te vergelijken met werkelijke gegevenswaarden. Elke kolom kan maximaal 1024 afzonderlijke waarden bevatten, elk tot 127 tekens lang. Entiteitskoppelingsgegevens worden opgeslagen in de opslagbucket van uw werkruimte.

Genie biedt automatisch opmaakondersteuning en entiteitskoppeling voor in aanmerking komende kolommen wanneer u tabellen aan de ruimte toevoegt. Tabellen met rijfilters of kolommaskers worden uitgesloten van promptkoppeling.

Promptkoppeling beheren

Bepalen welke kolommen ondersteuning bieden voor opmaak en entiteitskoppeling om het begrip van uw gegevens van Genie te optimaliseren. Promptmatching is standaard ingeschakeld voor alle Genie-ruimten.

Formaat hulp beheren

Hulp bij opmaak wordt automatisch toegepast wanneer u tabellen toevoegt aan een Genie-ruimte.

Hulp bij het opmaken van een kolom uitschakelen:

1. Klik op Gegevens configureren > in uw Genie-ruimte.
2. Klik op een tabelnaam om de kolommen ervan weer te geven.
3. Klik op het naast de kolomnaam.
4. Klik op Geavanceerd.
5. Schakel Hulp bij het opmaken uit.

Met deze actie wordt ook automatisch entiteitsmatching voor die kolom uitgeschakeld. Gebruik deze instelling zo nodig om hulp bij opmaak weer in te schakelen.

Entiteitskoppeling configureren

Genie genereert antwoorden met behulp van uw prompt, relevante tabelmetagegevens, prompt-matchmogelijkheden, foutsignalen en invoercode of queries. Wanneer een kolom entiteitskoppeling heeft ingeschakeld, maakt Genie gebruik van de opgeslagen waarden om gebruikersprompts nauwkeuriger te laten overeenkomen met de werkelijke gegevens. Dit produceert betrouwbaardere SQL-query's. Entiteitskoppeling verbetert de nauwkeurigheid van Genie aanzienlijk, met name in combinatie met duidelijke voorbeeldquery's en goed gemaakte instructies. Zie Creëer een effectieve Genie-ruimte voor meer begeleiding.

Genie voorkomt dat u entiteitskoppelingen inschakelt voor tabellen met rijfilters of kolommaskers. Auteurs van ruimte moeten echter entiteitskoppeling uitschakelen voor weergaven die verwijzen naar tabellen met rijfilters of kolommaskers, of voor dynamische weergaven.

De volgende lijst bevat voorbeelden van de typen gegevens die goed werken met entiteitskoppeling:

• Deelstaat- of landcodes
• Productcategorieën
• Statuscodes
• Afdelingsnamen

Als u entiteitenmatching wilt inschakelen, moet ondersteuning voor opmaak zijn ingeschakeld. Gebruik vervolgens de volgende stappen:

1. Klik op Gegevens configureren > in uw Genie-ruimte.
2. Klik op een tabelnaam om de kolommen ervan weer te geven.
3. Klik op het naast de kolomnaam.
4. Klik op Geavanceerd.
5. Schakel Entiteitskoppeling in.
6. Als u entiteitskoppeling voor een kolom wilt uitschakelen, schakelt u Entiteitskoppeling uit.

Promptvergelijkingsgegevens vernieuwen of verwijderen

Bij het vernieuwen van gegevens die overeenkomen met prompts, worden de opgeslagen waarden van een kolom bijgewerkt. Waarden vernieuwen als:

• Er zijn nieuwe waarden toegevoegd aan de kolom.
• De opmaak van bestaande waarden is gewijzigd.

Als u gegevens voor prompt matching wilt vernieuwen, klikt u in de kolomweergave op het en vervolgens op Vernieuwen prompt matching.

Joinrelaties definiëren

Help Genie nauwkeurige JOIN verklaringen te maken door tabelrelaties te definiëren.

1. Klik op Joins.
2. Klik op Toevoegen.
3. Selecteer tabellen links en rechts in de vervolgkeuzelijsten.
4. Voer een joinvoorwaarde in (bijvoorbeeld accounts.id = opportunity.accountid)
   • Klik voor gecompliceerdere joinvoorwaarden op SQL-expressie gebruiken en noteer de joinvoorwaarde als een SQL-expressie.
5. Selecteer een relatietype:
   • Veel op één: Meerdere linkerrijen worden toegewezen aan één rechterrij
   • Veel-op-een: één linkerrij komt overeen met meerdere rechterrijen
   • Eén op één: één linkerrij wordt toegewezen aan maximaal één rechterrij

Opmerking

Wanneer er meerdere joins bestaan tussen dezelfde tabellen of zelf-joins worden gebruikt, genereert Genie automatisch aliassen voor de rechtertabel om dubbelzinnigheid te voorkomen.

Suggesties ophalen uit feedback

Wanneer gebruikers op de duim omhoog klikken voor een bericht dat tabellen samenvoegt of SQL-expressies gebruikt, analyseert Genie het antwoord en kan het nieuwe SQL-fragmenten (zoals metingen, joins of filters) voorstellen voor ruimte-auteurs om te controleren en toe te voegen aan het kennisarchief. Genie leert of wijzigt zijn gedrag niet automatisch op basis van feedback.

SQL-expressies definiëren

SQL-expressies bieden een gestructureerde, begeleide manier om Genie te leren over algemene zakelijke termen, zoals KPI's, kenmerken en voorwaarden. Genie gebruikt deze definities vervolgens wanneer een gebruiker om deze zakelijke voorwaarden vraagt.

SQL-expressies vormen een aanvulling op sql-voorbeeldquery's, die zijn opgegeven in instructies. MET SQL-expressies worden herbruikbare bedrijfsconcepten gedefinieerd, maar voorbeelden van SQL-query's zijn handiger voor het leren van Genie over het benaderen van algemene indelingen voor gebruikersprompts. Als gebruikers bijvoorbeeld vaak vragen om een uitsplitsing van de prestaties, kan een sql-voorbeeldquery laten zien dat dit een gesloten verkoop per regio, vertegenwoordiger en manager betekent.

SQL-expressies werken het beste wanneer u het volgende moet doen:

• Gestructureerde definities bieden voor KPI's en metrische gegevens, zoals winstmarge of conversiepercentage
• Geef Genie expliciete context over het berekenen van belangrijke waarden
• Aanvullende dimensies definiëren voor de gegevensset, zoals maand of klantsegment
• Instellen van Genie-filters voor zakelijke voorwaarden, zoals grote bestellingen of bestellingen vóór een bepaalde tijd

SQL-expressietypen

U kunt de volgende typen SQL-expressies definiëren:

• Metingen: KPI's (Key Performance Indicators) en metrische gegevens. Definieer de naam, SQL-berekening en synoniemen.
• Filters: Algemene filtervoorwaarden. Definieer de naam, SQL-filterlogica en synoniemen.
• Dimensies: Kenmerken voor het groeperen en analyseren van gegevens. Definieer de naam, SQL-expressie en synoniemen.

Gebruik de volgende instructies om SQL-expressies te definiëren:

1. Klik opInstructies> voorSQL-expressies>
2. Klik op Toevoegen. Kies Filter, Maat of Dimensie.
3. Voer in het veld Naam een naam in voor de expressie.
4. Voer in het veld Code de SQL-expressie in.

• Filterexpressies moeten resulteren in een Booleaanse voorwaarde.
• Metingexpressies moeten een aggregatie over meerdere rijen in de tabel berekenen.
• Dimensieexpressies moeten de waarde van elke rij van de bestaande gegevens wijzigen.

1. Voer in het veld Synoniemen veelvoorkomende manieren in waarop gebruikers naar de expressies kunnen verwijzen.
2. Voer in het veld Instructies specifieke instructies in waarmee Genie wordt aangegeven waar de expressie voor is en hoe u ermee kunt werken.

Volgende stappen

Gebruik de volgende koppelingen om u te helpen bij het bouwen van uw Genie-ruimte.

• Voeg context toe aan uw Genie-ruimte om nauwkeurige antwoorden te genereren. Zie SQL-voorbeelden en -instructies toevoegen
• Ontdek aanbevolen procedures voor het optimaliseren van uw Genie-ruimte. Zie Een effectieve Genie-ruimte cureren
• Evalueer en verbeter de prestaties van uw ruimte. Zie Benchmarks gebruiken in een Genie-ruimte