AI/BI Genie-terület beállítása és kezelése

Ez a cikk bemutatja, hogyan állíthat be és kezelhet egy Genie-helyet, egy csevegőfelületet az üzleti felhasználók számára, hogy természetes nyelvű kérdéseket tegyenek fel az adataikkal kapcsolatban.

műszaki követelmények és korlátok

A Dzsinn terek használatakor a következő követelmények és korlátozások vonatkoznak:

• Unity Catalog: A Genie tér adatait regisztrálni kell a Unity Katalógusban.
• Compute: Profi vagy kiszolgáló nélküli SQL Warehouse-t kell használnia.
• Átviteli sebesség: Minden munkaterület percenként legfeljebb 20 kérdést tud kezelni az összes Genie-helyen.
• Kapacitás: Minden Genie egység legfeljebb 10 000 beszélgetést képes támogatni, és minden beszélgetés legfeljebb 10 000 üzenetet tartalmazhat.

Szükséges engedélyek

A Genie-szóközök létrehozásához, szerkesztéséhez és használatához a következő engedélyek szükségesek:

• Számítási engedélyek: Genie-tér létrehozóinak, szerkesztőinek és felhasználóinak hozzáférésre van szükségük a térhez kijelölt alapértelmezett SQL-raktárhoz. A létrehozók a tér létrehozásakor kiválasztják az alapértelmezett SQL Warehouse-t. Bármelyik SQL-raktárat kiválaszthatják, amelyhez futtatási engedélyekkel rendelkeznek.
• Adathozzáférési engedélyek: Minden olyan felhasználónak, aki a tárterületet használja, legalább SELECT jogosultsággal kell rendelkeznie a térben használt adatokon.
• Dzsinn-tér engedélyek: A felhasználóknak CAN RUN engedélyekre van szükségük a Genie-térben a Dzsinnel és a térben használt adatokkal való interakcióhoz. A Genie-tér jogosultságainak és képességeinek teljes leképezéséhez tekintse meg Genie térbeli ACL-eket.

Genie-hozzáférés kezelése

A Genie olyan Azure AI-szolgáltatásokra épülő AI-kisegítő funkciókat használ, amelyeket a fiók szintjén kell engedélyezni. Ha szeretné megtudni, hogyan kezelheti ezeket a funkciókat a fiókjához, olvassa el A Databricks Assistantengedélyezése és kipróbálása című témakört.

Új Genie-tér létrehozása

A genie-szóközök lehetővé teszik az adatelemzők számára, hogy tartományspecifikus Genie-térélményt hozzanak létre az üzleti felhasználók számára az alábbi lépések végrehajtásával:

1. Kattintson a(z) Genie elemre az oldalsávon.

2. Kattintson Új elemre a képernyő jobb felső sarkában.

   

3. Az Új párbeszédpanelen válassza ki a kezdeti beállításokat. A lehetőségek leírása a következő:

• Cím: A cím más munkaterület-objektumokkal együtt jelenik meg a munkaterület böngészőjében. Válasszon egy címet, amely segít a végfelhasználóknak felfedezni a Genie-helyet.
• Leírás: A felhasználók a Genie-terület megnyitásakor látják a leírást. Ezen a szövegmezőn írja le a terület célját. A leírásmező támogatja a Markdown-formázást, így formázhatja a szöveget, és hasznos környezetekre és hivatkozásokra mutató hivatkozásokat adhat meg. A Markdown szintaxissal kapcsolatos további információkért tekintse meg ezt az útmutatót .
• Alapértelmezett raktár: Ez a számítási erőforrás irányítja a Genie-szóközökben létrehozott SQL-utasításokat. A végfelhasználóknak hozzáférésre van szükségük ehhez a raktárhoz a terület használatához. A Genie-tárhelyek profi vagy kiszolgáló nélküli SQL-raktárat is használhatnak. Az optimális teljesítmény érdekében a Databricks egy kiszolgáló nélküli SQL Warehouse használatát javasolja.
• Táblázatok: A genie terek alapja egy vagy több táblázat lehet. Legfeljebb 25 táblát tartalmazhat. A Táblák hozzáadása gomb egy új párbeszédpanelt nyit meg, ahol kiválaszthatja a belefoglalni kívánt Unity-katalógustáblákat.
• Mintakérdések: A mintakérdések nem kötelezőek. A csevegésekben megjelennek, hogy példákat adjanak a felhasználók által feltehető kérdések típusaira. A létrehozás során vagy később hozzáadhatók a terület Beállításokmenüjéből.

