Een Genie Agent-resource toevoegen aan een Databricks-app

Voeg Genie Agents toe als Databricks Apps-resources om query's in natuurlijke taal in uw toepassingen mogelijk te maken. Genie Agents bieden een gespreksinterface voor gegevensverkenning, zodat gebruikers zakelijke vragen kunnen stellen in het Engels en op SQL gebaseerde inzichten kunnen ontvangen van uw gecureerde gegevenssets.

Wanneer u een Genie Agent als resource toevoegt, kan uw app het volgende doen:

  • Query's in natuurlijke taal van gebruikers converteren naar SQL
  • Vooraf geconfigureerde zakelijke context en metagegevens openen
  • Gecureerde voorbeeldquery's en gegevensdefinities gebruiken
  • Antwoorden genereren op basis van de gegevenssets van uw organisatie

Een Genie Agent-resource toevoegen

Voordat u een Genie Agent als resource toevoegt, controleert u de vereisten voor app-resources.

  1. Klik in de sectie App-resources wanneer u een app maakt of bewerkt op + Resource>Genie Agent toevoegen.
  2. Kies een Genie Agent in de lijst met beschikbare ruimten in uw werkruimte.
  3. Selecteer het machtigingsniveau voor uw app:
    • Kan bekijken: Verleent de app toestemming om de configuratie en metagegevens van de Genie-agent te lezen.
    • Kan worden uitgevoerd: Verleent de app toestemming om query's naar de Genie-agent te verzenden en antwoorden te ontvangen.
    • Kan bewerken: Verleent de app toestemming om de Configuratie van de Genie-agent te wijzigen.
    • Kan het volgende beheren: Verleent de app volledige beheerderstoegang tot de Genie Agent.
  4. (Optioneel) Geef een aangepaste resourcesleutel op. Dit is de wijze waarop u in uw app-configuratie naar de Genie-agent verwijst. De standaardsleutel is genie-space.

Wanneer u een Genie Agent-resource toevoegt:

  • Azure Databricks verleent de service-principal van uw app de opgegeven machtigingen voor de geselecteerde Genie-agent.
  • De app kan query's in natuurlijke taal verzenden naar de agent en gestructureerde antwoorden ontvangen met SQL-query's en -resultaten.
  • De app heeft toegang tot de gecureerde bedrijfscontext van de agent, waaronder metagegevens, voorbeeldquery's en gegevensdefinities.
  • Toegang is alleen beperkt tot de geselecteerde agent. Uw app heeft geen toegang tot andere Genie Agents, tenzij u ze toevoegt als afzonderlijke resources.

Opmerking

De service-principal van de app heeft ook de juiste machtigingen nodig voor de onderliggende gegevensbronnen waarop de Genie Agent query's uitvoert. Dit omvat doorgaans USE CATALOG, USE SCHEMA en SELECT toegangsrechten voor de relevante Unity Catalog-tabellen en -weergaven.

Omgevingsvariabelen

Wanneer u een app met een Genie Agent-resource implementeert, Azure Databricks de ruimte-id beschikbaar maakt via omgevingsvariabelen waarnaar u kunt verwijzen met behulp van het valueFrom veld in uw app.yaml configuratie.

Voorbeeldconfiguratie:

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

Gebruik de spatie-id in uw toepassing:

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

Zie Toegang tot omgevingsvariabelen vanuit resources voor meer informatie.

Een Genie Agent-resource verwijderen

Wanneer u een Genie Agent-resource uit een app verwijdert, heeft de service-principal van de app geen toegang meer tot de agent. De Genie Agent zelf blijft ongewijzigd en blijft beschikbaar voor andere gebruikers en toepassingen met de juiste machtigingen.

Genie Agents combineren met andere app-resources

Combineer Genie Agents met andere Databricks Apps-resources om geavanceerdere gegevenstoepassingen te maken. Veelvoorkomende integratiepatronen zijn:

Analysedashboard voor natuurlijke taal

Gebruik de volgende resources samen om interactieve analyses uit te voeren:

  • Genie Agent: Converteert gebruikersvragen naar SQL-query's
  • SQL Warehouse: Voert de query's uit en retourneert resultaten voor visualisatie
  • Geheimen: API-sleutels voor externe visualisatiehulpprogramma's opslaan

Voorbeeldconfiguratie:

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

AI-verbeterde bedrijfsintelligentie

Gebruik de volgende resources om te integreren met AI-modellen:

  • Genie Agent: Hiermee worden de eerste query en gegevenscontext gegenereerd
  • Modelbedieningseindpunt: Geeft door AI gegenereerde samenvattingen en aanbevelingen terug
  • SQL Warehouse: Voert complexe analytische query's uit

Machtigingen voor service-principal

Verdeel de service-principal van uw app de volgende machtigingen bij het integreren met andere app-resources:

  • CAN RUN op de Genie Agent
  • CAN USE op het SQL-warehouse (als u een afzonderlijk SQL-warehouse gebruikt in plaats van de Genie Agent)
  • CAN QUERY op eindpunten voor modelleringstoepassing
  • USE CATALOG en USE SCHEMA op relevante Unity Catalog-objecten
  • SELECT op tabellen waarop de app rechtstreeks opdrachten uitvoert

Beste praktijken

Volg deze aanbevolen procedures wanneer u met Genie Agent-resources werkt:

  • Minimale machtigingen verlenen. Geef alleen toegang tot de specifieke Genie Agents die uw app nodig heeft om te functioneren.
  • Zorg ervoor dat de Genie-agent goed samengestelde gegevenssets en metagegevens bevat om de kwaliteit van queryreacties in natuurlijke taal te verbeteren.
  • Test de query's van uw app op de Genie-agent om te controleren of deze nauwkeurige resultaten kan genereren voor verwachte gebruikersvragen.
  • Bewaak de queryprestaties en pas de interactiepatronen van uw app aan met de Genie-agent om reactietijden te optimaliseren.
  • Implementeer foutafhandeling voor gevallen waarin de Genie-agent gebruikersquery's niet effectief kan interpreteren of erop kan reageren.
  • Last updated on