Analizzare i dati con le conversazioni

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

Nota: per fornire un feedback o richiedere assistenza per questa funzionalità, invia un'email all'indirizzo [e-mail].

Questo documento descrive come creare, modificare ed eliminare le conversazioni in BigQuery. Le conversazioni sono chat persistenti con un agente dati o origini dati, come tabelle o viste, che selezioni.

Puoi porre agli agenti dei dati domande in più parti che utilizzano termini comuni, ad esempio "vendite" o "più popolare", senza specificare i nomi dei campi della tabella o definire condizioni per filtrare i dati. La risposta della chat fornisce la risposta alla tua domanda sotto forma di testo e codice e genera immagini e grafici, se necessario. La risposta include il ragionamento alla base dei risultati.

Puoi creare una conversazione con un agente dati o una conversazione diretta con una o più tabelle. Quando crei una conversazione diretta, l'API Conversational Analytics interpreta la tua domanda senza il contesto e le istruzioni di elaborazione offerte da un agente dati.

Prima di iniziare

1. Verify that billing is enabled for your Google Cloud project.

2. Enable the BigQuery, Gemini Data Analytics, and Gemini for Google Cloud APIs.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

Ruoli obbligatori

Per creare conversazioni, devi disporre di uno dei seguenti ruoli IAM dell'API Conversational Analytics:

• Per visualizzare e creare conversazioni con qualsiasi data agent condiviso con te, devi disporre del ruolo Utente di Gemini Data Analytics Data Agent (roles/geminidataanalytics.dataAgentUser) e del ruolo Utente di Gemini in Google Cloud (roles/cloudaicompanion.user) a livello di progetto.
• Per creare una conversazione diretta, devi disporre del ruolo Gemini Data Analytics Stateless Chat User (roles/geminidataanalytics.dataAgentStatelessUser).

Inoltre, nelle seguenti situazioni devi disporre dei seguenti ruoli:

• Se un agente dati utilizza una tabella di dati come fonte di conoscenza, devi disporre del ruolo Visualizzatore dati BigQuery (roles/bigquery.dataViewer) per quella tabella.
• Se una tabella di dati utilizza il controllo dell'accesso a livello di colonna, devi disporre del ruolo Lettore granulare (roles/datacatalog.categoryFineGrainedReader) per il tag di criteri appropriato. Per saperne di più, consulta Ruoli utilizzati con il controllo dell'accesso a livello di colonna.
• Se una tabella di dati utilizza il controllo dell'accesso a livello di riga, devi disporre della policy di accesso a livello di ruolo per quella tabella. Per saperne di più, consulta Creare o aggiornare policy di accesso a livello di riga.
• Se una tabella dati utilizza la mascheratura dei dati, devi disporre del ruolo Lettore mascherato (roles/bigquerydatapolicy.maskedReader) per i criteri dei dati appropriati. Per ulteriori informazioni, consulta Ruoli per l'esecuzione di query sui dati mascherati.

Se non disponi dei ruoli appropriati nelle tabelle dei dati di origine utilizzate dall'agente dei dati, il sistema restituisce il seguente errore quando interagisci con l'agente dei dati:

Schema_Resolution: Access Denied

Best practice

Quando utilizzi l'analisi conversazionale, le query vengono eseguite automaticamente per rispondere alle tue domande. Potresti incorrere in addebiti imprevisti nei seguenti casi:

• Se le tabelle sono grandi
• Se le query utilizzano unioni di dati
• Se le query effettuano molte chiamate alle funzioni AI

Per evitare questo problema, considera le dimensioni quando selezioni le fonti di conoscenza e, quando fai conversazioni, valuta la possibilità di utilizzare i join.

crea conversazioni

Puoi creare conversazioni persistenti con un agente o con un'origine dati nella console Google Cloud per BigQuery nei seguenti modi:

• Nella scheda Catalogo agenti della pagina Agenti.
• Quando visualizzi una tabella o i risultati di una query.
• Quando il sistema utilizza automaticamente l'origine dati selezionata per la conversazione. Questa pratica è utile per domande rapide e una tantum su una tabella specifica.

Crea una conversazione con un agente dati

Per creare una conversazione con un agente dati, devi prima creare un agente dati e pubblicarlo. Puoi anche avviare una conversazione con gli agenti che altri condividono con te.

