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

Fügen Sie Genie Agents als Databricks Apps-Ressourcen hinzu, um die Abfrage natürlicher Sprachen in Ihren Anwendungen zu ermöglichen. Genie Agents 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 Agent 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 Agent-Ressource

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

  1. Klicken Sie im Abschnitt "App-Ressourcen " beim Erstellen oder Bearbeiten einer App auf +Ressource>Genie Agent hinzufügen.
  2. Wählen Sie einen Genie Agent aus der Liste der verfügbaren Räume in Ihrem Arbeitsbereich aus.
  3. Wählen Sie die Berechtigungsstufe für Ihre App aus:
    • Kann anzeigen: Gewährt der App die Berechtigung zum Lesen der Genie Agent-Konfiguration und -Metadaten.
    • Kann ausgeführt werden: Erteilt der App die Berechtigung, Abfragen an den Genie-Agent zu übermitteln und Antworten zu erhalten.
    • Kann bearbeiten: Gewährt der App die Berechtigung zum Ändern der Genie Agent-Konfiguration.
    • Kann verwalten: Gewährt der App voll administrativen Zugriff auf den Genie Agent.
  4. (Optional) Geben Sie einen benutzerdefinierten Ressourcenschlüssel an, mit dem Sie in Ihrer App-Konfiguration auf den Genie-Agent verweisen. Der Standardschlüssel ist genie-space.

Wenn Sie eine Genie Agent-Ressource hinzufügen:

  • Azure Databricks gewährt dem Dienstprinzipal Ihrer App die angegebenen Berechtigungen für den ausgewählten Genie-Agent.
  • Die App kann Abfragen in natürlicher Sprache an den Agent senden und strukturierte Antworten mit SQL-Abfragen und -Ergebnissen empfangen.
  • Die App greift auf den kuratierten Geschäftskontext des Agents zu, einschließlich Metadaten, Beispielabfragen und Datendefinitionen.
  • Der Zugriff ist nur auf den ausgewählten Agenten beschränkt. Ihre App kann nicht auf andere Genie Agents 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 Agent abfragt. Dies umfasst USE CATALOG-, USE SCHEMA- und SELECT-Berechtigungen für die relevanten Unity-Katalogtabellen und -ansichten.

Umgebungsvariablen

Wenn Sie eine App mit einer Genie Agent-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 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?"
)

Weitere Informationen finden Sie unter Zugriff auf Umgebungsvariablen von Ressourcen.

Entfernen einer Genie Agent-Ressource

Wenn Sie eine Genie Agent-Ressource aus einer App entfernen, verliert der Dienstprinzipal der App den Zugriff auf den Agent. Der Genie Agent 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 Agents mit anderen App-Ressourcen

Kombinieren Sie Genie Agents mit anderen Databricks Apps-Ressourcen, um anspruchsvollere 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 Agent: 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 Agent: 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 die Integration mit anderen App-Ressourcen erfolgt:

  • CAN RUN auf dem Genie Agent
  • CAN USE im SQL-Warehouse (wenn ein separates anstelle des Genie Agent verwendet wird)
  • CAN QUERY auf Modellbereitstellungsendpunkten
  • USE CATALOG und USE SCHEMA bei relevanten Objekten im Unity Catalog
  • SELECT in Tabellen, die die App direkt abfragt

Bewährte Methoden

Befolgen Sie die folgenden bewährten Methoden, wenn Sie mit Genie Agent-Ressourcen arbeiten:

  • Erteilen Sie minimale Berechtigungen. Gewähren Sie nur Zugriff auf die bestimmten Genie Agents, die Ihre App zum Funktionieren benötigt.
  • Stellen Sie sicher, dass der Genie-Agent 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-Agents, 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-Agent an, um Die Reaktionszeiten zu optimieren.
  • Implementieren Sie die Fehlerbehandlung für Fälle, in denen der Genie-Agent Benutzerabfragen nicht effektiv interpretieren oder beantworten kann.
  • Last updated on