Utilizzare uno spazio di IA/BI Genie

Importante

Questa funzionalità è disponibile in anteprima pubblica. Vedere Abilitare gli spazi Genie nell’area di lavoro.

Panoramica

Esperti di dominio, ad esempio analisti di dati, configurano spazi Genie con set di dati, query di esempio e linee guida per il testo per aiutare Genie a tradurre le domande aziendali in query analitiche. Dopo la configurazione, gli utenti aziendali possono fare domande e generare visualizzazioni per comprendere i dati operativi. È possibile aggiornare continuamente le conoscenze semantiche di Genie man mano che i dati cambiano e gli utenti pongono nuove domande. Per altre informazioni su DatabricksIQ, consultare Funzionalità basate su DatabricksIQ.

AI/BI Genie seleziona i nomi e le descrizioni pertinenti da tabelle e colonne con annotazioni per convertire domande in linguaggio naturale in una query SQL equivalente. Risponde quindi con la query generata e la tabella dei risultati, se possibile. Se Genie non riesce a generare una risposta, può porre domande di completamento per chiarire quando tenta di fornire una risposta.

Caso d'uso di esempio

È possibile creare spazi genie diversi per servire diversi destinatari non tecnici. Gli scenari seguenti descrivono due possibili casi d’utilizzo.

Esempio 1: Visualizzare lo stato dell’opportunità

Un responsabile vendite vuole ottenere lo stato corrente delle opportunità aperte e chiuse per fase nella pipeline di vendita. Possono interagire con lo spazio Genie usando il linguaggio naturale e generare automaticamente una visualizzazione.

La gif seguente mostra questa interazione:

Esempio 2: Logistica di rilevamento

Una società di logistica vuole utilizzare spazi Genie per aiutare gli utenti aziendali di diversi reparti a tenere traccia dei dettagli operativi e finanziari. Hanno istituito uno spazio Genie per i responsabili delle strutture di spedizione per tenere traccia delle spedizioni e un altro per i dirigenti finanziari per comprendere la loro salute finanziaria.

Requisiti tecnici e limiti

Quando si usano spazi Genie, si applicano i requisiti e i limiti seguenti:

• Catalogo unity: i dati per lo spazio Genie devono essere registrati nel catalogo unity
• Calcolo: è necessario usare un sql warehouse pro o serverless.
• Capacità dell'area di lavoro: ogni area di lavoro può avere fino a 1.000 spazi Genie.

Autorizzazioni necessarie

Per creare, modificare e utilizzare spazi Genie sono necessarie le autorizzazioni seguenti:

• Autorizzazioni di calcolo: creatori di spazi genie, editor e utenti richiedono l’accesso CAN USE al warehouse SQL predefinito designato per lo spazio. I creatori selezionano il data warehouse SQL predefinito quando creano uno spazio. Possono selezionare qualsiasi SQL warehouse per cui dispongono delle autorizzazioni CAN RUN.
• Autorizzazioni di accesso ai dati: qualsiasi utente che interagisce con lo spazio necessita di almeno SELECT privilegi sui dati usati in uno spazio.
• Autorizzazioni dello spazio genie: gli utenti devono disporre delle autorizzazioni CAN RUN nello spazio Genie per interagire con Genie e i dati usati nello spazio. Per un mapping completo dei privilegi e delle capacità per uno spazio Genie, vedere ACL di spazio genie.

Nota

La configurazione dei dati e dell’accesso di calcolo richiede autorizzazioni elevate in genere limitate a un amministratore. Vedere Creare un’istanza di SQL Warehouse e Gestire i privilegi nel Catalogo Unity.

Abilitare gli spazi Genie nell’area di lavoro

Nota

Per abilitare questa funzionalità, è necessario disporre di privilegi elevati.

Genie usa le funzionalità di intelligenza artificiale basate su intelligenza artificiale di Azure che devono essere abilitate a livello di account e nell’area di lavoro in cui vengono creati gli spazi Genie. Per abilitare gli spazi Genie, verificare ognuna delle impostazioni seguenti.