Per creare una conversazione con un agente dati nella console Google Cloud , seleziona una delle seguenti opzioni:

Pagina Agenti

1. Vai alla pagina Agenti di BigQuery.

   Vai ad Agenti

2. Seleziona la scheda Catalogo agenti.

3. Nella sezione I miei agenti o Condivisi da altri utenti della tua organizzazione, fai clic sulla scheda dell'agente con cui vuoi chattare.

4. Fai clic su Avvia una conversazione. Si apre un nuovo riquadro della chat.

5. Nel campo Fai una domanda, inserisci una domanda per l'agente di dati. Ad esempio, "Quali sono state le nostre vendite totali nell'ultimo trimestre?" o "Mostrami i 5 utenti principali in base alla durata della sessione". Per iniziare, puoi anche fare clic su una delle domande suggerite da Gemini.

   L'agente di dati risponde indicando l'azione che sta intraprendendo per rispondere alla tua domanda e poi restituisce i risultati.

   Per visualizzare ogni passaggio eseguito dall'agente di dati per fornire la risposta alla tua domanda, fai clic su Mostra ragionamento per visualizzare ogni messaggio nella procedura di ragionamento dell'agente.

   

   Per visualizzare informazioni su come sono stati calcolati i risultati, fai clic su Come è stato calcolato?

   La sezione Riepilogo ora include una query generata seguita dal risultato della query. Se vuoi, puoi aprire il codice nell'editor di query.

   

   Quando appropriato per i dati, l'agente dati fornisce immagini, grafici, tabelle e altre visualizzazioni.

   Per visualizzare la cronologia delle chat, consulta l'elenco Gestione conversazioni.

   Per visualizzare le informazioni sull'agente, consulta il riquadro Dettagli agente. Questo riquadro include una descrizione dell'agente e delle sue fonti di conoscenza.

Editor BigQuery

1. Quando lavori con una tabella o esegui una query, fai clic sul pulsante Crea conversazione nella barra dei menu per creare una nuova conversazione.

2. Nel campo Fai una domanda, inserisci una domanda per l'agente di dati. Ad esempio, "Quali sono state le nostre vendite totali nell'ultimo trimestre?" o "Mostrami i 5 utenti principali in base alla durata della sessione". Per iniziare, puoi anche fare clic su una delle domande suggerite da Gemini.

   L'agente di dati risponde indicando l'azione che sta intraprendendo per rispondere alla tua domanda e poi restituisce i risultati.

   Per visualizzare ogni passaggio eseguito dall'agente di dati per fornire la risposta alla tua domanda, fai clic su Mostra ragionamento per visualizzare ogni messaggio nella procedura di ragionamento dell'agente.

   

   Per visualizzare informazioni su come sono stati calcolati i risultati, fai clic su Come è stato calcolato?

   La sezione Riepilogo ora include una query generata seguita dal risultato della query. Se vuoi, puoi aprire il codice nell'editor di query.

   

   Quando appropriato per i dati, l'agente dati fornisce immagini, grafici, tabelle e altre visualizzazioni.

   Per visualizzare la cronologia delle chat, consulta l'elenco Gestione conversazioni.

   Per visualizzare le informazioni sull'agente, consulta il riquadro Dettagli agente. Questo riquadro include una descrizione dell'agente e delle sue fonti di conoscenza.

Creare una conversazione diretta con un'origine dati

Per creare una conversazione con un'origine dati nella console Google Cloud , seleziona una delle seguenti opzioni:

Pagina Agenti

Per creare una conversazione diretta con un'origine dati dalla pagina Agenti:

1. Vai alla pagina Agenti di BigQuery.

   Vai ad Agenti

2. Nella scheda Conversazioni, nel riquadro Chatta con i tuoi dati, fai clic su Origini dati.

3. Seleziona una o più tabelle e fai clic su Crea conversazione.

4. Nel campo Fai una domanda, inserisci una domanda per l'agente di dati. Puoi anche fare clic su una delle domande suggerite da Gemini per iniziare.

   L'API Conversational Analytics elabora la domanda e restituisce i risultati.

   Per visualizzare i passaggi eseguiti dall'API Conversational Analytics, fai clic su Mostra motivazione per visualizzare ogni messaggio nel processo di ragionamento dell'API.

   

   Per visualizzare informazioni su come sono stati calcolati i risultati, fai clic su Come è stato calcolato?

   La sezione Riepilogo ora include una query generata seguita dal risultato della query. Se vuoi, puoi aprire la query nell'editor di query.

   

   Quando appropriato per i dati, la risposta fornisce immagini, grafici, tabelle e altre visualizzazioni.

