Megosztás:

Genie-térerőforrás hozzáadása Egy Databricks-alkalmazáshoz

Adjon hozzá AI-/BI Genie-szóközöket Databricks Apps-erőforrásokként, hogy természetes nyelvi lekérdezéseket lehessen engedélyezni az alkalmazásokban. A Genie-terek beszélgetési felületet biztosítanak az adatfeltáráshoz, így a felhasználók egyszerű angol nyelven tehetnek fel üzleti kérdéseket, és SQL-alapú elemzéseket kaphatnak a válogatott adathalmazokból.

Ha egy Genie-helyet erőforrásként ad hozzá, az alkalmazás a következőkre képes:

  • Természetes nyelvi lekérdezések konvertálása a felhasználóktól SQL-vé
  • Előre konfigurált üzleti környezet és metaadatok elérése
  • Válogatott minta lekérdezések és adatdefiníciók használata
  • Válaszok létrehozása a szervezet adatkészletei alapján

Genie térerőforrás hozzáadása

Mielőtt hozzáad egy Genie-helyet erőforrásként, tekintse át az alkalmazás erőforrás-előfeltételeit.

  1. Alkalmazás létrehozásakor vagy szerkesztésekor lépjen a Konfigurálás lépésre.
  2. Az Alkalmazáserőforrások szakaszban kattintson az + Erőforrás hozzáadása elemre.
  3. Erőforrástípusként válassza a Genie szóközt .
  4. Válasszon egy Genie-helyet a munkaterületen elérhető szóközök listájából.
  5. Válassza ki az alkalmazás jogosultsági szintjét:
    • Megtekintheti a következőt: Engedélyt ad az alkalmazásnak a Genie-tér konfigurációjának és metaadatainak olvasására.
    • Futtatható: Engedélyezi az alkalmazásnak, hogy lekérdezéseket küldjön a Genie-területre, és válaszokat fogadjon.
    • Szerkesztheti a következőt: Engedélyt ad az alkalmazásnak a Genie-tér konfigurációjának módosítására.
    • Kezelheti a következőt: Teljes rendszergazdai hozzáférést biztosít az alkalmazásnak a Genie-területhez.
  6. (Nem kötelező) Adjon meg egy egyéni erőforráskulcsot, így hivatkozhat az alkalmazáskonfiguráció genie területére. Az alapértelmezett kulcs a következő genie-space.

Genie szóközerőforrás hozzáadásakor:

  • Az Azure Databricks megadja az alkalmazás szolgáltatásnévének a megadott engedélyeket a kiválasztott Genie-területen.
  • Az alkalmazás természetes nyelvi lekérdezéseket küldhet a térbe, és strukturált válaszokat fogadhat SQL-lekérdezésekkel és -eredményekkel.
  • Az alkalmazás hozzáfér a tér válogatott üzleti környezetéhez, beleértve a metaadatokat, a minta lekérdezéseket és az adatdefiníciókat.
  • Az access hatóköre csak a kijelölt területre terjed ki. Az alkalmazás csak akkor fér hozzá más Genie-szóközökhöz, ha külön erőforrásként adja hozzá őket.

Megjegyzés:

Az alkalmazás szolgáltatásnévének megfelelő engedélyekre is szüksége van a Genie-tér által lekérdezett mögöttes adatforrásokhoz. Ez általában magában foglalja USE CATALOGUSE SCHEMAa unitykatalógus megfelelő tábláira és SELECT nézeteire vonatkozó engedélyeket.

Környezeti változók

Ha egy Dzsinn-térerőforrással rendelkező alkalmazást helyez üzembe, az Azure Databricks környezeti változókon keresztül teszi elérhetővé a térazonosítót, amelyekre a valueFrom konfigurációban szereplő app.yaml mező használatával hivatkozhat.

Példakonfiguráció:

env:
  - name: GENIE_SPACE_ID
    valueFrom: genie-space # Use your custom resource key if different

A térazonosító használata az alkalmazásban:

import os
from databricks.sdk import WorkspaceClient