• Le funzionalità basate sui servizi di intelligenza artificiale di Azure devono essere abilitate a livello di account. Un amministratore dell’account può abilitare questa funzionalità seguendo questa procedura:
  1. Nella barra laterale della console dell’account, cliccare Impostazioni.
  2. Fare clic sulla scheda Abilitazione funzionalità.
  3. Attivare l’opzione Abilita funzionalità basate su servizi di intelligenza artificiale di Azure.

Le funzionalità basate sui servizi di intelligenza artificiale di Azure devono essere abilitate a livello di account prima di poter essere abilitate a livello di area di lavoro.

• Per l’area di lavoro è necessario abilitare le funzionalità dei servizi di Azure basati su IA. Un amministratore dell’area di lavoro può abilitare questa funzionalità seguendo questa procedura:

  1. Passa all’area di lavoro.
  2. Fare clic sul nome utente nella barra superiore dell’area di lavoro di Azure Databricks e selezionare Impostazioni.
  3. Fare clic sulla scheda Avanzate e scorrere verso il basso fino alla sezione Altro .
  4. Attivare l’opzione Funzionalità basate su servizi di intelligenza artificiale di Azure.

• Genie deve essere abilitato dalla pagina Anteprime dell'area di lavoro. Un amministratore dell’area di lavoro può abilitare questa anteprima. Vedere Gestire le anteprime di Azure Databricks.

  

Fare clic su Crea uno spazio Genie

Quando gli spazi Genie sono abilitati in un’area di lavoro, gli analisti dei dati possono creare un’esperienza di spazio Genie specifica del dominio per gli utenti aziendali seguendo questa procedura:

1. Fare clic su Genie nella barra laterale.

2. Nell’angolo superiore destro della schermata fare clic su Salva modifiche.

   

3. Nella finestra di dialogo Nuovo scegliere le impostazioni iniziali. Sono descritte come segue:

• Titolo: il titolo viene visualizzato nel browser dell’area di lavoro con altri oggetti dell’area di lavoro. Scegliere un titolo che consentirà agli utenti finali di individuare lo spazio Genie.
• Descrizione: gli utenti visualizzano la descrizione quando aprono lo spazio Genie. Utilizzare questa area di testo per descrivere lo scopo degli spazi.
• Warehouse predefinito: questa risorsa di calcolo supporta le istruzioni SQL generate negli spazi Genie. Gli utenti finali devono accedere a questo magazzino per interagire con lo spazio. Uno spazio Genie può utilizzare un data warehouse SQL pro o serverless. Per ottenere prestazioni ottimali, Databricks consiglia di utilizzare un SQL warehouse serverless.
• Tabelle: gli spazi Genie possono essere basati su una o più tabelle. Il pulsante Aggiungi tabelle apre una nuova finestra di dialogo in cui è possibile selezionare le tabelle del catalogo Unity da includere.
• Domande di esempio: le domande di esempio sono facoltative. Vengono visualizzati nelle chat per fornire esempi dei tipi di domande che gli utenti possono porre. Possono essere aggiunti durante la creazione o versioni successive dalle impostazioni dello spazio.

Quali dati è necessario utilizzare?

È possibile creare nuovi spazi Genie in base a una o più tabelle gestite del catalogo Unity. AI/BI Genie usa i metadati collegati agli oggetti del catalogo Unity per generare risposte. I set di dati con annotazioni ben annotate, abbinati a istruzioni specifiche fornite, sono fondamentali per creare un’esperienza positiva per gli utenti finali.

Databricks consiglia quanto segue:

• Curare i dati per l’utilizzo analitico: le visualizzazioni livello per ridurre il numero di colonne e aggiungere informazioni specifiche del caso d’utilizzo per aumentare la qualità della risposta.
• Ridurre al minimo il numero di tabelle e colonne in uno spazio Genie: inserire solo le tabelle e le colonne necessarie per rispondere alle domande per un determinato dominio. Le tabelle o le colonne non necessarie possono causare la generazione di risposte confuse o errate da parte di Genie o la visualizzazione di un messaggio di errore.

Fornire indicazioni

