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 conversazionale 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à query sulla dashboard e su tutti i suoi riquadri collegati alle query. Puoi personalizzare gli agenti delle dashboard definite 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.

Dopo aver creato 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 alle query, per gli agenti delle dashboard definite dall'utente puoi personalizzare la configurazione dell'agente con contesto e istruzioni aggiuntivi.

Riepiloghi delle dashboard (anteprima)

Quando la funzionalità dei riepiloghi delle dashboard è abilitata, viene generato automaticamente un riepilogo della dashboard quando selezioni spark Chatta con questa dashboard. Il riepilogo viene visualizzato nella parte superiore della conversazione e fornisce quanto segue:

  • Una panoramica dei dati visualizzati nella dashboard
  • Dati principali in evidenza
  • Una breve interpretazione del significato dei dati

Per informazioni dettagliate su come abilitare questa funzionalità, consulta la pagina della documentazione Configurare l'Analisi conversazionale in Looker.

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. Seleziona Aggiorna per salvare le modifiche apportate 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 seleziona 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 seleziona 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. Nella scheda Editor puoi inserire le istruzioni dell'agente. Le istruzioni forniscono il contesto per aiutare l'Analisi conversazionale a comprendere come interagire con i dati e fornire risposte accurate e pertinenti. Seleziona Aggiorna per salvare le modifiche apportate 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
  • Query di riferimento: coppie di domande in linguaggio naturale e le relative query di Esplora
  • 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.

Definire una query di riferimento di Looker

Per definire ogni query di riferimento di Looker per una determinata domanda, fornisci i valori per entrambi i seguenti campi:

  • natural_language_questions: la domanda in linguaggio naturale che un utente potrebbe porre
  • looker_query: la query di riferimento di Looker che corrisponde alla domanda in linguaggio naturale

Per il campo natural_language_questions, considera le domande che un utente potrebbe porre su Esplora e scrivile in linguaggio naturale. Puoi includere più di una domanda nel valore di questo campo. Puoi ottenere il valore per il campo looker_query dai metadati della query di Esplora.

Le query di riferimento supportano i seguenti campi:

  • model (stringa): il modello LookML utilizzato per generare la query. Questo è un campo obbligatorio.
  • explore (stringa): l'esplorazione utilizzata per generare la query. Questo è un campo obbligatorio.
  • fields[] (stringa): i campi da recuperare da Esplora, incluse dimensioni e metriche. Questo è un campo facoltativo.
  • filters[] (stringa): i filtri da applicare a Esplora. Questo è un campo facoltativo.
  • sorts[] (stringa): l'ordinamento da applicare a Esplora. Questo è un campo facoltativo.
  • limit (stringa): il limite di righe di dati da applicare a Esplora. Questo è un campo facoltativo.

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 relative alle 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 Ragionamento. L'interfaccia utente descrive Veloce come modalità pensata per rispondere rapidamente e Ragionamento come modalità pensata per risolvere problemi complessi. L'Analisi conversazionale utilizza per impostazione predefinita la modalità di domanda Ragionamento. L'Analisi conversazionale manterrà la stessa modalità di domanda durante le conversazioni a più turni, 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 metrica 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à Ragionamento è pensata per richieste analitiche più complesse che richiedono un'analisi oltre le 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à Ragionamento 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 a più turni

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 relative alle domande.

Gestire le query all'interno di una conversazione

Quando conversi con i dati, puoi gestire la conversazione interrompendo una risposta a una 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 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 relativa risposta.

Comprendere i risultati e i calcoli delle query

L'Analisi conversazionale fornisce dettagli su come è stata interpretata la query.

Determinare come è stata interpretata la query

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

L'Analisi conversazionale analizza ogni query e pensa a come rispondere, utilizzando le parole chiave della query per dedurre le dimensioni, le metriche 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.

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 seleziona 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 seleziona 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, individua la conversazione che vuoi ripristinare o eliminare definitivamente. Seleziona il menu a tre puntini more_vert della conversazione e poi seleziona 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 delle dashboard dell'Analisi conversazionale presentano le seguenti limitazioni note:

  • L'analisi avanzata non è supportata per gli agenti delle dashboard.
  • Gli agenti delle dashboard eseguono query sulla modalità di produzione dei dati della dashboard.
  • Gli agenti delle dashboard non possono essere condivisi con altri utenti.
  • Gli agenti delle dashboard non sono supportati quando l'Analisi conversazionale è incorporata in un sito web o in un'applicazione.
  • Non puoi modificare il contesto o le istruzioni per gli agenti delle dashboard LookML.

Limitazioni relative alle 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 relative alle origini dati

L'Analisi conversazionale presenta le seguenti limitazioni relative alle 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 relative alle 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 correlazione e rilevamento di anomalie