Genie Agents con dashboard

I dashboard pubblicati includono un agente Genie per impostazione predefinita per consentire agli utenti aziendali di esplorare i dati usando il linguaggio naturale. Un agente Genie è un'interfaccia senza codice che fornisce un pulsante Ask Genie nei dashboard pubblicati, consentendo ai visualizzatori di chattare con i dati invece di basarsi solo su visualizzazioni predefinite. Il pulsante Ask Genie è disponibile per i visualizzatori sia nell'area di lavoro che quando i dashboard vengono incorporati usando l'incorporamento di base. Consulta Genie Agents.

Quando si pubblica il dashboard, l'interruttore Abilita Genie è attivato per impostazione predefinita e Databricks genera automaticamente un agente Genie in base ai set di dati e alle visualizzazioni del dashboard. In alternativa, è possibile collegarsi a un agente Genie esistente o disattivare l'interruttore per disabilitare Genie.

Gli agenti genie complementari usano i concetti degli agenti Genie, che consentono a Genie di ragionare su più passaggi e origini dati per rispondere a domande complesse.

Per altre informazioni sugli agenti Genie, vedere Genie Agents.For more information about Genie Agents, see Genie Agents.

Annotazioni

Ask Genie è disponibile solo nel basic embedding. Ask Genie non è supportato in Ask Genie non è disponibile nell'incorporamento esterno. Per gli scenari di incorporamento esterni, usare l'API Genie Conversation per integrare le funzionalità di query in linguaggio naturale.

Controlla l'accesso al Genie Agent della tua dashboard

Per abilitare o configurare un agente Genie per il dashboard pubblicato:

  1. Aprire il dashboard.
  2. Nel pannello destro fare clic su Impostazioni. In alternativa, fare clic sull'icona del menu Kebab. Il menu > kebab Impostazioni per aprire le impostazioni.
  3. Fare clic su Generale.
  4. L'interruttore Enable Genie è attivato per impostazione predefinita. Disattivare l'interruttore se si vuole disabilitare l'agente Genie per i visualizzatori del dashboard.
  5. (Facoltativo) Per collegare un agente Genie esistente, selezionare il pulsante di opzione Collega agente Genie esistente e incollare l'URL associato. Se non si seleziona questa opzione, Databricks genera automaticamente un nuovo agente Genie basato sul dashboard quando si pubblica.

GIF che mostra una finestra di chat Genie aperta in un dashboard pubblicato. L'utente pone una domanda e Genie risponde con una tabella dei risultati.

Importante

Quando i visualizzatori usano Genie, le loro domande vengono risposte dai risultati completi della query del set di dati. Se una query del set di dati include colonne o righe sensibili, tali dati diventano disponibili per Genie anche se non vengono visualizzati nelle visualizzazioni. Definire i set di dati in modo da includere solo i campi e le righe a cui si vuole accedere gli utenti. Vedere Autorizzazioni per gli agenti Genie.

Annotazioni

Gli agenti Companion Genie non compaiono nel browser file o nella pagina dell’elenco di Genie. Quando si ripubblica il dashboard con le modifiche, l'agente Genie associato viene aggiornato automaticamente per riflettere i nuovi set di dati e visualizzazioni.

Apri l'Agente Genie

Per aprire l'agente Genie pubblicato in una nuova finestra:

  1. Fare clic sull'icona del menu Kebab. Menu kebab nell'angolo in alto a destra della finestra di chat
  2. Fare clic su Apri agente Genie.

Annotazioni

Non è possibile modificare le istruzioni per gli agenti Genie generati automaticamente dall'interfaccia utente dell'agente Genie. L'agente Genie viene aggiornato quando si ripubblica il dashboard con le modifiche.

Chiedere a Genie informazioni su un grafico specifico

Per chiedere a Genie informazioni su un grafico dashboard specifico:

  1. Fare clic su Ask Genie da un dashboard pubblicato con funzionalità Genie.
  2. Fare clic su un grafico dashboard per selezionarlo. Genie visualizza il titolo del grafico selezionato nella finestra della chat.
  3. Porre domande sui dati rappresentati nel grafico selezionato.

Chiedere a Genie di spiegare le modifiche del grafico

È possibile chiedere a Genie di spiegare le modifiche direttamente dal grafico per le visualizzazioni a barre, a linee e a area per serie temporali (inclusi grafici multi-serie e impilati), celle di tabella pivot, grafici a barre orizzontali, grafici a torta e heatmap. Genie entra in modalità agente per analizzare la modifica e identificare i principali driver.

Per spiegare una modifica del grafico:

  1. Fare clic su Ask Genie da un dashboard pubblicato con funzionalità Genie.
  2. Fare clic con il pulsante destro del mouse su una visualizzazione supportata.
  3. Selezionare l'opzione per chiedere a Genie di spiegare la modifica.

