Skapa ett kunskapslager för mer tillförlitliga Genie-utrymmen

Med Kunskapsarkivet Genie kan du kurera och förbättra ditt utrymme genom lokaliserade metadata, promptmatchning och strukturerade SQL-instruktioner. Dessa funktioner hjälper Genie att förstå dina data och generera mer exakta och relevanta svar.

Vad är ett kunskapslager?

Ett kunskapslager är en samling utvalda semantiska definitioner som förbättrar Genie:s förståelse av dina data och förbättrar svarsprecisionen.

Kunskapsarkivet består av:

• Anpassning av metadata på rymdnivå: Utrymmesspecifika beskrivningar för tabeller, kolumner och affärstermer och synonymer.
• Anpassning av data på rymdnivå: Förenklade, fokuserade datauppsättningar utan att ändra de underliggande Unity Catalog-tabellerna.
• Promptmatchning: Exempel som hjälper Genie att matcha värden som är mest relevanta för användarens fråga och korrigera stavningsproblem i användarprompter. Detta inkluderar formathjälp och entitetsmatchning.
• Sammanfoga relationer: Definierade tabellrelationer för korrektaJOIN uttryck.
• SQL-uttryck: Strukturerade definitioner av mått, filter och dimensioner som samlar in affärslogik.

Alla konfigurationer av kunskapslager är begränsade till ditt Genie-utrymme och påverkar inte Unity Catalog-metadata eller andra Azure Databricks-tillgångar.

Hantera metadata för kunskapslager

Lär Genie om data i ditt utrymme genom att ange lokala tabell- och kolumnbeskrivningar och genom att lägga till synonymer för kolumner som överensstämmer med vanliga affärsvillkor. Förenkla datauppsättningar genom att dölja onödiga eller duplicerade kolumner för att hålla Genie fokuserat.

Dessa metoder förbättrar användbarheten för användare som inte har direkt behörighet för de underliggande tabellerna, och de stöder även snabbare iterationer vid uppdatering av instruktionsversioner.

Om du vill komma åt metadata på rymdnivå klickar du på Konfigurera > data i ditt Genie-utrymme. Klicka sedan på ett tabellnamn för att visa dess metadata och kolumner.

Visa kolumner

Klicka på ett tabellnamn om du vill se en översikt över kolumnnamnen och informationen. I följande exempel visas ett exempel från en tabell med namnet accounts.

• Beskrivning: Genie använder metadata för att förstå dina data och generera korrekta svar. Standardbeskrivningen av tabellen visar Unity Catalog-metadata associerad med din datatillgång. Redigera den här beskrivningen om du vill lägga till specifika anvisningar som hjälper Genie att skapa SQL för ditt utrymme. Klicka på Återställ för att återställa beskrivningen av Unity-katalogen.

• Kolumner: Kolumnnamn och beskrivningar ingår i kolumnlistan. Varje kolumn är märkt med taggar som visar om den innehåller Formathjälp eller Entitetsmatchning. Se även Översikt över prompt-matchning.

Dölj eller visa relevanta kolumner

Kolumner kan hanteras individuellt eller i bulk. Använd följande instruktioner för att dölja eller visa kolumner.

• Dölj en enskild kolumn: Klicka på bredvid kolumnnamnet.
• Dölj flera kolumner:
  • Markera kryssrutorna för de kolumner som du vill dölja.
  • På menyn Åtgärder väljer du Dölj markerade kolumner.
• Ångra ändringar: Upprepa samma steg för att visa en kolumn som var dold.

Redigera kolumnmetadata

Du kan anpassa följande för varje kolumn:

• Beskrivning: Utrymmesspecifika kolumnbeskrivningar som förbättrar Genie-förståelsen.
• Synonymer: Affärsvillkor och nyckelord som hjälper till att matcha användarspråket med kolumnnamn.
• Avancerade inställningar: Fråga efter matchande kontroller.
  • Formathjälp: Aktivera eller inaktivera sampling av representativa värden.
  • Entitetsmatchning: Aktivera eller inaktivera entitetsmatchning för kategoriska kolumner.

Så här redigerar du kolumnmetadata:

1. Klicka på pennikon bredvid ett kolumnnamn.
2. Redigera beskrivningen och synonymerna för kolumnen.
3. Om det behövs klickar du på Avancerade inställningar för att öppna kontroller för matchning av uppmaningar.
4. Klicka på Spara för att behålla ändringarna och stäng dialogrutan.

Översikt över promptmatchning

Med promptmatchning kan Genie matcha kolumner och värden som är mest relevanta för användarens fråga och korrigera stavningsproblem i användarprompter. Detta förbättrar Genie-noggrannheten och hjälper till att generera mer tillförlitliga SQL-frågor.