Utasítások megadása

Az utasítások segítenek Genie válaszainak irányításában, hogy feldolgozhassa az adott szakterület egyedi zsargonját, logikáját és fogalmait. Az átfogó utasítások kritikus fontosságúak a zökkenőmentes, intuitív Genie-térélményhez. Az utasítások megadásához kattintson Utasítások a Genie szóköz oldalsávján az utasítások panel megnyitásához. Ezen a panelen Általános utasítások, Példa SQL-lekérdezésekés SQL-függvényekhozzáadása.

Összesen legfeljebb 100 utasítást adhat hozzá egy Genie-területhez. A számhoz a következők járulnak hozzá:

• Az általános utasítások teljes szövegblokkja egynek számít.
• Minden példa SQL-lekérdezés egy-egynek számít.
• Minden SQL-függvény egynek számít.

Általános utasítások

Adjon meg egyszerű szöveges utasításokat, amelyek a Genie üzleti vagy válaszbeállításait közvetítik. Az utasításokat egyetlen átfogó megjegyzésként formázhatja, vagy témakör szerint kategorizálhatja őket a jobb szervezet érdekében.

Az alábbiakban egy példa látható az általános utasításokban szereplő információkra:

• vállalatspecifikus üzleti információk:
  • "Pénzügyi évünk februárban kezdődik"
• Értékek, aliasok vagy gyakori szűrők:
  • "Mindig alakítsa át kisbetűssé, és használjon hasonló operátort szűrők alkalmazásakor."
  • "Használjon rövidítéseket a szűrőértékekben lévő állapotokhoz."
• Adjon meg függvényeket a kérdések megválaszolásához, és adja meg a visszatérési értékekre vonatkozó utasításokat:
  • Negyedévek esetén használja a adventureworks.oneb.get_quarter(date) UDF-t. A get_quarter() kimenete a negyedév, és 1, 2, 3 vagy 4. Ezzel szükség szerint szűrheti az adatokat.

PÉLDA SQL-lekérdezésekre

Például, az SQL-lekérdezések olyan SQL-lekérdezések, amelyeket a Genie betanítása érdekében készít. A Genie intelligensen kiválasztja a releváns lekérdezéseket, hogy a kérdések megválaszolásakor a válasz létrejönjön. Amikor példa lekérdezéseket ad hozzá, megmutatja a Genie-nek, hogyan használja fel az adatokat a kérdések megválaszolásához. Felkérheti példakérdéseket is, hogy megtanítsa Genie-nek, milyen típusú kérdések megválaszolására számítana az adott lekérdezés. Ha Genie egyező kérdést kap, közvetlenül a példa lekérdezéssel adhat választ. Ha hasonló kérdést kap, a példa lekérdezésből származó nyomok segítségével strukturálhatja a válaszban megadott SQL-t. Összpontosítson a szervezetre és adatokra jellemző logikát kiemelő minták megadására, ahogyan az alábbi példában is látható:

  -- Return our current total open pipeline by region.
  -- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = 'Pipeline' AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

Paraméterek hozzáadása SQL-lekérdezésekben

