Eseguire query su una dashboard con un agente dashboard

L'Analisi conversazionale, basata su Gemini per Google Cloud, ti consente di esaminare i dati ponendo domande in linguaggio colloquiale tramite un'interfaccia di chat intuitiva. Quando utilizzi l'Analisi conversazionale con una dashboard definita dall'utente o una dashboard LookML, l'Analisi conversazionale crea un agente di dati per te che è collegato alla dashboard. Mentre conversi con l'agente della dashboard, l'agente eseguirà una query sulla dashboard e su tutti i riquadri collegati alla query. Puoi personalizzare gli agenti della dashboard definiti dall'utente con contesto e istruzioni specifici per i dati della dashboard.

Questa pagina spiega come utilizzare l'Analisi conversazionale per interagire con i dati della dashboard. Vengono trattati i seguenti argomenti:

Prima di iniziare

Prima di poter utilizzare l'Analisi conversazionale per interagire con i dati della dashboard, assicurati che la configurazione e i requisiti per l'istanza di Looker siano soddisfatti e che ti siano state concesse le autorizzazioni appropriate per eseguire le attività descritte in questa pagina.

Avviare una conversazione da una dashboard di Looker

Per avviare una conversazione con un agente della dashboard da una dashboard definita dall'utente o da una dashboard LookML, seleziona spark Chatta con questa dashboard.

Se non disponi delle autorizzazioni sufficienti per chattare con la dashboard, Looker visualizza un errore.

Una volta creata una conversazione, puoi porre domande sui dati nel campo Fai una domanda all'interno della conversazione. Per accedere alle conversazioni recenti con l'agente della dashboard, seleziona more_vert Menu > Conversazioni recenti.

Oltre a porre domande all'agente della dashboard sui dati della dashboard o sui riquadri collegati alla query, per gli agenti della dashboard definiti dall'utente puoi personalizzare la configurazione dell'agente con contesto e istruzioni aggiuntivi.

Attivare o disattivare gli agenti della dashboard per una dashboard

Se gli agenti della dashboard sono abilitati per la tua istanza, sono abilitati per impostazione predefinita per tutte le dashboard definite dall'utente. Tuttavia, i creatori della dashboard possono controllare se gli utenti possono chattare con una dashboard definita dall'utente specifica attivando o disattivando l'impostazione dell'agente della dashboard a livello di singola dashboard.

Per attivare o disattivare un agente della dashboard per una dashboard definita dall'utente:

  1. Seleziona l'icona del menu more_vert Azioni della dashboard e poi seleziona edit Modifica dashboard.
  2. Fai clic su settings Impostazioni nella barra degli strumenti della dashboard.
  3. Nella finestra di dialogo Impostazioni, seleziona la scheda Generale.
  4. Attiva o disattiva il controllo Attiva la chat con la dashboard.
  5. Fai clic su Salva per salvare le modifiche alla dashboard.

Metadati delle conversazioni

Il riquadro Chatta con questa dashboard supporta le seguenti attività per ogni tipo di dashboard:

Dashboard definita dall'utente

  • Per porre una domanda sui dati della dashboard, inseriscila nel campo Fai una domanda.
  • Per modificare le informazioni sull'agente della dashboard, seleziona tune Gestisci agente. Nella scheda Editor, puoi inserire le istruzioni dell'agente ed espandere Opzioni avanzate per configurare impostazioni come Mostra pensiero e Mostra informazioni di debug. Seleziona Aggiorna per salvare le modifiche all'agente della dashboard. Utilizza la scheda Anteprima per visualizzare l'anteprima delle modifiche apportate all'agente della dashboard.
  • Per espandere il riquadro della conversazione dell'agente della dashboard, seleziona open_in_full Visualizza a schermo intero.
  • Per accedere alle conversazioni recenti con l'agente della dashboard, seleziona more_vert Menu > Conversazioni recenti.
  • Per impostazione predefinita, le conversazioni vengono denominate in base alla domanda iniziale. Per rinominare una conversazione, seleziona una conversazione dall'opzione del menu Conversazioni recenti , seleziona more_vert e poi edit Rinomina.
  • Per eliminare una conversazione con un agente di dati, seleziona more_vert Menu > delete Cestino.