Genie analizza la modifica selezionata e restituisce una spiegazione con i principali fattori che contribuiscono.

Autorizzazioni per gli agenti Genie

Le autorizzazioni dipendono dal fatto che l'agente Genie sia stato generato automaticamente o collegato.

Gli agenti Genie generati automaticamente seguono il modello di credenziali del dashboard:

  • Se il dashboard usa credenziali incorporate (autorizzazione dati condivisi), l'agente Genie usa anche le credenziali incorporate. Genie usa le credenziali dell'editore per accedere ai dati, in modo che i visualizzatori possano interagire con Genie anche se non hanno accesso diretto ai dati sottostanti.
  • Se il dashboard usa le credenziali del visualizzatore, l'agente Genie usa anche le credenziali del visualizzatore. Si applicano le autorizzazioni di accesso ai dati di ogni visualizzatore.

Gli agenti Genie collegati usano sempre le impostazioni delle credenziali configurate nell'agente Genie stesso. Le impostazioni delle credenziali del dashboard non hanno alcun effetto su un agente Genie collegato.

In ogni caso, gli utenti devono essere membri dell'area di lavoro per interagire con gli agenti Genie. Per altre informazioni sui tipi di accesso, vedere Gestire il dashboard e l'accesso Genie.

Modificare la descrizione dell'agente Genie del dashboard

Databricks genera automaticamente una descrizione basata sul contenuto del dashboard. È possibile modificare la descrizione in qualsiasi momento.

Per modificare la descrizione:

  1. Apri Genie Agent.
  2. Fare clic su Configura.
  3. Fare clic sull'icona a forma di matita. L'icona di modifica accanto a Descrizione.
  4. Immettere o modificare la descrizione e fare clic su Salva.

Espressioni SQL incompatibili

Gli agenti Genie collegati non possono usare set di dati contenenti le espressioni SQL seguenti:

  • Clausola identifier con una stringa non costante, come nell'esempio seguente.

    SELECT * FROM identifier(:param)
    
  • Viste temporanee o funzioni in set di dati con più istruzioni, come nell'esempio seguente.

    CREATE OR REPLACE TEMPORARY VIEW taxis AS SELECT * FROM samples.nyctaxis.trips;
    
    SELECT * FROM taxis;
    
  • Riferimento a un volume in SQL che definisce il set di dati, come nell'esempio seguente.

    SELECT * FROM csv.`/Volumes/catalog/schema/volume/my-data.csv`
    

Annotazioni

Se solo alcuni set di dati nella dashboard usano espressioni non supportate, Ask Genie usa i set di dati supportati e ignora quelli non supportati invece di restituire un errore. Ad esempio, se un dataset utilizza IDENTIFIER() o un'UDF, Ask Genie continua a rispondere alle domande basate sugli altri dataset supportati.

OpenSharing

I set di dati condivisi con OpenSharing non sono supportati negli agenti Genie che usano credenziali incorporate (autorizzazione per i dati condivisi). OpenSharing usa un sistema di credenziali non compatibile con la delega delle credenziali di Genie. Per usare questi set di dati con Genie, usare le credenziali del visualizzatore anziché le credenziali incorporate.

Limitazioni

  • Ask Genie non è supportato nell'incorporamento esterno. Per gli scenari di incorporamento esterni, usare l'API Genie Conversation. Consulta Ask Genie non è disponibile nell'integrazione esterna.
  • Non è possibile modificare le istruzioni per gli agenti Genie generati automaticamente dall'interfaccia utente dell'agente Genie.
  • Companion Genie Agents supporta fino a 30 set di dati del dashboard. Se il dashboard usa più di 30 set di dati, nell'agente Genie sono inclusi solo 30.
  • I filtri del dashboard non vengono inseriti nel contesto della chat quando si usa un agente Genie collegato. I filtri dashboard funzionano come previsto con gli agenti Genie generati automaticamente.
  • Ask Genie ignora i set di dati che contengono clausole identificative con stringhe non costanti, viste o funzioni temporanee oppure riferimenti a volumi e risponde attingendo ai restanti set di dati supportati. Vedere Espressioni SQL incompatibili.
  • I set di dati condivisi con OpenSharing non sono supportati negli agenti Genie che usano credenziali incorporate. Vedere OpenSharing.
  • Le visualizzazioni generate da Genie One utilizzano titoli in testo semplice, perché non puoi modificare una visualizzazione generata. In un Genie Agent, il titolo di un widget generato supporta il testo arricchito dopo aver modificato e salvato il titolo o la descrizione. Vedi dove la formattazione non viene applicata.