A paraméterek lehetővé teszik, hogy példalekérdezéseket írjon helyőrzőkkel, amelyeket futásidőben adott értékekre cserélhet. A paraméterekkel a Genie konkrét bemeneteket vehet fel a felhasználói kérdésekből, és felhasználhatja egy példa lekérdezés szerkezetét, hogy megbízható eszközként ellenőrzött válaszokat adjon. Módosíthatja például az előző SQL-lekérdezést úgy, hogy tartalmazzon egy paramétert, amely a o.forecastcategory érték alapján szűr, lehetővé téve a lekérdezés számára a különböző előrejelzési kategóriákban megjelölt lehetőségekkel kapcsolatos kérdések megválaszolását. A paraméteres lekérdezések megbízható objektumokként megjelölt válaszok létrehozására való használatával kapcsolatos további információkért lásd: Megbízható objektumok használata AI/BI Genie-szóközökben.

Az alábbi kódrészlet az előző példát mutatja be, amelyet úgy módosítottunk, hogy hozzáadunk egy paramétert a o.forecastcategory értékhez. A paraméterek ugyanazt a szintaxist használják, mint a nevesített paraméterjelölők. Lásd: Elnevezett paraméterjelölők.

-- Return our current pipeline at a stage by region.
-- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = :forecast_category AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

Paraméter hozzáadása lekérdezéshez:

1. Helyezze a kurzort arra a helyre, ahová a paramétert el szeretné helyezni a lekérdezésben.

2. Új paraméter beszúrásához kattintson a Paraméter hozzáadása elemre.

   Ezzel létrehoz egy új paramétert az alapértelmezett parameternévvel. Az alapértelmezett név módosításához cserélje le a lekérdezésszerkesztőben. Paramétereket úgy is hozzáadhat, hogy begépel egy kettőspontot, majd egy paraméternevet (:parameter_name) a szerkesztőbe.

Lekérdezési paraméter szerkesztése

Paraméter szerkesztéséhez tegye a következőket:

1. Kattintson a paraméter neve mellett. Megjelenik egy paraméter részletei párbeszédpanel, amely a következő konfigurációs beállításokat tartalmazza:

   • Kulcsszó: A lekérdezés paraméterét képviselő kulcsszó. A kulcsszó csak a lekérdezés szövegének közvetlen frissítésével módosítható.

   • Megjelenítendő név: Az alkalmazás által a csevegési felületen használt, ember által olvasható név. Amikor a Genie paraméteres lekérdezéssel hoz létre választ, az tartalmazza a megjelenítendő nevet és a hozzá tartozó értéket a válaszban.

   • Típus: A támogatott típusok közé tartozik sztring, dátum, dátum és idő, és szám.

     • Az alapértelmezett típus Karakterlánc.
     • A Numerikus adattípus lehetővé teszi decimális és egész számközötti megadását. Az alapértelmezett numerikus típus a decimális.

     Jegyzet

     Ha a tényleges bemeneti érték nem egyezik a kiválasztott paramétertípussal, a Genie helytelen típusként kezeli a bemeneti értéket, ami pontatlan eredményekhez vezethet.

2. A párbeszédpanel bezárásához kattintson a felhasználói felület egy másik részére.

SQL-függvények

Az SQL-függvények olyan egyéni függvények, amelyeket a Unity Catalog tárol, és amelyeket a Genie használ adott kérdések megválaszolására. A Genie meghívhatja ezeket a függvényeket, és beszúrhat felhasználó által megadott paramétereket, de nem fér hozzá a mögöttes SQL-tartalomhoz. Ez azt jelenti, hogy az SQL-függvények ideálisak olyan gyakori konkrét kérdések megválaszolásához, amelyek olyan összetett argumentumokat vagy számításokat tartalmaznak, amelyeket a Genie nem tud elérni vagy szerkeszteni. A függvények Unity Catalogban való regisztrálásával kapcsolatos útmutatásért lásd: Sql Table-függvény létrehozása és Felhasználó által definiált függvények (UDF-ek) létrehozása a Unity Catalog.

A Genie-tér tesztelése

A felhasználói interakciók többsége a csevegőablakban történik. A legjobb módja annak, hogy megtudja, hogy a helyisége úgy működik-e, ahogy szeretné, az, ha valósághű kérdésekkel teszteli, amelyeket az üzleti felhasználók valószínűleg feltennének.

