Lägga till en Genie Space-resurs i en Databricks-app

Lägg till Genie Spaces som Databricks Apps-resurser för att aktivera frågor på naturligt språk i dina program. Genie Spaces tillhandahåller ett konversationsgränssnitt för datautforskning, så att användarna kan ställa affärsfrågor på vanlig engelska och ta emot SQL-baserade insikter från dina utvalda datauppsättningar.

När du lägger till ett Genie Space som en resurs kan din app:

  • Konvertera frågor på naturligt språk från användare till SQL
  • Åtkomst till förkonfigurerad affärskontext och metadata
  • Använda kuraterade exempelfrågor och datadefinitioner
  • Generera svar baserat på organisationens datauppsättningar

Lägga till en Genie Space-resurs

Innan du lägger till ett Genie Space som en resurs granskar du kraven för appresursen.

  1. I avsnittet Appresurser när du skapar eller redigerar en app klickar du på + Lägg till resursen>Genie Space.
  2. Välj ett Genie-utrymme i listan över tillgängliga utrymmen på din arbetsyta.
  3. Välj behörighetsnivå för din app:
    • Kan visa: Ger appen behörighet att läsa konfigurationen och metadata för Genie Space.
    • Kan köras: Ger appen behörighet att skicka frågor till Genie Space och ta emot svar.
    • Kan redigera: Ger appen behörighet att ändra Genie Space-konfigurationen.
    • Kan hantera: Ger appen fullständig administrativ åtkomst till Genie Space.
  4. (Valfritt) Ange en anpassad resursnyckel, vilket är hur du refererar till Genie Space i appkonfigurationen. Standardnyckeln är genie-space.

När du lägger till en Genie Space-resurs:

  • Azure Databricks beviljar appens serviceobjekt de angivna behörigheterna för det valda Genie Space.
  • Appen kan skicka frågor på naturligt språk till utrymmet och ta emot strukturerade svar med SQL-frågor och resultat.
  • Appen kommer åt utrymmets granskade affärskontext, inklusive metadata, exempelfrågor och datadefinitioner.
  • Åtkomst begränsas endast till det valda utrymmet. Din app kan inte komma åt andra Genie Spaces om du inte lägger till dem som separata resurser.

Anmärkning

Appens huvudkonto behöver också lämpliga behörigheter för de underliggande datakällor som Genie Space utfrågar. Detta omfattar vanligtvis USE CATALOG, USE SCHEMA och SELECT behörigheter för relevanta Unity Catalogs tabeller och vyer.

Miljövariabler

När du distribuerar en app med en Genie Space-resurs exponerar Azure Databricks utrymmes-ID:t via miljövariabler som du kan referera till med hjälp av fältet valueFrom i konfigurationen app.yaml.

Exempelkonfiguration:

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

Använd rymd-ID:t i din applikation:

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

Mer information finns i Åtkomst till miljövariabler från resurser.

Ta bort en Genie Space-resurs

När du tar bort en Genie Space-resurs från en app förlorar appens tjänsthuvudnamn åtkomst till utrymmet. Själva Genie-utrymmet förblir oförändrat och fortsätter att vara tillgängligt för andra användare och program som har lämpliga behörigheter.

Kombinera Genie Spaces med andra appresurser

Kombinera Genie Spaces med andra Databricks Apps-resurser för att skapa mer avancerade dataprogram. Vanliga integrationsmönster är:

Instrumentpanel för analys av naturligt språk

Använd följande resurser tillsammans för att köra interaktiv analys:

  • Genie Space: Konverterar användarfrågor till SQL-frågor
  • SQL-lager: Kör frågorna och returnerar resultat för visualisering
  • Hemligheter: Lagrar API-nycklar för externa visualiseringsverktyg

Exempelkonfiguration:

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

AI-förbättrad business intelligence

Använd följande resurser för att integrera med AI-modeller:

  • Genie Space: Genererar den inledande fråge- och datakontexten
  • Modell som betjänar slutpunkt: Returnerar AI-genererade sammanfattningar och rekommendationer
  • SQL-lager: Kör komplexa analysfrågor

Behörigheter för tjänstens huvudkonto

Ge appens tjänsthuvudnamn följande behörigheter när du integrerar med andra appresurser:

  • CAN RUN på Genie Space
  • CAN USE på SQL-lagret (om du använder ett annat än Genie Space)
  • CAN QUERY på modell som betjänar slutpunkter
  • USE CATALOG och USE SCHEMA på relevanta Unity Catalog-objekt
  • Appen frågar direkt på tabeller

Metodtips

Följ dessa metodtips när du arbetar med Genie Space-resurser:

  • Bevilja minimala behörigheter. Ge endast åtkomst till de specifika Genie Spaces som din app behöver för att fungera.
  • Se till att Genie Space innehåller väl curerade datamängder och metadata för att förbättra kvaliteten på svar på frågor på naturligt språk.
  • Testa appens frågor mot Genie Space för att verifiera att den kan generera korrekta resultat för förväntade användarfrågor.
  • Övervaka frågeprestanda och justera appens interaktionsmönster med Genie Space för att optimera svarstiderna.
  • Implementera felhantering för fall där Genie Space inte kan tolka eller svara effektivt på användarfrågor.
  • Last updated on