När en användare ställer en fråga i Genie är frasen ofta konversationsbaserad och kan innehålla fel som felstavningar. I dessa fall kanske värdena i prompten inte matchar strukturen eller värdena i data. Detta kan göra att Genie misstolkar frågan och genererar felaktig SQL.

Example

Granska följande exempel:

"Visa mig bilförsäljning i Florida för Q1."

Om data använder tillståndsförkortningar (till exempel FL) och Genie inte kan komma åt värdena för kolumnen kan Genie generera SQL som innehåller ILIKE '%Florida%', vilket inte returnerar några resultat.

Genom att aktivera entitetsmatchning i state kolumnen kan Genie komma åt representativa värden. Med den här kontexten kan Genie känna igen som FL motsvarar "Florida" och generera mer exakt SQL.

Utan entitetsmatchning	Med entitetsmatchning
WHERE state ILIKE '%Florida%'	WHERE state = 'FL'

Fråga efter matchande komponenter

• Formathjälp: Formathjälp ger representativa värden för alla berättigade kolumner, vilket hjälper Genie att förstå datatyper och formateringsmönster. Representativa värden för promptmatchning genereras med hjälp av författarens databehörigheter. Dessa värden blir en del av utrymmets delade kontext och hjälper Genie att tolka användarfrågor mer exakt för alla utrymmesdeltagare.
• Entitetsmatchning: Entitetsmatchning innehåller utvalda listor med distinkta värden för upp till 120 kolumner där användare sannolikt refererar till specifika poster, till exempel tillstånd och produktkategorier. Detta hjälper Genie att matcha användarterminologin med faktiska datavärden. Varje kolumn kan innehålla upp till 1 024 distinkta värden, var och en upp till 127 tecken lång. Entitetsmatchningsdata lagras i ditt arbetsutrymmes lagringsbehållare.

Genie ger automatiskt formathjälp och entitetsmatchning för berättigade kolumner när du lägger till tabeller i utrymmet. Tabeller med radfilter eller kolumnmasker undantas från promptmatchning.

Hantera promptmatchning

Kontrollera vilka kolumner som ger formathjälp och entitetsmatchning för att optimera Genie-förståelsen för dina data. Promptmatchning är aktiverad som förval för alla Genie-utrymmen.

Hantera formathjälp

Formathjälp tillämpas automatiskt när du lägger till tabeller i en Genie-yta.

Så här inaktiverar du formathjälp för en kolumn:

1. Klicka på Konfigurera > data i din Genie-miljö.
2. Klicka på ett tabellnamn för att visa dess kolumner.
3. Klicka på pennikon bredvid kolumnnamnet.
4. Klicka på Avancerat.
5. Inaktivera Formathjälp .

Den här åtgärden inaktiverar också automatiskt entitetsmatchning för den kolumnen. Om det behövs använder du den här inställningen för att aktivera formathjälpen igen.

Konfigurera entitetsmatchning

Genie genererar svar med hjälp av din fråga, relevanta tabellmetadata, matchningsfunktioner för frågor, felsignaler och eventuell indatakod eller frågor. När en kolumn har entitetsmatchning aktiverad använder Genie de lagrade värdena för att matcha användarens uppmaningar till faktiska data mer exakt. Detta ger mer tillförlitliga SQL-frågor. Entitetsmatchning förbättrar geniens noggrannhet avsevärt, särskilt när den kombineras med tydliga exempelfrågor och väl utformade instruktioner. Mer vägledning finns i Kurera ett effektivt Genie-utrymme .

Genie hindrar dig från att aktivera entitetsmatchning på tabeller med radfilter eller kolumnmasker. Utrymmesförfattare måste dock inaktivera entitetsmatchning för vyer som refererar till tabeller med radfilter eller kolumnmasker, eller för dynamiska vyer.

Följande lista innehåller exempel på de typer av data som fungerar bra med entitetsmatchning:

• Delstats- eller landskoder
• Produktkategorier
• Statuskoder
• Avdelningsnamn

Om du vill aktivera entitetsmatchning måste formathjälp aktiveras. Använd sedan följande steg:

1. Klicka på Konfigurera > data i din Genie-miljö.
2. Klicka på ett tabellnamn för att visa dess kolumner.
3. Klicka på pennikon bredvid kolumnnamnet.
4. Klicka på Avancerat.
5. Aktivera entitetsmatchning .
6. Inaktivera entitetsmatchning för en kolumn genom att inaktivera Entitetsmatchning .