Le istruzioni consentono di guidare le risposte di Genie in modo che possa elaborare il gergo, la logica e i concetti univoci in un determinato dominio. Le istruzioni complete sono fondamentali per un’esperienza spaziale Genie intuitiva e senza problemi. Per immettere le istruzioni, fare clic su Istruzioni nella barra laterale genia per aprire il riquadro istruzioni. Utilizzare questo riquadro per aggiungere istruzioni generali, query SQL di esempio e funzioni SQL.

Istruzioni generali

Fornire istruzioni di testo normale che comunicano chiaramente le preferenze aziendali o di risposta per Genie da seguire. È possibile formattare le istruzioni come una singola nota completa o classificarle in base agli argomenti per una migliore organizzazione.

Di seguito è riportato un esempio di informazioni che è possibile includere nelle istruzioni generali:

• Informazioni aziendali specifiche dell’azienda:
  • "Il nostro anno fiscale inizia a febbraio"
• Valori, alias o filtri comuni:
  • "Convertire sempre in minuscolo e utilizzare un operatore like quando si applicano filtri".
  • "Utilizzare le abbreviazioni per gli stati nei valori di filtro".
• Specificare le funzioni per rispondere alle domande e fornire istruzioni per i valori restituiti:
  • “Per i trimestri utilizzare la funzione definita dall'utente adventureworks.oneb.get_quarter(date) . L’output di get_quarter() è il trimestre e è 1,2,3 o 4. Utilizzare questa opzione per filtrare i dati in base alle esigenze.

Query SQL di esempio

Le query SQL di esempio sono query SQL preparate per eseguire il training di Genie. Quando si risponde alle domande, Genie seleziona in modo intelligente le query pertinenti per generare la risposta. Quando si aggiungono query di esempio, si mostra in modo efficace Genie come usare i dati per rispondere alle domande. È anche possibile aggiungere domande di esempio per insegnare a Genie i tipi di domande a cui ci si aspetta che la query di esempio risponda. Se Genie riceve una domanda corrispondente, può usare direttamente la query di esempio per fornire una risposta. Se ottiene una domanda simile, può usare indizi della query di esempio per strutturare il codice SQL fornito nella risposta. Concentrarsi sulla fornitura di esempi che evidenziano la logica univoca per l’organizzazione e i dati, come nell’esempio seguente:

  -- Return our current total open pipeline by region.
  -- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = 'Pipeline' AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

Aggiungere parametri nelle query SQL

I parametri consentono di scrivere query di esempio che includono segnaposto per i valori specifici da sostituire in fase di esecuzione. Con i parametri, Genie può accettare input specifici dalle domande dell’utente e riutilizzare la struttura di una query di esempio per fornire risposte verificate come asset attendibili. Ad esempio, è possibile modificare la query SQL precedente in modo da includere un parametro che filtra in base al o.forecastcategory valore, consentendo alla query di risolvere le domande sulle opportunità contrassegnate in categorie di previsione diverse. Per altre informazioni su come utilizzare query con parametri per generare repons etichettati come asset attendibili, vedere Usare asset attendibili in spazi di IA/BI Genie.

Il frammento di codice seguente mostra l’esempio precedente, modificato aggiungendo un parametro per il o.forecastcategory valore . I parametri usano la stessa sintassi dei marcatori di parametro denominati. Vedere Marcatori di parametri denominati.

-- Return our current pipeline at a stage by region.
-- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = :forecast_category AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

Per aggiungere un parametro di query:

1. Posizionare il cursore in cui posizionare il parametro nella query.

2. Fare clic su Aggiungi parametro per aggiungere un nuovo parametro.

   Verrà creato un nuovo parametro con il nome parameterpredefinito . Per modificare il nome predefinito, sostituirlo nell’editor di query. È anche possibile aggiungere parametri digitando i due punti seguiti da un nome di parametro (:parameter_name) nell’editor.

Aggiungere un parametro di query

Per modificare un parametro, eseguire le operazioni seguenti:

