Teilen über

Hinzufügen einer Genie Space-Ressource zu einer Databricks-App

Fügen Sie AI/BI Genie Spaces als Databricks Apps-Ressourcen hinzu, um die Abfrage natürlicher Sprachen in Ihren Anwendungen zu ermöglichen. Genie Spaces bieten eine Unterhaltungsschnittstelle für die Datensuche, sodass Benutzer Geschäftsfragen in einfachem Englisch stellen und SQL-basierte Einblicke aus Ihren kuratierten Datasets erhalten können.

Wenn Sie einen Genie-Bereich als Ressource hinzufügen, kann Ihre App:

  • Konvertieren von Abfragen natürlicher Sprache von Benutzern in SQL
  • Zugreifen auf vorkonfigurierte Geschäftskontext und Metadaten
  • Verwenden von kuratierten Beispielabfragen und Datendefinitionen
  • Generieren von Antworten basierend auf den Datasets Ihrer Organisation

Hinzufügen einer Genie Space-Ressource

Bevor Sie einen Genie-Raum als Ressource hinzufügen, überprüfen Sie die Voraussetzungen für die App-Ressource.

  1. Wenn Sie eine App erstellen oder bearbeiten, navigieren Sie zum Schritt "Konfigurieren" .
  2. Klicken Sie im Abschnitt "App-Ressourcen " auf +Ressource hinzufügen.
  3. Wählen Sie das Genie-Leerzeichen als Ressourcentyp aus.
  4. Wählen Sie einen Genie-Bereich aus der Liste der verfügbaren Räume in Ihrem Arbeitsbereich aus.
  5. Wählen Sie die Berechtigungsstufe für Ihre App aus:
    • Kann anzeigen: Gewährt der App die Berechtigung zum Lesen der Genie Space-Konfiguration und -Metadaten.
    • Kann ausgeführt werden: Erteilt der App die Berechtigung, Abfragen an den Genie-Bereich zu übermitteln und Antworten zu erhalten.
    • Kann bearbeiten: Erteilt der App die Berechtigung zum Ändern der Genie Space-Konfiguration.
    • Kann verwalten: Gewährt der App voll administrativen Zugriff auf den Genie Space.
  6. (Optional) Geben Sie einen benutzerdefinierten Ressourcenschlüssel an, mit dem Sie in Ihrer App-Konfiguration auf den Genie-Bereich verweisen. Der Standardwert ist genie-space.

Wenn Sie eine Genie Space-Ressource hinzufügen:

  • Azure Databricks gewährt dem Dienstprinzipal Ihrer App die angegebenen Berechtigungen für den ausgewählten Genie-Bereich.
  • Die App kann Abfragen in natürlicher Sprache an den Raum übermitteln und strukturierte Antworten mit SQL-Abfragen und -Ergebnissen empfangen.
  • Die App greift auf den kuratierten Geschäftskontext des Raums zu, einschließlich Metadaten, Beispielabfragen und Datendefinitionen.
  • Der Zugriff ist nur auf den ausgewählten Bereich festgelegt. Ihre App kann nicht auf andere Genie-Räume zugreifen, es sei denn, Sie fügen sie als separate Ressourcen hinzu.

Hinweis

Der Dienstprinzipal der App benötigt auch entsprechende Berechtigungen für die zugrunde liegenden Datenquellen, die der Genie-Raum abfragt. Dies umfasst USE CATALOGin der Regel die USE SCHEMArelevanten Unity-Katalogtabellen und SELECT -ansichten sowie Berechtigungen.

Umgebungsvariablen

Wenn Sie eine App mit einer Genie Space-Ressource bereitstellen, macht Azure Databricks die Raum-ID über Umgebungsvariablen verfügbar, auf die Sie mithilfe des valueFrom Felds in Ihrer app.yaml Konfiguration verweisen können.

Beispielkonfiguration:

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

Verwenden der Leerzeichen-ID in Ihrer Anwendung:

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

Weitere Informationen finden Sie unter Zugriff auf Umgebungsvariablen von Ressourcen.

Entfernen einer Genie Space-Ressource

Wenn Sie eine Genie Space-Ressource aus einer App entfernen, verliert der Dienstprinzipal der App den Zugriff auf den Raum. Der Genie-Raum selbst bleibt unverändert und steht weiterhin für andere Benutzer und Anwendungen zur Verfügung, die über entsprechende Berechtigungen verfügen.

Kombinieren von Genie-Räumen mit anderen App-Ressourcen

Kombinieren Sie Genie-Räume mit anderen Databricks Apps-Ressourcen, um komplexere Datenanwendungen zu erstellen. Zu den allgemeinen Integrationsmustern gehören:

Dashboard für die Analyse natürlicher Sprachen

Verwenden Sie die folgenden Ressourcen zusammen, um interaktive Analysen auszuführen:

  • Genie Space: Konvertiert Benutzerfragen in SQL-Abfragen
  • SQL Warehouse: Führt die Abfragen aus und gibt Ergebnisse für die Visualisierung zurück.
  • Geheimnisse: Speichert API-Schlüssel für externe Visualisierungstools

Beispielkonfiguration:

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

KI-erweiterte Business Intelligence

Verwenden Sie die folgenden Ressourcen, um in KI-Modelle zu integrieren:

  • Genie Space: Generiert den anfänglichen Abfrage- und Datenkontext.
  • Modell, das Endpunkt bedient: Gibt KI-generierte Zusammenfassungen und Empfehlungen zurück.
  • SQL Warehouse: Führt komplexe analytische Abfragen aus.

Dienstprinzipalberechtigungen

Gewähren Sie dem Dienstprinzipal Ihrer App die folgenden Berechtigungen, wenn sie in andere App-Ressourcen integriert werden:

  • CAN RUN auf dem Genie Space
  • CAN USE auf dem SQL-Lagerhaus (wenn ein separates vom Genie-Raum verwendet wird)
  • CAN QUERY auf Modellbereitstellungsendpunkten
  • USE CATALOG und USE SCHEMA auf relevanten Unity-Katalogobjekten
  • SELECT in Tabellen, die die App direkt abfragt

Bewährte Methoden

Befolgen Sie diese bewährten Methoden, wenn Sie mit Genie Space-Ressourcen arbeiten:

  • Erteilen Sie minimale Berechtigungen. Bieten Sie nur Zugriff auf die spezifischen Genie-Räume, die Ihre App verwenden muss.
  • Stellen Sie sicher, dass der Genie-Raum gut kuratierte Datasets und Metadaten enthält, um die Qualität von Abfragen in natürlicher Sprache zu verbessern.
  • Testen Sie die Abfragen Ihrer App anhand des Genie-Raums, um zu überprüfen, ob sie genaue Ergebnisse für erwartete Benutzerfragen generieren kann.
  • Überwachen Sie die Abfrageleistung, und passen Sie die Interaktionsmuster Ihrer App mit dem Genie-Raum an, um Die Reaktionszeiten zu optimieren.
  • Implementieren Sie die Fehlerbehandlung für Fälle, in denen der Genie-Raum benutzerabfragen nicht effektiv interpretieren oder beantworten kann.
  • Last updated on