Dashboard LookML

  • Per porre una domanda sui dati della dashboard, inseriscila nel campo Fai una domanda.
  • Per espandere il riquadro della conversazione dell'agente della dashboard, seleziona open_in_full Visualizza a schermo intero.
  • Per accedere alle conversazioni recenti con l'agente della dashboard, seleziona more_vert Menu > Conversazioni recenti.
  • Per impostazione predefinita, una conversazione viene denominata in base alla domanda iniziale. Per rinominare una conversazione, seleziona una conversazione dall'opzione del menu Conversazioni recenti , seleziona more_vert e poi edit Rinomina.
  • Per eliminare una conversazione con un agente di dati, seleziona more_vert Menu > delete Cestino.

Modificare l'agente della dashboard

Per modificare le informazioni sull'agente della dashboard, seleziona tune Gestisci agente.

Facoltativamente, puoi espandere Opzioni avanzate nella scheda Editor per configurare le seguenti impostazioni:

  • Mostra pensiero: attiva questa opzione per visualizzare i passaggi di ragionamento dell'agente, le query Looker generate e le tabelle di dati sottostanti nelle risposte.
  • Mostra informazioni di debug: attiva questa opzione per visualizzare i passaggi eseguiti da l'agente per ogni risposta per facilitare la risoluzione dei problemi.

Seleziona Aggiorna per salvare le modifiche all'agente della dashboard. Utilizza la scheda Anteprima per visualizzare l'anteprima delle modifiche apportate all'agente della dashboard.

Scrivere le istruzioni dell'agente

Puoi aggiungere istruzioni in formato libero che definiscono il comportamento principale dell'agente di dati e forniscono un contesto di base da considerare prima di elaborare il prompt di un utente.

Ecco alcuni esempi dei tipi di contesto che puoi fornire nel campo Istruzioni:

  • Campi chiave: i campi più importanti per l'analisi
  • Campi esclusi: campi che l'agente di dati deve evitare
  • Filtro e raggruppamento: campi che l'agente deve utilizzare per filtrare e raggruppare i dati
  • Persona: un ruolo o un'esperienza, un personaggio o un tono che assegni all'agente

Per suggerimenti e best practice per la scrittura delle istruzioni dell'agente, consulta la pagina della documentazione Best practice per la configurazione dell'Analisi conversazionale in Looker.

Porre domande sui dati di Looker

Quando inizi una nuova conversazione, l'Analisi conversazionale suggerisce alcune domande iniziali da porre. Le domande non devono avere un formato specifico o utilizzare una sintassi specifica. Tuttavia, devono essere correlate all'esplorazione selezionata.

Digita la domanda in linguaggio naturale nel campo Fai una domanda. Seleziona una modalità di domanda e fai clic su Invia. Dopo aver inviato la query, puoi annullare la risposta dell'Analisi conversazionale facendo clic su Interrompi risposta. L'Analisi conversazionale interrompe l'esecuzione della query e visualizza il seguente messaggio: The query was cancelled.

Per ulteriori indicazioni sui tipi di domande che puoi porre, consulta Limitazioni delle domande.

Selezionare una modalità di domanda

Quando poni una domanda, puoi selezionare la modalità di domanda da un menu a discesa che contiene le opzioni Veloce e Pensiero. L'interfaccia utente descrive Veloce come destinata a rispondere rapidamente e Pensiero come destinata a risolvere problemi complessi. L'Analisi conversazionale utilizza per impostazione predefinita la modalità di domanda Pensiero. L'Analisi conversazionale manterrà la stessa modalità di domanda durante le conversazioni multi-turno, a meno che tu non la modifichi manualmente.

Modalità veloce

Quando poni una domanda in modalità Veloce, l'Analisi conversazionale tenta di mappare direttamente la query in linguaggio naturale ai parametri LookML definiti nei modelli LookML sottostanti alla dashboard o alle esplorazioni della conversazione. L'Analisi conversazionale è in grado di rispondere rapidamente perché si basa sulle definizioni gestite di LookML e non utilizza né visualizza alcun tipo di ragionamento.