1. Fare clic accanto al nome del parametro. Viene visualizzata una finestra di dialogo Dettagli parametro che include le opzioni di configurazione seguenti:

   • Parola chiave: parola chiave che rappresenta il parametro nella query. Questa operazione può essere modificata solo aggiornando direttamente il testo nella query.

   • Nome visualizzato: nome leggibile usato da Genie nell’esperienza di chat. Quando Genie usa una query con parametri per generare una risposta, include il nome visualizzato e il valore associato nella risposta.

   • Tipo: i tipi supportati includono String, Date, Date and Time e Numeric.

     • Il valore predefinito è il tipo di stringa.
     • Il tipo di dati Numeric consente di specificare tra Decimal e Integer. Il tipo numerico predefinito è Decimal.

     Nota

     Se il valore di input effettivo non corrisponde al tipo di parametro selezionato, Genie considera il valore di input come tipo non corretto, che può causare risultati imprecisi.

2. Fare clic su un’altra parte dell’interfaccia utente per chiudere la finestra di dialogo.

Funzioni SQL

Le funzioni SQL sono funzioni personalizzate archiviate nel catalogo unity e usate da Genie per rispondere a domande specifiche. Genie può chiamare queste funzioni e inserire qualsiasi parametro specificato dall’utente, ma non può accedere al contenuto SQL sottostante. Ciò significa che le funzioni SQL sono ideali per rispondere a domande specifiche comuni che includono argomenti complessi o calcoli che Genie non deve essere in grado di accedere o modificare. Per indicazioni sulla registrazione di una funzione nel catalogo Unity, vedere Creare una funzione di tabella SQL e funzioni definite dall’utente (UDF) nel catalogo Unity.

Asset attendibili

Quando viene usato il testo esatto di una query di esempio con parametri o di una funzione SQL per generare una risposta, Genie contrassegna la risposta come asset attendibile. Gli asset attendibili sono concepiti per trasmettere un ulteriore livello di garanzia nell’accuratezza di un risultato a un utente dello spazio. Vedere Utilizzare asset attendibili in spazi di IA/BI Genie.

Chat nello spazio Genie

La maggior parte delle interazioni con lo spazio Genie avviene in una finestra di chat.

Una nuova finestra di chat include un set curato di domande di esempio. Queste domande di esempio aiutano gli utenti a capire quali domande possono porre al loro spazio Genie. Il campo di testo, in cui gli utenti inserisce domande, si trova nella parte inferiore della schermata.

Le risposte vengono visualizzate sopra il campo di testo. Dopo che un utente immette una domanda, viene salvato in un thread della cronologia delle chat nel riquadro sinistro.

Cronologia chat

I thread della cronologia delle chat vengono salvati per ogni utente in modo che possano fare riferimento a domande e risposte precedenti. Gli utenti possono anche inviare di nuovo o rivedere le domande da un thread di chat. Il pulsante Nuova chat nel riquadro sinistro avvia un nuovo thread.

Ogni thread di chat mantiene il contesto relativo alle domande precedenti poste. In questo modo gli utenti possono porre domande di completamento per esplorare o rielaborare un set di risultati.

Risposta strutturata

La struttura di risposta precisa varia in base alla domanda. Spesso, le risposte includono una spiegazione in linguaggio naturale e una tabella che mostra il set di risultati pertinente. Tutte le risposte includono la query SQL generata per rispondere alla domanda. Fare clic su Mostra codice generato per visualizzare la query generata.

Il lato inferiore destro della risposta include azioni facoltative. È possibile copiare il file CSV della risposta negli Appunti, scaricarlo come file CSV, aggiungerlo come istruzione per lo spazio Genie e richiamare o disattivare la risposta.

Un set di riquadri Azioni rapide segue le risposte che includono dati tabulari. È possibile usarli per generare visualizzazioni.

È anche possibile generare una visualizzazione descrivendola in parole dopo aver ottenuto un risultato della query.

Fornire commenti e suggerimenti sulla risposta

Ogni risposta IA/BI Genie include un pulsante di feedback thumbs-up o thumbs-down. Databricks consiglia agli utenti di incoraggiare gli utenti a fornire commenti e suggerimenti sullo spazio usando questo meccanismo.

