Condividi tramite

Aggiungere una risorsa spazio Genie a un'app Databricks

Aggiungere spazi di intelligenza artificiale/BI genie come risorse di Databricks Apps per abilitare l'esecuzione di query in linguaggio naturale nelle applicazioni. Gli spazi genie forniscono 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 query in linguaggio naturale da 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 spazio Genie

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

  1. Quando si crea o si modifica un'app, passare al passaggio Configura .
  2. Nella sezione Risorse dell'app fare clic su + Aggiungi risorsa.
  3. Selezionare Genie space come tipo di risorsa.
  4. Scegliere uno spazio Genie dall'elenco degli spazi disponibili nell'area di lavoro.
  5. Selezionare il livello di autorizzazione per l'app:
    • Può visualizzare: Concede all'app l'autorizzazione per leggere la configurazione e i metadati dello spazio Genie.
    • 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 dello spazio Genie.
    • Può gestire: Concede all'app l'accesso amministrativo completo allo spazio Genie.
  6. (Facoltativo) Specificare una chiave di risorsa personalizzata, che è il modo in cui si fa riferimento allo spazio Genie nella configurazione dell'app. La chiave predefinita è genie-space.

Quando si aggiunge una risorsa spazio Genie:

  • Azure Databricks concede all'entità servizio 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.

Annotazioni

L'entità servizio dell'app necessita anche delle autorizzazioni appropriate per le origini dati sottostanti eseguite dalle query dello spazio Genie. In genere sono incluse USE CATALOGle autorizzazioni , USE SCHEMAe SELECT per le tabelle e le viste del catalogo Unity pertinenti.

Variabili di ambiente

Quando si distribuisce un'app con una risorsa spazio Genie, Azure Databricks espone l'ID spazio tramite variabili di ambiente a cui è possibile fare riferimento usando il valueFrom campo nella app.yaml configurazione.

Configurazione di esempio:

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

Uso dell'ID spazio nell'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 spazio Genie

Quando si rimuove una risorsa spazio Genie da un'app, l'entità 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 spazi Genie con altre risorse dell'app

Combinare spazi 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:

  • Spazio 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:

  • Spazio genie: Genera la query iniziale e il contesto dati
  • Endpoint di gestione del modello: Restituisce riepiloghi e raccomandazioni generati dall'intelligenza artificiale
  • SQL Warehouse: Esegue query analitiche complesse

Autorizzazioni dell'entità servizio

Concedere all'entità servizio dell'app le autorizzazioni seguenti durante l'integrazione con altre risorse dell'app:

  • CAN RUN nello spazio Genie
  • 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 dello spazio Genie:

  • Concedere autorizzazioni minime. Fornire l'accesso solo agli spazi Genie specifici necessari per il funzionamento dell'app.
  • Assicurarsi che lo spazio Genie contenga set di dati e metadati ben curati per migliorare la qualità delle risposte alle query in linguaggio naturale.
  • Testare le query dell'app sullo spazio Genie 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 lo spazio Genie per ottimizzare i tempi di risposta.
  • Implementare la gestione degli errori per i casi in cui lo spazio Genie non può interpretare o rispondere alle query utente in modo efficace.
  • Last updated on