A beállításokban megadott mintakérdések a csevegőablakban jelennek meg. Ezek a mintakérdések segítenek a felhasználóknak megérteni, hogy milyen kérdéseket tehetnek fel a Genie-helyükön. A szövegmező, ahol a felhasználók kérdéseket adnak meg, a képernyő alján található.

A válaszok a szövegmező felett jelennek meg. Miután egy felhasználó beírt egy kérdést, a rendszer a bal oldali panelen menti azt egy csevegési előzményszálba.

Új csevegés indítása:

1. Kattintson a csevegés ikonra a csevegőablak megnyitásához.
2. Írja be a kérdést a Tegye fel a kérdést... szövegbeviteli mezőbe. Új beszélgetési szál indításához kattintson a + Új csevegéselemre.

Válaszok áttekintése

A válaszok általában természetes nyelvi válaszként jelennek meg a kérdésekre, és egy táblázat, amely a megfelelő eredményhalmazt jeleníti meg. Amikor Genie azt észleli, hogy egy vizualizáció javíthatja a válasz egyértelműségét, egy vizualizációt is visszaad. A pontos válaszstruktúra a kérdéstől függően változik. Minden válasz tartalmazza a kérdés megválaszolásához létrehozott SQL-lekérdezést. Kattintson Létrehozott kód megjelenítése elemre a létrehozott lekérdezés megtekintéséhez.

A válasz jobb alsó része opcionális műveleteket is tartalmaz. A felhasználók átmásolhatják a válasz CSV-t a vágólapra, letölthetik CSV-fájlként, hozzáadhatják a Genie-tér utasításaként, és fel- vagy leoszthatják a választ. Vizualizáció szerkesztéséhez kattintson a vizualizáció jobb felső sarkában található szerkesztés ikonra. A vizualizációk szerkesztésére vonatkozó további útmutatásért lásd: Vizualizációk létrehozása.

A gyorsműveletek csempék táblázatos adatokat tartalmazó válaszokat követnek. Vizualizációk létrehozásához használhatja őket.

Vizualizációt úgy is létrehozhat, hogy szavakban írja le a lekérdezés eredményének lekérése után. Lásd: Vizualizációk létrehozása.

Eredmények formázása

Az egyik válaszban található táblázat oszlopának formázásához kattintson az oszlopfejlécen található , majd kattintson a Formázás lehetőségre az elérhető beállítások megtekintéséhez. A formázási beállítások az oszlop adattípusától függenek.

Az eredményhalmaz letöltése

A térfelhasználók csv-ként legfeljebb 1 GB eredményadatokat tölthetnek le. A végső fájlletöltés mérete valamivel nagyobb vagy kisebb lehet, mint 1 GB, mivel az 1 GB-os korlát egy korábbi lépésre lesz alkalmazva, mint a végleges fájlletöltés. Az eredmények letöltéséhez kattintson a letöltés ikonra a válaszban.

Vizualizációk létrehozása

A felhasználók explicit módon kérhetnek vizualizációt a csevegőablakban, vagy a választ követő Gyorsműveletek szakaszban található javasolt vizualizációk egyikével. A Genie néha egy válasz részeként vizualizációt is kínál. Az automatikusan létrehozott vizualizáció elrejtéséhez kattintson az összecsukás ikonra. Ha újra meg szeretné jeleníteni, kattintson a Vizualizáció megjelenítéseelemre.

A vizualizációkat a csevegőablakban szerkesztheti.

A következő diagramtípusok támogatottak:

• Terület
• Bár
• Sor
• Pite
• Szórás

Vizualizáció szerkesztése:

• A vizualizáció jobb felső sarkában kattintson a szerkesztés ikonra. Megnyílik egy szerkesztőablak a lap jobb oldalán.
• A Vizualizáció legördülő menüvel válasszon másik diagramtípust.
• A legtöbb diagramtípus esetében az X tengely és Y tengely legördülő menüben válassza ki az egyes tengelyeken megjelenített értékeket. A kördiagramok esetében a Szög legördülő menüben válassza ki a megjeleníteni kívánt oszlopot.
• (Nem kötelező) A színséma testreszabásához kattintson a + a Szín kategóriában.
• (Nem kötelező) Ha ki szeretné jelölni az elemleírásban megjelenítendő adatokat, amikor a vizualizáció fölé viszi az egérmutatót, kattintson a + az Elemleírás szakaszban.

