Genie Agent-erőforrás hozzáadása Egy Databricks-alkalmazáshoz

Adjon hozzá Genie-ügynököket Databricks Apps-erőforrásokként a természetes nyelvi lekérdezések engedélyezéséhez az alkalmazásokban. A Genie-ügynökök 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-ügynököt ad hozzá erőforrásként, 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-ügynök erőforrás hozzáadása

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

  1. Az Alkalmazás-erőforrások szakaszban egy alkalmazás létrehozásakor vagy szerkesztésekor kattintson a + Erőforrás hozzáadása>Genie Agent elemre.
  2. Válasszon egy Genie-ügynököt a munkaterületén elérhető területek listájából.
  3. Válassza ki az alkalmazás jogosultsági szintjét:
    • Megtekintheti a következőt: Engedélyt ad az alkalmazásnak a Genie-ügynök konfigurációjának és metaadatainak olvasására.
    • Futtatható: Engedélyezi az alkalmazásnak, hogy lekérdezéseket küldjön a Genie-ügynöknek, és válaszokat fogadjon.
    • Szerkesztheti a következőt: Engedélyt ad az alkalmazásnak a Genie-ügynök 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-ügynökhöz.
  4. (Nem kötelező) Adjon meg egy egyéni erőforráskulcsot, így hivatkozhat a Genie-ügynökre az alkalmazáskonfigurációban. Az alapértelmezett kulcs a következő genie-space.

Genie-ügynök erőforrás hozzáadásakor:

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

Megjegyzés:

Az alkalmazás szolgáltatásnév-azonosítójának is rendelkeznie kell a megfelelő jogosultságokkal azokon a mögöttes adatforrásokon, amelyeket a Genie-ügynök lekérdez. Ez általában magában foglalja USE CATALOG, USE SCHEMA, és SELECT engedélyeket a megfelelő Unity Catalog táblákra és nézetekre.

Környezeti változók

Ha egy alkalmazást Genie Agent-erőforrással helyez üzembe, az Azure Databricks a téraazonosítót környezeti változókon keresztül teszi elérhetővé, amelyre a valueFrom konfigurációban található 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 Agent 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 Agent-erőforrás eltávolítása

Amikor eltávolít egy Genie Agent-erőforrást egy alkalmazásból, az alkalmazás szolgáltatásnév elveszíti az ügynökhöz való hozzáférést. Maga a Genie-ügynök 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-ügynökök kombinálása más alkalmazáserőforrásokkal

A Genie-ügynökök é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-ügynök: 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-ügynök: Létrehozza a kezdeti lekérdezési és adatkörnyezetet
  • Modellszolgáltatási végpont: AI által generált összefoglalókat és ajánlásokat 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-ügynökön
  • CAN USE az SQL Warehouse-ban (ha nem ugyanazt használja, mint a Genie Agent)
  • CAN QUERY végpontokat kiszolgáló modellen
  • USE CATALOG és USE SCHEMA a vonatkozó Unity Catalog-objektumokon
  • Az alkalmazás közvetlenül a táblákat kérdezi le.

Ajánlott eljárások

Kövesse az alábbi ajánlott eljárásokat a Genie-ügynök erőforrásainak használatakor:

  • Adjon meg minimális engedélyeket. Csak az alkalmazás működéséhez szükséges adott Genie-ügynökökhöz biztosítson hozzáférést.
  • Győződjön meg arról, hogy a Genie-ügynök 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-ügynökön 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-ügynökkel a válaszidők optimalizálása érdekében.
  • Hibakezelés implementálása olyan esetekben, amikor a Genie-ügynök nem tudja hatékonyan értelmezni vagy megválaszolni a felhasználói lekérdezéseket.
  • Last updated on