Ad esempio, una query come "Qual è stato il nostro fatturato totale il mese scorso?" può essere tradotta rapidamente in una query che seleziona la misura total_revenue e filtra per il mese precedente.

Seleziona la modalità Veloce se la query richiede fatti specifici o metriche predefinite dai dati.

Modalità di pensiero

La modalità Pensiero è destinata a richieste analitiche più complesse che richiedono un'analisi oltre alle ricerche LookML dirette. In questa modalità, l'agente "pianifica" il suo approccio, decidendo quali strumenti utilizzare e come combinare i risultati. Questa modalità consente di risolvere problemi in più passaggi ed eseguire attività di data science avanzate che potrebbero non essere possibili con una singola query basata su SQL.

Seleziona la modalità Pensiero quando chiedi perché dei tuoi dati, quando confronti le tendenze o quando fai richieste analitiche più complesse che potrebbero richiedere più passaggi. Questa modalità è particolarmente utile anche per testare un agente per capire come utilizza il codice LookML sottostante delle sue origini dati.

Conversazioni multi-turno

L'Analisi conversazionale terrà conto delle domande e delle risposte precedenti mentre continui la conversazione. Puoi utilizzare le risposte precedenti e basarti su di esse perfezionando ulteriormente i risultati o modificando il tipo di visualizzazione.

Per ulteriori indicazioni sulla creazione di domande, consulta Limitazioni delle domande.

Gestire le query all'interno di una conversazione

Quando conversi con i dati, puoi gestire la conversazione interrompendo una risposta alla query attiva durante l'esecuzione o eliminando la domanda e la risposta più recenti.

Eliminare la domanda più recente

Per eliminare la domanda e la risposta più recenti:

  1. Tieni il cursore sopra la domanda più recente e poi fai clic su Elimina messaggio.
  2. Nella finestra di dialogo Eliminare definitivamente il messaggio?, fai clic su Elimina per eliminare definitivamente la domanda e la risposta.

Comprendere i risultati e i calcoli delle query

L'Analisi conversazionale fornisce i seguenti parametri per comprendere i risultati e i calcoli delle query:

Determinare come è stata interpretata la query

Se utilizzi la modalità Pensieroper porre la domanda, puoi vedere come l'Analisi conversazionale ha ragionato sulla query. Per visualizzare il ragionamento, espandi l'opzione Mostra pensiero. Per nascondere il ragionamento, fai clic su Nascondi pensiero.

L'Analisi conversazionale analizza ogni query e pensa a come rispondere, utilizzando le parole chiave della query per dedurre le dimensioni, le misure e altri parametri pertinenti dal livello semantico dei set di dati associati alla conversazione e interpretando dalla query le aggregazioni che potrebbero essere necessarie. Quando espandi Mostra ragionamento, l'Analisi conversazionale visualizza una spiegazione in testo normale dei passaggi eseguiti per interpretare la query. La spiegazione include anche la durata durante la quale l'Analisi conversazionale ha pensato alla query.

Determinare come è stata calcolata una risposta

Per vedere come l'Analisi conversazionale ha ottenuto una risposta o creato una visualizzazione, fai clic su Come è stato calcolato? all'interno dei risultati della query.

Quando fai clic su Come è stato calcolato?, l'Analisi conversazionale visualizza una sezione Testo. La sezione Testo fornisce una spiegazione in testo normale dei passaggi eseguiti dall'Analisi conversazionale per ottenere la risposta fornita. Questa spiegazione include i nomi dei campi non elaborati utilizzati, i calcoli eseguiti, i filtri applicati, l'ordinamento e altri dettagli.

Dettagli analitici e informazioni di debug

Se l'agente di dati utilizzato per la conversazione ha opzioni avanzate specifiche abilitate, le risposte possono contenere i seguenti dettagli:

  • Mostra pensiero: se abilitata, la risposta dell'agente mostra i passaggi di ragionamento, le query Looker generate e i dati sottostanti.
  • Mostra informazioni di debug: se abilitata, la risposta dell'agente mostra i passaggi che sono stati eseguiti dall'agente per quella risposta, che possono essere utili per la risoluzione dei problemi.

