Eseguire query su una dashboard definita dall'utente 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, 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 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 definita dall'utente. 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 di aver ricevuto 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, seleziona spark Chatta con questa dashboard.

Se non hai autorizzazioni sufficienti per chattare con la dashboard, Looker mostra 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 alle 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 attivati per la tua istanza, sono attivati 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 le dashboard definite 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 ragionamento 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 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.

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

  • Attiva Analisi avanzata: attiva questa impostazione per consentire all'agente di utilizzare Analisi avanzata, che traduce le domande in linguaggio naturale in codice Python ed esegue il codice per fornire analisi e visualizzazioni avanzate. Questa impostazione è visibile solo se l'impostazione di amministrazione Analisi avanzata è attivata nella pagina di amministrazione Gemini in Looker per la tua istanza.
  • Mostra ragionamento: attiva questa opzione per consentire all'agente di visualizzare i passaggi di ragionamento, le query Looker generate e le tabelle di dati sottostanti in tutte le risposte di ogni conversazione.
  • Mostra informazioni di debug: attiva questa opzione per consentire all'agente di visualizzare i passaggi eseguiti per tutte le risposte di ogni conversazione.

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 istruzioni per l'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
  • Ruolo: un ruolo o un'esperienza, un carattere 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 mostra 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 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 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 tuoi dati.

Modalità di pensiero

La modalità Ragionamento è pensata per 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à 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 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 prendere 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 relativa 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à Ragionamento per porre la domanda, puoi vedere come l'Analisi conversazionale ha ragionato sulla query. Per vedere 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 misure e gli 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 mostra 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 mostra 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 attivate, le risposte possono contenere i seguenti dettagli:

  • Mostra ragionamento: se attivata, la risposta dell'agente mostra i passaggi di ragionamento, le query Looker generate e i dati delle tabelle sottostanti.
  • Mostra informazioni di debug: se attivata, la risposta dell'agente mostra i passaggi che sono stati eseguiti dall'agente per quella risposta, il che può essere utile 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 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. È possibile accedere alla conversazione dall'opzione del menu Conversazioni recenti.
    • Elimina definitivamente: elimina definitivamente la conversazione.