Uppdatera eller ta bort uppmaningsmatchningsdata

Om du uppdaterar matchningsdata uppdateras en kolumns lagrade värden. Uppdatera värden om:

• Nya värden har lagts till i kolumnen.
• Formatet för befintliga värden har ändrats.

Om du vill uppdatera matchande data för frågor klickar du på Menyn för kebab i kolumnvyn och sedan Uppdatera matchning av fråga.

Definiera kopplingsrelationer

Hjälp Genie att skapa korrekta JOIN instruktioner genom att definiera tabellrelationer:

1. Klicka på Kopplingar.
2. Klicka på Lägg till.
3. Välj tabeller till vänster och höger från de nedrullningsbara menyerna.
4. Ange ett kopplingsvillkor (till exempel accounts.id = opportunity.accountid)
   • Om du vill ha mer komplicerade kopplingsvillkor klickar du på Använd SQL-uttryck och registrerar sedan kopplingsvillkoret som ett SQL-uttryck.
5. Välj en relationstyp:
   • Många till en: Flera vänsterrader mappas till en högerrad
   • En till många: En rad till vänster bildar flera rader till höger
   • En till en: En vänsterrad mappar till högst en högerrad

Anmärkning

När flera kopplingar finns mellan samma tabeller eller självkopplingar används genererar Genie automatiskt alias för den högra tabellen för att undvika tvetydighet.

Få förslag från feedback

När användare klickar på tummen upp på ett meddelande som kopplar samman tabeller eller använder SQL-uttryck analyserar Genie svaret och kan föreslå nya SQL-kodfragment (till exempel mått, kopplingar eller filter) för utrymmesförfattare att granska och lägga till i kunskapsarkivet. Genie lär sig inte automatiskt eller ändrar sitt beteende baserat på feedback.

Definiera SQL-uttryck

SQL-uttryck ger ett strukturerat, guidat sätt att lära Genie om vanliga affärsvillkor som KPI:er, attribut och villkor. Genie använder sedan dessa definitioner när en användare frågar om dessa affärsvillkor.

SQL-uttryck kompletterar sql-exempelfrågor som anges i anvisningarna. SQL-uttryck definierar återanvändbara affärsbegrepp, men exempel på SQL-frågor är mer användbara för att lära Genie hur man använder vanliga användarpromptformat. Om användarna till exempel ofta ber om "en prestandauppdelning" kan en SQL-exempelfråga visa att det innebär stängd försäljning per region, säljare och chef.

SQL-uttryck fungerar bäst när du behöver:

• Ange strukturerade definitioner för KPI:er och mått, till exempel vinstmarginal eller konverteringsfrekvens
• Ge Genie explicit kontext om hur du beräknar viktiga värden
• Definiera ytterligare dimensioner för datamängden, till exempel månad eller kundsegment
• Konfigurera Genie-filter för affärsvillkor, som stora beställningar eller beställningar gjorda före en viss tid

SQL-uttryckstyper

Du kan definiera följande typer av SQL-uttryck:

• Mått: Nyckeltal (KPI:er) och mått. Definiera namn, SQL-beräkning och synonymer.
• Filter: Vanliga filtreringsvillkor. Definiera namn, SQL-filterlogik och synonymer.
• Dimensioner: Attribut för att gruppera och analysera data. Definiera namn, SQL-uttryck och synonymer.

Använd följande instruktioner för att definiera SQL-uttryck:

1. Klicka på Konfigurera>instruktioner för SQL-uttryck>SQL-uttryck
2. Klicka på Lägg till. Välj Filter, Mått eller Dimension.
3. I fältet Namn anger du ett namn för uttrycket.
4. I fältet Kod anger du SQL-uttrycket.

• Filteruttryck bör utvärderas till ett booleskt villkor.
• Måttuttryck bör beräkna en aggregering över flera rader i tabellen.
• Dimensionsuttryck bör ändra värdet för varje rad från befintliga data.

1. I fältet Synonymer anger du vanliga sätt som användare kan referera till uttrycken på olika sätt.
2. I fältet Instruktioner anger du specifika instruktioner som talar om för Genie vad uttrycket är till för och hur du arbetar med det.

Nästa steg

Använd följande länkar för att hjälpa dig att fortsätta bygga ditt Genie-utrymme.

• Lägg till kontext i ditt Genie-utrymme för att generera korrekta svar. Se Lägga till SQL-exempel och instruktioner
• Lär dig metodtips för att optimera ditt Genie-utrymme. Se Kurera ett effektivt Genie-utrymme
• Utvärdera och förbättra ditt utrymmes prestanda. Se Använd riktmärken i ett Genie-utrymme