Visszajelzés a válaszról

Minden AI/BI Genie-válasz tartalmaz egy felfelé vagy lefelé mutató visszacsatolási gombot. A Databricks javasolja, hogy a felhasználók visszajelzést adjanak a térről ezzel a mechanizmussal.

A lekérdezési eredményeket tartalmazó válasz esetén a felhasználók kérhetik, hogy a Dzsinn térszerkesztője tekintse át azokat a . Ha a felhasználónak kérdése van a létrehozott válasz minőségével vagy pontosságával kapcsolatban, megjelölheti azt véleményezésre, és tetszés szerint hozzáadhatja a megjegyzését vagy kérdését.

Az üzleti felhasználók megtekinthetik a Előzmények lapon véleményezésre megjelölt kérdések frissítéseit. A Genie-területen legalább KEZELHETŐ engedéllyel rendelkező felhasználók áttekinthetik az adott cserét, megjegyzést fűzhetnek a kéréshez, és megerősíthetik vagy kijavíthatják a választ. A visszajelzéseket és a kérelmeket a monitorozási oldalon tekinthetik meg. Ezután a visszajelzések segítségével hangolhatja a válaszokat, valamint fejlesztheti a teret. Lásd: Előzmények és visszajelzések áttekintése.

Áttekintés előzményei és visszajelzései

A Genie-tér az adatcsoportok és az üzleti felhasználók folyamatos együttműködési eszközének szánta a tudás összegyűjtését, nem pedig egyszeri üzembe helyezést. A tudásépítéshez elengedhetetlen, hogy megismerje azokat az új kérdéseket, amelyekre az üzleti felhasználóknak választ kell adniuk. Az előzményoldalon megtekintheti az egyes kérdéseket és válaszokat, a felhasználók által küldött hüvelykujj-fel- vagy ujjlenyomat-visszajelzéseket, valamint a véleményezésre megjelölt kérdéseket. Az előzményoldal megnyitásához kattintson Előzmény a Genie szóköz oldalsávján.

Az előzményoldalon a térben feltett összes kérdés és válasz látható. A kérdéseket szűrheti idő, értékelés, felhasználó vagy állapot szerint. A tér monitorozásával a Genie térszerkesztői proaktív módon megérthetik az üzleti felhasználók által felvetett lekérdezéseket és a Genie-tér válaszát.

A Genie által felmerülő kérdések azonosításával frissítheti a Genie-teret a válaszok javítása érdekében adott utasításokkal. Kattintson egy kérdésre a kérdés és a válasz szövegének megnyitásához. A teljes csevegési szálat ebből a nézetből is elérheti.

Generált SQL szerkesztése

A létrehozott SQL-t bármely válaszban áttekintheti és szerkesztheti. A Genie-tér szerzői általában ismerik a területet és az adatokat, amelyek lehetővé teszik számukra, hogy felismerjék, amikor a Genie helytelen választ ad. A hibák gyakran kis mennyiségű manuális hangolással javíthatók a létrehozott SQL-lekérdezésre. A létrehozott SQL bármely válaszhoz való megtekintéséhez kattintson a Generált kód megjelenítése a lekérdezés vizsgálatához.

A létrehozott SQL-utasítást szerkesztheti, hogy kijavítsa azt, ha a Genie-területen szerkesztési vagy nagyobb jogosultságokkal rendelkezik. A javítások után futtassa a lekérdezést. Ezután mentheti utasításként, hogy megtanítsa Genie-nek, hogyan válaszoljon a jövőben. A szerkesztett lekérdezés mentéséhez kattintson a Mentés utasításként.

Dzsinn tér megosztása

