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 fornisce un singolo agente predefinito condiviso collegato alla dashboard. Tutti gli utenti con l'autorizzazione a chattare con la dashboard conversano con questo agente condiviso. Mentre conversi con l'agente della dashboard, l'agente esegue query sulla dashboard e su tutti i riquadri collegati alle query. Gli utenti con autorizzazioni di modifica sulla dashboard possono personalizzare l'agente predefinito con contesto e istruzioni specifici per i dati della dashboard, il che aggiorna il comportamento dell'agente per tutti gli utenti che eseguono query sulla 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 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, seleziona spark Chatta con questa dashboard.

Se non disponi di 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 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 Azioni della dashboard more_vert e poi seleziona Modifica dashboard edit.
  2. Fai clic su Impostazioni settings 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 della conversazione

Il riquadro Chatta con questa dashboard supporta le seguenti attività per le dashboard definite dall'utente:

  • Per porre una domanda sui dati della dashboard, inserisci una domanda nel campo Fai una domanda.
  • Per modificare le informazioni sull'agente della dashboard, seleziona Regola agente tune. Nella scheda Editor, puoi inserire le istruzioni dell'agente ed espandere Opzioni avanzate per configurare impostazioni come Mostra il 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 all'agente della dashboard.
  • Per espandere il riquadro della conversazione dell'agente della dashboard, seleziona open_in_full Visualizza 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 Regola agente tune.

(Facoltativo) 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 Amministrazione Gemini in Looker per la tua istanza.
  • Mostra il 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 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. (La query è stata annullata).

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 seguenti opzioni:

  • Veloce (impostazione predefinita): ideale per la maggior parte delle domande.
  • **Ragionamento**: ragionamento dettagliato. **Ragionamento**: ragionamento dettagliato.

L'Analisi conversazionale utilizza per impostazione predefinita la modalità di domanda Veloce. 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

La modalità Veloce è consigliata per la maggior parte delle domande ed è selezionata per impostazione predefinita. In modalità Veloce, l'Analisi conversazionale mappa la query in linguaggio naturale direttamente ai parametri LookML definiti nei modelli LookML sottostanti alla dashboard o alle esplorazioni della conversazione. L'Analisi conversazionale risponde rapidamente senza spendere token aggiuntivi per il ragionamento o i riepiloghi dei pensieri in streaming nella chat.

Le query in modalità Veloce forniscono lo stesso livello di accuratezza delle query in modalità Ragionamento. Utilizza la modalità Veloce per le tue domande, a meno che tu non voglia vedere in modo specifico il processo di ragionamento dell'agente.

Modalità di ragionamento

In modalità Ragionamento, l'agente spende token aggiuntivi per riflettere sulla richiesta e trasmette in streaming un riepilogo dei pensieri direttamente nella chat durante l'elaborazione della query, fornendoti visibilità sui passaggi di ragionamento dettagliati dell'agente.

Sebbene la modalità Ragionamento non produca risposte più accurate rispetto alla modalità Veloce , la visualizzazione del ragionamento dell'agente ti consente di osservare come l'Analisi conversazionale interpreta la query, pianifica i passaggi analitici e fa riferimento ai modelli LookML sottostanti.

Seleziona la modalità Ragionamento se vuoi esaminare i passaggi di ragionamento dettagliati dell'agente o testare il modo in cui un agente interagisce con le tue origini dati e vuoi spendere i token aggiuntivi necessari per il ragionamento.

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 svilupparle 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 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 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 visualizzare il ragionamento, espandi l'opzione Mostra il ragionamento. Per nascondere il ragionamento, fai clic su Nascondi il 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 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 il ragionamento, l'Analisi conversazionale visualizza una spiegazione in testo normale dei passaggi eseguiti per interpretare la query. La spiegazione include anche la durata del ragionamento dell'Analisi conversazionale sulla 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 attivate, le risposte possono contenere i seguenti dettagli:

  • Mostra il ragionamento: se attivata, la risposta dell'agente mostra i passaggi di ragionamento, le query Looker generate e le tabelle di dati 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 durante la modifica dell'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 con 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 > Cestino delete.
  2. Nel riquadro Cestino, trova la conversazione che vuoi ripristinare o eliminare definitivamente. Seleziona il menu con 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.