Editor BigQuery

1. Quando lavori con una tabella o esegui una query, fai clic sul pulsante Crea conversazione nella barra dei menu per creare una nuova conversazione.

2. Nel campo Fai una domanda, inserisci una domanda per l'agente di dati. Puoi anche fare clic su una delle domande suggerite da Gemini per iniziare.

   L'API Conversational Analytics elabora la domanda e restituisce i risultati.

   Per visualizzare i passaggi eseguiti dall'API Conversational Analytics, fai clic su Mostra motivazione.

   Per visualizzare ogni passaggio eseguito dall'agente dei dati per fornire la risposta alla tua domanda, fai clic su Mostra motivazione. dall'elenco e visualizza ogni messaggio nella procedura di ragionamento dell'agente.

   

   Per visualizzare informazioni su come sono stati calcolati i risultati, fai clic su Come è stato calcolato?

   La sezione Riepilogo ora include la query generata seguita dal risultato della query. Se vuoi, puoi aprire la query nell'editor di query.

   

   Quando appropriato per i dati, la risposta fornisce immagini, grafici, tabelle e altre visualizzazioni.

Creare un agente di dati da una conversazione

1. Nel riquadro Dati di una conversazione, nella sezione Azioni rapide, fai clic su Crea agente.
2. Segui i passaggi per creare un agente.

Gestire le conversazioni

Puoi aprire, rinominare o eliminare una conversazione nella pagina Agenti e gestire le conversazioni in BigQuery Studio Explorer.

Aprire una conversazione esistente

1. Nella console Google Cloud , vai alla pagina Agenti di BigQuery.

   Vai ad Agenti

2. Nella scheda Conversazioni, nell'elenco delle conversazioni, fai clic sulla conversazione che vuoi aprire.

Rinominare una conversazione

1. Nella console Google Cloud , vai alla pagina Agenti di BigQuery.

   Vai ad Agenti

2. Nella scheda Conversazioni, nell'elenco delle conversazioni, fai clic sulla conversazione da rinominare.

3. Fai clic su Visualizza azioni > Rinomina.

4. Nella finestra di dialogo Rinomina conversazione, inserisci un nuovo nome per la conversazione nel campo Nome conversazione.

5. Fai clic su Rinomina.

Eliminare una conversazione

1. Nella console Google Cloud , vai alla pagina Agenti di BigQuery.

   Vai ad Agenti

2. Nella scheda Conversazioni, nell'elenco delle conversazioni, fai clic sulla conversazione che vuoi eliminare.

3. Fai clic su Visualizza azioni > Elimina.

4. Nella finestra di dialogo Eliminare la conversazione?, fai clic su Elimina.

Gestire le conversazioni utilizzando BigQuery Studio Explorer

Gestisci le conversazioni utilizzando BigQuery Studio Explorer. Questo elenco di conversazioni fornisce una posizione centrale per cercare, aprire o creare conversazioni. Puoi anche copiare l'ID conversazione o aggiornare l'elenco delle conversazioni.

Per gestire le tue conversazioni:

1. Vai alla pagina Explorer di BigQuery Studio.

   Vai a Explorer

2. Nel riquadro Explorer, espandi il nome di un progetto.

3. Fai clic su Conversazioni.

   1. Per filtrare l'elenco delle conversazioni, inserisci il nome o il valore di una proprietà nel campo filtro.
   2. Per aprire una conversazione, fai clic su Visualizza azioni > Apri.
   3. Per copiare un ID conversazione, fai clic su Visualizza azioni > Copia ID.
   4. Per creare una conversazione, fai clic su Crea conversazione nella barra dei menu.
   5. Per aggiornare l'elenco, fai clic su Aggiorna nella barra dei menu.

Località

L'analisi conversazionale opera a livello globale, quindi non puoi scegliere la regione da utilizzare.

Passaggi successivi

• Scopri di più sull'analisi conversazionale in BigQuery.
• Scopri di più sull'API Conversational Analytics.
• Crea agenti dati.