# Access the Genie space using the injected environment variable
space_id = os.getenv("GENIE_SPACE_ID")

# Initialize the workspace client
w = WorkspaceClient()

# Start a conversation with a natural language query
response = w.genie.start_conversation_and_wait(
    space_id=space_id,
    content="What were our top-selling products last quarter?"
)

# Process the response (responses contain attachments with text, queries, and so on)
for attachment in response.attachments:
    print(f"Genie response: {attachment.text.content}")

# Continue the conversation with additional questions
follow_up = w.genie.create_message_and_wait(
    space_id=space_id,
    conversation_id=response.conversation_id,
    content="Can you break that down by product category?"
)

További információkért olvassa el az Erőforrásokból származó környezeti változók elérése című részt.

Genie-térerőforrás eltávolítása

Ha eltávolít egy Genie-térerőforrást egy alkalmazásból, az alkalmazás szolgáltatásnéve elveszíti a hozzáférést a térhez. Maga a Genie-terület változatlan marad, és továbbra is elérhető lesz más, megfelelő engedélyekkel rendelkező felhasználók és alkalmazások számára.

Genie-szóközök kombinálása más alkalmazáserőforrásokkal

A Genie-terek és más Databricks Apps-erőforrások kombinálásával kifinomultabb adatalkalmazásokat hozhat létre. Gyakori integrációs minták a következők:

Természetes nyelvi elemzési irányítópult

Interaktív elemzések futtatásához használja a következő erőforrásokat:

  • Genie szóköz: Felhasználói kérdések konvertálása SQL-lekérdezésekké
  • SQL Warehouse: Futtatja a lekérdezéseket, és visszaadja a vizualizáció eredményeit
  • Titkok: API-kulcsok tárolója külső vizualizációs eszközökhöz

Példakonfiguráció:

env:
  - name: GENIE_SPACE_ID
    valueFrom: genie-space
  - name: SQL_WAREHOUSE_ID
    valueFrom: sql-warehouse
  - name: EXTERNAL_API_KEY
    valueFrom: viz-secret

Mesterséges intelligenciával bővített üzleti intelligencia

Az AI-modellekkel való integrációhoz használja az alábbi erőforrásokat:

  • Genie szóköz: Létrehozza a kezdeti lekérdezési és adatkörnyezetet
  • Végpontot kiszolgáló modell: Mi által létrehozott összegzéseket és javaslatokat ad vissza
  • SQL Warehouse: Összetett elemzési lekérdezések futtatása

Szolgáltatásnév engedélyei

Adjon az alkalmazás szolgáltatásnévének a következő engedélyeket más alkalmazáserőforrásokkal való integráláskor:

  • CAN RUN a Genie szóközön
  • CAN USE az SQL Warehouse-on (ha a Genie-tértől eltérőt használ)
  • CAN QUERY végpontokat kiszolgáló modellen
  • USE CATALOG és USE SCHEMA a vonatkozó Unity Catalog-objektumokon
  • SELECT táblákon az alkalmazás lekérdezései közvetlenül

Ajánlott eljárások

Kövesse az alábbi ajánlott eljárásokat a Genie-térerőforrások használatakor:

  • Adjon meg minimális engedélyeket. Csak az alkalmazás működéséhez szükséges adott Genie-szóközökhöz biztosítson hozzáférést.
  • Győződjön meg arról, hogy a Genie-tér jól válogatott adatkészleteket és metaadatokat tartalmaz a természetes nyelvi lekérdezési válaszok minőségének javítása érdekében.
  • Tesztelje az alkalmazás lekérdezéseit a Genie-területen annak ellenőrzéséhez, hogy képes-e pontos eredményeket generálni a várt felhasználói kérdésekhez.
  • Monitorozza a lekérdezési teljesítményt, és módosítsa az alkalmazás interakciós mintáit a Genie-térrel a válaszidők optimalizálása érdekében.
  • Hibakezelés implementálása olyan esetekben, amikor a Genie-terület nem tudja hatékonyan értelmezni vagy megválaszolni a felhasználói lekérdezéseket.
  • Last updated on