Per una risposta che include i risultati della query, gli utenti possono richiedere che venga esaminato da un editor di spazi Genie facendo clic su . Se un utente ha domande sulla qualità o l’accuratezza di una risposta generata, può contrassegnarla per la revisione e, facoltativamente, aggiungere il commento o la domanda.

Gli utenti aziendali possono visualizzare gli aggiornamenti alle domande contrassegnate per la revisione nella pagina Cronologia . Gli utenti con almeno l’autorizzazione CAN MANAGE per lo spazio Genie possono esaminare lo scambio specifico, commentare la richiesta e confermare o correggere la risposta. Possono accedere ai commenti e suggerimenti ed esaminare le richieste nella pagina di monitoraggio. È quindi possibile utilizzare il feedback per ottimizzare le risposte e scorrere lo spazio. Vedere Esaminare la cronologia e il feedback.

Esaminare la cronologia e il feedback

Uno spazio Genie è progettato per essere uno strumento di collaborazione continuo per i team di dati e gli utenti aziendali per accumulare conoscenze, non una distribuzione monouso. Comprendere le nuove domande a cui gli utenti aziendali hanno bisogno di risposte è essenziale per la creazione di conoscenze. Nella pagina della cronologia è possibile visualizzare singole domande e risposte, commenti e suggerimenti personali forniti dagli utenti e domande contrassegnate per la revisione. Per aprire la pagina della cronologia, fare clic su Cronologia nella barra laterale genia.

La pagina della cronologia mostra tutte le domande e le risposte che sono state poste nello spazio. È possibile filtrare le domande in base al tempo, alla classificazione, all’utente o allo stato. Monitorando lo spazio, gli editor di spazi Genie possono comprendere in modo proattivo le query generate dagli utenti aziendali e il modo in cui lo spazio Genie ha risposto.

Identificando le domande con cui Genie lotta, è possibile aggiornare lo spazio Genie con istruzioni specifiche per migliorare le risposte. Fare clic su una domanda per aprire il testo della domanda e della risposta. È anche possibile accedere al thread di chat completo da questa visualizzazione.

Modifica Genera firma di accesso condiviso

È possibile esaminare e modificare il codice SQL generato in qualsiasi risposta. Gli autori di spazi genie in genere conoscono il dominio e i dati che consentono loro di riconoscere quando Genie genera una risposta errata. Spesso, gli errori possono essere corretti con una piccola quantità di ottimizzazione manuale per la query SQL generata. Per visualizzare il codice SQL generato per qualsiasi risposta, fare clic su Mostra codice generato per esaminare la query.

È possibile modificare l’istruzione SQL generata per correggerla se si dispone di privilegi CAN EDIT o maggiori per lo spazio Genie. Dopo aver apportato le correzioni, eseguire la query. Quindi, è possibile salvarlo come un’istruzione per insegnare a Genie come rispondere in futuro. Per salvare la query modificata, fare clic su Salva come istruzione.

Valutare le risposte con benchmark

I benchmark consentono di aumentare le prestazioni di test e valutazione delle singole risposte in uno spazio Genie. A differenza delle istruzioni, i benchmark sono destinati a valutare, non informare, lo spazio Genie. Genie non usa domande di benchmark o SQL di esempio per migliorare il contesto di Genie.

Utilizzando i benchmark, è possibile eseguire una raccolta di domande di test e usare le risposte per misurare l’accuratezza di Genie. Facoltativamente, è possibile includere un'istruzione SQL che restituisce i risultati previsti. Quando viene eseguita la domanda di benchmark, la risposta di Genie viene confrontata con i risultati forniti dall'istruzione SQL e con un punteggio per l'accuratezza. Se non è stata fornita alcuna risposta SQL, la domanda viene contrassegnata per la revisione.

Vedere Usare i benchmark in uno spazio Genie.

Condividere uno spazio Genie

Importante

Gli utenti dello spazio Genie devono utilizzare le proprie credenziali per accedere ai dati. Qualsiasi domanda sui dati a cui non è possibile accedere genera una risposta vuota.

