Aggiungere una risorsa Genie Agent a un'app Databricks

Aggiungere Genie Agents come risorse di Databricks Apps per abilitare l'esecuzione di query in linguaggio naturale nelle applicazioni. Genie Agents fornisce un'interfaccia di conversazione per l'esplorazione dei dati, consentendo agli utenti di porre domande aziendali in inglese normale e ricevere informazioni dettagliate basate su SQL dai set di dati curati.

Quando si aggiunge un agente Genie come risorsa, l'app può:

• Convertire le query in linguaggio naturale degli utenti in SQL
• Accedere ai metadati e al contesto aziendale preconfigurato
• Usare query e definizioni di dati di esempio curate
• Generare risposte in base ai set di dati dell'organizzazione

Aggiungere una risorsa Genie Agent

Prima di aggiungere un agente Genie come risorsa, esaminare i prerequisiti delle risorse dell'app.

1. Nella sezione Risorse dell'app quando si crea o si modifica un'app fare clic su + Aggiungi risorsa>Genie Agent.
2. Scegliere un agente Genie dall'elenco degli spazi disponibili nell'area di lavoro.
3. Selezionare il livello di autorizzazione per l'app:
   • Può visualizzare: Concede all'app l'autorizzazione per leggere la configurazione e i metadati dell'agente Genie.
   • Può essere eseguito: Concede all'app l'autorizzazione per inviare query all'agente Genie e ricevere risposte.
   • Può modificare: Concede all'app l'autorizzazione per modificare la configurazione dell'agente Genie.
   • Può gestire: Concede all'app l'accesso amministrativo completo all'agente Genie.
4. (Facoltativo) Specificare una chiave di risorsa personalizzata, che è il modo in cui si fa riferimento all'agente Genie nella configurazione dell'app. La chiave predefinita è genie-space.

Quando aggiungi una risorsa Genie Agent:

• Azure Databricks concede all'entità servizio dell'app le autorizzazioni specificate per l'agente Genie selezionato.
• L'app può inviare query in linguaggio naturale all'agente e ricevere risposte strutturate con query e risultati SQL.
• L'app accede al contesto aziendale curato dell'agente, inclusi metadati, query di esempio e definizioni di dati.
• L'accesso è limitato all'agente selezionato. L'app non può accedere ad altri agenti Genie, a meno che non vengano aggiunti come risorse separate.

Variabili di ambiente

Quando distribuisci un'app con una risorsa Genie Agent, Azure Databricks espone l'ID dello spazio tramite variabili di ambiente a cui puoi fare riferimento utilizzando il campo valueFrom nella configurazione app.yaml.

Configurazione di esempio:

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

Uso dell'ID dello spazio nella tua applicazione.

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

Per altre informazioni, vedere Accedere alle variabili di ambiente dalle risorse.

Rimuovi una risorsa Genie Agent

Quando si rimuove una risorsa di Genie Agent da un'app, l'entità servizio dell'app perde l'accesso all'agente. L'agente Genie rimane invariato e continua a essere disponibile per altri utenti e applicazioni con autorizzazioni appropriate.

Combinare agenti Genie con altre risorse dell'app

Combinare agenti Genie con altre risorse di Databricks Apps per creare applicazioni dati più sofisticate. I modelli di integrazione comuni includono:

Dashboard di analisi del linguaggio naturale

Usare insieme le risorse seguenti per eseguire analisi interattive:

• Agente Genie: Converte le domande utente in query SQL
• SQL Warehouse: Esegue le query e restituisce i risultati per la visualizzazione
• Segreti: Archivia le chiavi API per gli strumenti di visualizzazione esterni

Configurazione di esempio:

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

Business Intelligence avanzata dall'intelligenza artificiale

Usare le risorse seguenti per l'integrazione con i modelli di intelligenza artificiale:

• Agente Genie: Genera la query iniziale e il contesto dei dati
• Endpoint di gestione del modello: Restituisce riepiloghi e raccomandazioni generati dall'intelligenza artificiale
• SQL warehouse: Esegue query analitiche complesse

Autorizzazioni del principale del servizio

Concedere al principal di servizio dell'app le seguenti autorizzazioni quando si integrano con altre risorse dell'app:

• CAN RUN sull'agente Genie
• CAN USE nel magazzino SQL (se si usa uno separato dall'agente Genie)
• CAN QUERY nel modello che gestisce gli endpoint
• USE CATALOG e USE SCHEMA sugli oggetti del catalogo Unity pertinenti
• SELECT nelle tabelle direttamente le query dell'app

Procedure consigliate

Seguire queste procedure consigliate quando si lavora con le risorse dell'agente Genie:

• Concedere autorizzazioni minime. Fornire l'accesso solo agli agenti Genie specifici necessari per il funzionamento dell'app.
• Assicurarsi che Genie Agent contenga set di dati e metadati ben curati per migliorare la qualità delle risposte alle query in linguaggio naturale.
• Testare le query dell'app sull'agente Genie per verificare che possa generare risultati accurati per le domande degli utenti previste.
• Monitorare le prestazioni delle query e modificare i modelli di interazione dell'app con l'agente Genie per ottimizzare i tempi di risposta.
• Implementare la gestione degli errori per i casi in cui l'agente Genie non può interpretare o rispondere alle query utente in modo efficace.