Přidejte do aplikace Databricks prostředek Genie Agent

Přidejte agenty Genie jako prostředky Databricks Apps, které umožňují dotazování v přirozeném jazyce ve vašich aplikacích. Agenti 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 získávat přehledy založené na SQL z kurátorovaných datových sad.

Když jako prostředek přidáte agenta 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řidejte prostředek Genie Agent

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

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

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

  • Azure Databricks udělí instančnímu objektu vaší aplikace zadaná oprávnění pro vybraného agenta Genie.
  • Aplikace může do agenta 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 spravovanému obchodnímu kontextu agenta, včetně metadat, ukázkových dotazů a definic dat.
  • Přístup je omezený jenom na vybraného agenta. Vaše aplikace nemá přístup k jiným agentů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é agent Genie dotazuje. To obvykle zahrnuje oprávnění USE CATALOG, USE SCHEMA a SELECT k relevantním tabulkám a zobrazením katalogu Unity.

Proměnné prostředí

Když nasadíte aplikaci s prostředkem agenta 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 prostoru v aplikaci:

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

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

Odebrání prostředku agenta Genie

Když z aplikace odstraníte prostředek agenta Genie, instanční objekt aplikace ztratí přístup k agentovi. Samotný agent Genie zůstane beze změny a bude nadále dostupný pro ostatní uživatele a aplikace s příslušnými oprávněními.

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

Kombinování agentů Genie s dalšími prostředky Databricks Apps za účelem vytváření důmyslnějších datových aplikací 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:

  • Agent Genie: 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

Vylepšená business intelligence pomocí umělé inteligence

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

  • Agent Genie: 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í aplikačního objektu služby

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 v aplikaci Genie Agent
  • CAN USE v datovém skladu SQL (pokud používáte jiný než ten pro Agenta Genie)
  • CAN QUERY v modelu obsluhující koncové body
  • USE CATALOG a USE SCHEMA na relevantních objektech katalogu Unity
  • SELECT na tabulky, na které se aplikace dotazuje přímo

Osvědčené postupy

Při práci s prostředky agenta Genie 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 agentům Genie, které vaše aplikace potřebuje používat.
  • Zajistěte, aby agent 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 agenta 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 aplikace pomocí agenta Genie, abyste optimalizovali dobu odezvy.
  • Implementujte zpracování chyb v případech, kdy agent Genie nedokáže efektivně interpretovat dotazy uživatelů nebo na ně reagovat.
  • Last updated on