Gli utenti dello spazio Genie devono disporre delle autorizzazioni CAN USE per il magazzino collegato a uno spazio Genie e le autorizzazioni di accesso per gli oggetti del Catalogo Unity esposti nello spazio. Vedere Quali dati utilizzare?.

I nuovi spazi Genie vengono salvati nella cartella utente per impostazione predefinita. Analogamente ad altri oggetti dell’area di lavoro, ereditano le autorizzazioni dalla cartella contenitore. È possibile utilizzare la struttura di cartelle dell’area di lavoro per condividerle con altri utenti. Vedere Organizzare gli oggetti dell’area di lavoro in cartelle.

È anche possibile specificare determinati utenti o gruppi da condividere con a un determinato livello di autorizzazione: CAN MANAGE, CAN EDIT, CAN RUN e CAN VIEW.

Per condividere con utenti o gruppi specifici:

1. Fare clic su Condividi.
2. Immettere utenti o gruppi con cui condividere lo spazio. Fare quindi clic su Aggiungi e impostare i livelli di autorizzazione appropriati.
3. Utilizzare il pulsante “Copia collegamento” nella parte inferiore della finestra di dialogo Condividi per ottenere un collegamento condivisibile allo spazio Genie. Gli utenti con privilegi possono fare clic sul collegamento per aprire lo spazio Genie in una nuova scheda e porre domande.

Clonare uno spazio Genie

La clonazione di uno spazio Genie crea una copia, incluse tutte le istruzioni e il contesto di installazione. Ciò è utile se si dispone di uno spazio ben sviluppato e si vuole creare un nuovo spazio per test aggiuntivi o riutilizzare il contesto dallo spazio originale. Dopo la clonazione di uno spazio, il nuovo spazio è indipendente dall'originale, consentendo di apportare modifiche e modifiche senza influire sull’originale.

Gli elementi seguenti vengono copiati in uno spazio Genie clonato:

• Aggiungi impostazioni modificabili
• Istruzioni generali
• Query SQL di esempio
• Funzioni SQL

I thread di chat esistenti e i dati della cronologia non vengono copiati nel nuovo spazio.

Per clonare uno spazio Genie, eseguire le operazioni seguenti:

1. Aprire lo spazio Genie da clonare.
2. Fare clic sul menu kebab nell’angolo superiore destro del dashboard.
3. Fare clic su Clona.
4. (Facoltativo) Nella finestra di dialogo Clona specificare un nuovo nome e un nuovo percorso della cartella dell’area di lavoro per lo spazio Genie clonato.
5. Fare clic su Clona per creare il nuovo spazio.

Privacy e sicurezza

D: Quale modello usa Genie?

Genie usa il modello OpenAI di Azure.

D: Quali dati vengono inviati al modello?

Gli spazi genie generano risposte alle domande in linguaggio naturale usando metadati e istruzioni. Genie non ha accesso ai dati a livello di riga.

Per elaborare le risposte, Genie usa quanto segue:

• Richiesta del linguaggio naturale inviata dall'utente
• Nomi e descrizioni delle tabelle
• Titoli e descrizioni delle colonne
• Istruzioni generali
• Query SQL di esempio
• Funzioni SQL

D: Azure OpenAI raccoglie i dati?

No. Databricks ha optato per l'esenzione dal monitoraggio degli abusi e dal programma di revisione umana, in cui Microsoft non archivia richieste e completamenti inviati al servizio OpenAI di Azure. Per altre informazioni, vedere la documentazione di Microsoft.

Procedure consigliate per la preparazione dello spazio

• Prima di compilare, stabilire un set di domande ben definite a cui si vuole che gli utenti dello spazio siano in grado di rispondere.
• Testare lo spazio Genie per controllare la qualità della risposta. Provare a eseguire le operazioni seguenti per verificare se il modello fornisce la risposta prevista:
  • Riformula le domande fornite.
  • Porre altre domande relative ai set di dati.
• Aggiungere e perfezionare le istruzioni dello spazio Genie fino a quando le domande non forniscono la risposta prevista.

Per altre indicazioni sulle procedure consigliate e sull’assistenza per la risoluzione dei problemi, vedere Curare uno spazio genie efficace.