Přidání prostředku Prostoru Genie do aplikace Databricks

Přidejte prostory AI/BI Genie jako prostředky Databricks Apps, které umožňují dotazování přirozeného jazyka ve vašich aplikacích. Prostory Genie poskytují konverzační rozhraní pro zkoumání dat, které uživatelům umožňuje klást obchodní otázky v prosté angličtině a přijímat přehledy založené na SQL z kurátorovaných datových sad.

Když jako prostředek přidáte prostor Genie, vaše aplikace může:

• Převod dotazů přirozeného jazyka od uživatelů na SQL
• Přístup k předkonfigurovanému obchodnímu kontextu a metadatům
• Použití kurátorovaných ukázkových dotazů a definic dat
• Generování odpovědí na základě datových sad vaší organizace

Přidání prostředku Genie space

Než přidáte prostor Genie jako prostředek, projděte si požadavky na prostředek aplikace.

1. Při vytváření nebo úpravě aplikace přejděte ke kroku Konfigurace .
2. V části Prostředky aplikace klikněte na + Přidat prostředek.
3. Jako typ prostředku vyberte prostor Genie .
4. V seznamu dostupných prostorů v pracovním prostoru vyberte prostor Genie.
5. Vyberte úroveň oprávnění pro vaši aplikaci:
   • Může zobrazit: Udělí aplikaci oprávnění ke čtení konfigurace a metadat prostoru Genie.
   • Může běžet: Udělí aplikaci oprávnění odesílat dotazy do prostoru Genie a přijímat odpovědi.
   • Může upravit: Udělí aplikaci oprávnění k úpravě konfigurace prostoru Genie.
   • Může spravovat: Udělí aplikaci úplný přístup pro správu do prostoru Genie.
6. (Volitelné) Zadejte vlastní klíč prostředku, což je způsob, jakým odkazujete na prostor Genie v konfiguraci aplikace. Výchozí klíč je genie-space.

Když přidáte prostředek Prostoru Genie:

• Azure Databricks uděluje instančnímu objektu vaší aplikace zadaná oprávnění pro vybraný prostor Genie.
• Aplikace může do prostoru odesílat dotazy v přirozeném jazyce a přijímat strukturované odpovědi s dotazy a výsledky SQL.
• Aplikace přistupuje ke kurátorovaným obchodnímu kontextu prostoru, včetně metadat, ukázkových dotazů a definic dat.
• Access je omezený jenom na vybraný prostor. Vaše aplikace nemá přístup k jiným prostorům Genie, pokud je nepřidáte jako samostatné prostředky.

Poznámka:

Instanční objekt aplikace také potřebuje příslušná oprávnění k podkladovým zdrojům dat, které dotazuje prostor Genie. To obvykle zahrnuje USE CATALOG, USE SCHEMAa SELECT oprávnění k relevantním tabulkám a zobrazením katalogu Unity.

Proměnné prostředí

Když nasadíte aplikaci s prostředkem prostoru Genie, Azure Databricks zveřejní ID prostoru prostřednictvím proměnných prostředí, na které můžete odkazovat pomocí valueFrom pole v app.yaml konfiguraci.

Příklad konfigurace:

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

Použití ID mezery v aplikaci:

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?"
)

Další informace najdete v tématu Přístup k proměnným prostředí z prostředků.

Odebrání prostředku Genie space

Když z aplikace odeberete prostředek prostoru Genie, instanční objekt aplikace ztratí přístup k prostoru. Samotný prostor Genie zůstane beze změny a bude nadále dostupný pro ostatní uživatele a aplikace, které mají příslušná oprávnění.

Kombinování prostorů Genie s jinými prostředky aplikací

Zkombinujte prostory Genie s dalšími prostředky Databricks Apps a vytvářejte důmyslnější datové aplikace. Mezi běžné vzory integrace patří:

Řídicí panel analýzy přirozeného jazyka

Pomocí následujících prostředků můžete spouštět interaktivní analýzy:

• Genie space: Převede dotazy uživatelů na dotazy SQL.
• SQL Warehouse: Spustí dotazy a vrátí výsledky pro vizualizaci.
• Tajemství: Ukládá klíče rozhraní API pro externí nástroje vizualizace.

Příklad konfigurace:

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

Rozšířené business intelligence s umělou inteligencí

K integraci s modely AI použijte následující zdroje informací:

• Genie space: Vygeneruje počáteční kontext dotazu a dat.
• Koncový bod obsluhy modelu: Vrátí souhrny a doporučení generované AI.
• SQL Warehouse: Spouští složité analytické dotazy.

Oprávnění instančního objektu

Při integraci s jinými prostředky aplikace udělte instančnímu objektu vaší aplikace následující oprávnění:

• CAN RUN na prostoru Genie
• CAN USE ve službě SQL Warehouse (pokud používáte samostatný objekt od prostoru Genie).
• CAN QUERY v modelu obsluhující koncové body
• USE CATALOG a USE SCHEMA o relevantních objektech katalogu Unity
• SELECT v tabulkách, na které se aplikace dotazuje přímo

Osvědčené postupy

Při práci s prostředky Genie space postupujte podle těchto osvědčených postupů:

• Udělte minimální oprávnění. Poskytněte přístup jenom ke konkrétním prostorům Genie, které vaše aplikace potřebuje k fungování.
• Zajistěte, aby prostor Genie obsahoval dobře kurátorované datové sady a metadata, aby se zlepšila kvalita odpovědí dotazů v přirozeném jazyce.
• Otestujte dotazy vaší aplikace na prostor Genie a ověřte, že může generovat přesné výsledky pro očekávané uživatelské otázky.
• Monitorujte výkon dotazů a upravte vzorce interakce vaší aplikace s prostorem Genie, abyste optimalizovali dobu odezvy.
• Implementujte zpracování chyb v případech, kdy prostor Genie nedokáže efektivně interpretovat dotazy uživatelů nebo na ně reagovat.