Aggiungere una risorsa Genie Space a un'app Databricks

Aggiungere Genie Spaces come risorse di Databricks Apps per abilitare l'esecuzione di query in linguaggio naturale nelle applicazioni. Genie Spaces offre 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 uno spazio 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 Space

Prima di aggiungere uno spazio 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 Space.
2. Scegliere uno spazio 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 di Genie Space.
   • Può essere eseguito: Concede all'app l'autorizzazione per inviare query allo spazio Genie e ricevere risposte.
   • Può modificare: Concede all'app l'autorizzazione per modificare la configurazione di Genie Space.
   • Può gestire: Concede all'app l'accesso amministrativo completo allo spazio Genie.
4. (Facoltativo) Specificare una chiave di risorsa personalizzata, che è il modo in cui si fa riferimento a Genie Space nella configurazione dell'app. La chiave predefinita è genie-space.

Quando si aggiunge una risorsa Genie Space:

• Azure Databricks fornisce al service principal dell'app le autorizzazioni specificate nello spazio Genie selezionato.
• L'app può inviare query in linguaggio naturale allo spazio e ricevere risposte strutturate con query e risultati SQL.
• L'app accede al contesto aziendale curato dello spazio, inclusi metadati, query di esempio e definizioni di dati.
• L'accesso è limitato allo spazio selezionato. L'app non può accedere ad altri Spazi Genie, a meno che non vengano aggiunti come risorse separate.

Variabili di ambiente

Quando si distribuisce un'app con una risorsa Genie Space, Azure Databricks espone l'ID spazio tramite variabili di ambiente a cui è possibile fare riferimento usando il campo valueFrom nella configurazione di 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 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?"
)

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

Rimuovere una risorsa Genie Space

Quando si rimuove una risorsa Genie Space da un'app, il principale del servizio dell'app perde l'accesso allo spazio. Lo spazio Genie rimane invariato e continua a essere disponibile per altri utenti e applicazioni con autorizzazioni appropriate.

Combinare Genie Spaces con altre risorse dell'app

Combinare Genie Spaces 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:

• Genie Space: Converte le domande degli utenti 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:

• Genie Space: 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 sulla piattaforma Genie Space
• CAN USE nel magazzino SQL (se si usa uno separato dallo spazio 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 Genie Space:

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