Queste impostazioni vengono configurate nelle opzioni avanzate quando si modifica l'agente della dashboard.

Gestire le conversazioni

Ogni conversazione rimane nella sezione Conversazioni recenti del menu more_vert Menu della conversazione della dashboard. Puoi modificare i nomi delle conversazioni, eliminarle o ripristinarle dalla cartella Cestino.

  • Per accedere alle conversazioni recenti con l'agente della dashboard, seleziona more_vert Menu > Conversazioni recenti.
  • Per impostazione predefinita, le conversazioni vengono denominate in base alla domanda iniziale. Per rinominare una conversazione, seleziona una conversazione dall'opzione del menu Conversazioni recenti , seleziona more_vert e poi edit Rinomina.
  • Per eliminare una conversazione con un agente di dati, seleziona more_vert Menu > delete Cestino.

Eliminare una conversazione

Per eliminare una conversazione con un agente di dati, seleziona il menu a tre puntini more_vert della conversazione e poi delete Elimina.

Ripristinare o eliminare definitivamente una conversazione

Per ripristinare o eliminare definitivamente una conversazione dal Cestino:

  1. Seleziona more_vert Menu > delete Cestino.
  2. Nel riquadro Cestino, trova la conversazione che vuoi ripristinare o eliminare definitivamente. Seleziona il menu a tre puntini more_vert della conversazione e poi una delle seguenti opzioni:

    • Ripristina: ripristina la conversazione. Puoi accedere alla conversazione dall'opzione del menu Conversazioni recenti.
    • Elimina definitivamente: elimina definitivamente la conversazione.

Limitazioni note

Gli agenti della dashboard dell'Analisi conversazionale presentano le seguenti limitazioni note:

  • L'analisi avanzata non è supportata per gli agenti della dashboard.
  • Gli agenti della dashboard eseguono query sulla modalità di produzione dei dati della dashboard.
  • Gli agenti della dashboard ereditano il modello di condivisione della dashboard; l'accesso all'agente è regolato dall'accesso alla dashboard sottostante.
  • Non puoi modificare il contesto o le istruzioni per gli agenti della dashboard LookML.

Limitazioni delle visualizzazioni

L'Analisi conversazionale utilizza Vega-lite per la generazione di grafici di conversazione. I seguenti tipi di grafici Vega sono completamente supportati:

  • Grafico a linee (una o più serie)
  • Grafico ad area
  • Grafico a barre (orizzontale, verticale, in pila)
  • Grafico a dispersione (uno o più gruppi)
  • Grafico a torta

I seguenti tipi di grafici Vega sono supportati, ma potresti riscontrare un comportamento imprevisto durante il rendering:

  • Maps
  • Mappe di calore
  • Grafici con descrizioni comando

I tipi di grafici che non rientrano nel catalogo Vega non sono supportati. Tutti i grafici non specificati in questa sezione sono considerati non supportati.

Limitazioni delle origini dati

L'Analisi conversazionale presenta le seguenti limitazioni delle origini dati:

  • L'Analisi conversazionale può restituire un massimo di 5000 righe per query.
  • L'Analisi conversazionale non può impostare il valore di un campo solo con filtri definito utilizzando i parametri LookML parameter o filter.

Limitazioni delle domande

L'Analisi conversazionale supporta le domande a cui è possibile rispondere con una singola visualizzazione, ad esempio:

  • Tendenze delle metriche nel tempo
  • Suddivisione o distribuzione di una metrica per dimensione
  • Valori univoci per una o più dimensioni
  • Valori di una singola metrica
  • Valori delle dimensioni principali per metrica

L'Analisi conversazionale non supporta ancora le domande a cui è possibile rispondere solo con i seguenti tipi di visualizzazioni complesse:

  • Previsione e previsione
  • Analisi statistica avanzata, inclusi rilevamento di correlazioni e anomalie