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.

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.