A Genie-tér felhasználóinak rendelkezniük kell a Genie-térhez csatolt raktár HASZNÁLATI jogokkal, és hozzáférési engedélyekkel kell rendelkezniük a térben elérhető Unity-katalógus-objektumokhoz. Lásd Milyen adatokat használjak?.

Az új Genie területek alapértelmezés szerint a felhasználói mappába lesznek mentve. A többi munkaterület-objektumhoz hasonlóan a beágyazási mappából öröklik az engedélyeket. A munkaterület mappastruktúrájával megoszthatja őket más felhasználókkal. Lásd: Munkaterület-objektumok mappákba rendezése.

Megadhatja bizonyos felhasználókat vagy csoportokat is, akivel meg szeretne osztani egy adott engedélyszinten: CAN MANAGE, CAN EDIT, CAN RUN és CAN VIEW.

Megosztás adott felhasználókkal vagy csoportokkal:

1. Kattintson megosztása gombra.
2. Adja meg a helyet megosztani kívánt felhasználókat vagy csoportokat. Ezután kattintson a hozzáadása elemre, és állítsa be a megfelelő jogosultsági szinteket. Az egyes felhasználók és a kis csoportok tagjai e-mailben értesítést kapnak arról, hogy a terület meg lett osztva.
3. A Megosztás párbeszédpanel alján található Hivatkozás másolása gombra kattintva egy megosztható hivatkozást kaphat a Genie térhez. A kiemelt felhasználók a hivatkozásra kattintva megnyithatják a Genie-területet egy új lapon, és kérdéseket tehetnek fel.

Genie tér klónozása

A Genie-tér klónozása létrehoz egy másolatot, amely tartalmazza az összes beállítási környezetet és útmutatást. Ez akkor hasznos, ha jól kiépített területtel rendelkezik, és új helyet szeretne létrehozni a környezet további teszteléséhez vagy az eredeti térből való újbóli felhasználásához. A hely klónozása után az új hely független az eredetitől, így módosításokat hajthat végre anélkül, hogy azok hatással lennének az eredetire.

A rendszer a következő elemeket másolja egy klónozott Genie-térbe:

• Táblák és beállítások
• Általános utasítások
• Példa SQL-lekérdezésekre
• SQL-függvények

A meglévő csevegési szálak és az előzmények adatai nem lesznek átmásolva az új helyre.

Genie-tér klónozásához tegye a következőket:

1. Nyissa meg a klónozni kívánt Genie-helyet.
2. Kattintson a <kebab menüre> kebab menüre a szóköz jobb felső sarkában.
3. Kattintson a Klónozás gombra.
4. (Nem kötelező) A Klónozás párbeszédpanelen adjon meg egy új nevet és a munkaterület mappa helyét a klónozott Genie-területhez.
5. Kattintson a Klónozás elemre az új terület létrehozásához.

Ajánlott eljárások a tér előkészítéséhez

Az ajánlott gyakorlatokkal kapcsolatos útmutatásért és a hibaelhárításhoz lásd: Hatékony Genie-tér.

Használat figyelése

Az auditnaplók segítségével figyelheti a Genie-terület használatát. Lásd a AI/BI Genie eseményeket.

A Genie beszélgetési API használata

A Genie Conversation API egy olyan végpontot tesz elérhetővé egy meglévő Genie-terület számára, ahol kérdéseket tehet fel, lekérheti a létrehozott SQL- és lekérdezési eredményeket, vagy lekérheti a Genie-térhez társított részleteket. A Conversations API átviteli aránya csak törekvés, és a rendszerkapacitástól függ. Normál vagy alacsony forgalmú körülmények között a kérések percenként 5 lekérdezésre korlátozódnak munkaterületenként. A maximális kihasználtság időszakában a tényleges átviteli sebesség alacsonyabb lehet, mivel a kérelmek feldolgozása a rendelkezésre álló kapacitás alapján történik.

Ha többet szeretne megtudni arról, hogyan hozhat létre többügynök-rendszert a Mozaik AI-ügynök keretrendszerével, olvassa el A Genie használata többügynök-rendszerekbencímű témakört.