Analizzare i dati con le conversazioni

Anteprima

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

Nota: per fornire feedback o richiedere assistenza per questa funzionalità, invia un'email all'indirizzare [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 dati domande in più parti che utilizzano termini comuni, ad esempio "vendite" o "più popolari", senza specificare i nomi dei campi della tabella o definire condizioni per filtrare i dati. Un agente può determinare le origini dati su cui eseguire query e sfruttare le ottimizzazioni, come le partizioni di tabella, quando crea una risposta. La risposta della chat contiene la risposta alla tua domanda come testo e codice e include il ragionamento alla base dei risultati. La risposta può includere anche immagini e grafici, se appropriato.

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

Prima di iniziare

1. Verifica che la fatturazione sia attivata per il tuo Google Cloud progetto.

2. Abilita BigQuery, Gemini Data Analytics e Gemini for Google Cloud APIs.

   Ruoli richiesti per abilitare le API

   Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin), che contiene l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

   Abilita le API

Ruoli obbligatori

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

• Per visualizzare e creare conversazioni con qualsiasi agente dati condiviso con te, devi disporre del ruolo Utente agente dati Gemini Data Analytics (roles/geminidataanalytics.dataAgentUser) e del ruolo Utente Gemini per Google Cloud (roles/cloudaicompanion.user) a livello di progetto.
• Per creare una conversazione diretta, devi disporre del ruolo Utente chat stateless Gemini Data Analytics (roles/geminidataanalytics.dataAgentStatelessUser).

Inoltre, nelle seguenti situazioni, devi disporre dei seguenti ruoli:

• Se un agente dati utilizza una tabella di dati come origine di conoscenza, devi disporre del ruolo Visualizzatore dati BigQuery (roles/bigquery.dataViewer) nella tabella.
• Se una tabella di dati utilizza il controllo dell'accesso a livello di colonna, devi disporre del ruolo Lettore granulare (roles/datacatalog.categoryFineGrainedReader) nel tag di criteri appropriato. Per ulteriori informazioni, 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 row-level access control, devi disporre della policy di accesso a livello di ruolo role-level access policy nella tabella. Per ulteriori informazioni, consulta Creare o aggiornare le policy di accesso a livello di riga.
• Se una tabella di dati utilizza la maschera dei dati, devi disporre del ruolo Lettore con maschera (roles/bigquerydatapolicy.maskedReader) nella policy dei dati appropriata. Per ulteriori informazioni, consulta Ruoli per l'esecuzione di query sui dati mascherati.

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

Schema_Resolution: Access Denied

Best practice

L'analisi conversazionale esegue automaticamente le query per tuo conto per rispondere alle tue domande. Tieni presente i seguenti fattori che potrebbero aumentare il costo delle query:

• Dimensioni delle tabelle di grandi dimensioni
• Utilizzo di join di dati nelle query
• Chiamate frequenti alle funzioni di AI all'interno delle query

Crea conversazioni

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

• Dalla scheda Catalogo agenti nella 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 Google Cloud console, 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 nella 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 dati. Ad esempio, "Quali sono state le nostre vendite totali lo scorso trimestre?" o "Mostrami i primi 5 utenti in base al tempo di sessione". Puoi anche fare clic su una delle domande suggerite da Gemini per iniziare.

   L'agente 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 dati per fornire la risposta alla tua domanda, fai clic su Mostra ragionamento per visualizzare ogni messaggio nel processo di ragionamento dell'agente.

   

   Per visualizzare le 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 relative origini 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 dati. Ad esempio, "Quali sono state le nostre vendite totali lo scorso trimestre?" o "Mostrami i primi 5 utenti in base al tempo di sessione". Puoi anche fare clic su una delle domande suggerite da Gemini per iniziare.

   L'agente 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 dati per fornire la risposta alla tua domanda, fai clic su Mostra ragionamento per visualizzare ogni messaggio nel processo di ragionamento dell'agente.

   

   Per visualizzare le 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 relative origini di conoscenza.

Crea una conversazione diretta con un'origine dati

Per creare una conversazione con un'origine dati nella Google Cloud console, 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 dati. Puoi anche fare clic su una delle domande suggerite da Gemini per iniziare.

   L'API Analisi conversazionale elabora la tua domanda e restituisce i risultati.

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

   

   Per visualizzare le 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. Per creare una nuova conversazione quando lavori con una tabella, fai clic su Crea conversazione nella barra dei menu.

   Per creare una nuova conversazione con i risultati della query quando esegui una query, fai clic su Crea conversazione nel riquadro Risultati query. L'origine dati è la tabella temporanea dei risultati memorizzati nella cache che in genere persiste per 24 ore. Una volta scaduti i risultati memorizzati nella cache, non puoi porre domande sui dati.

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

   L'API Analisi conversazionale elabora la tua domanda e restituisce i risultati.

   Per visualizzare i passaggi eseguiti dall'API Analisi conversazionale, fai clic su Mostra ragionamento.

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

   

   Per visualizzare le 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.

Crea un agente 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.

Apri una conversazione esistente

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

   Vai ad Agenti

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

Rinomina una conversazione

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

   Vai ad Agenti

2. Nella scheda Conversazioni, nell'elenco delle conversazioni, fai clic sulla conversazione che vuoi 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.

Elimina una conversazione

I risultati delle domande in una conversazione persistono anche se le origini dati sottostanti vengono eliminate. Per eliminare una conversazione e tutti i risultati che contiene:

1. Nella Google Cloud console, 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.

Se non aggiorni una conversazione per 180 giorni, BigQuery la elimina automaticamente.

Gestire le conversazioni utilizzando BigQuery Studio Explorer

Gestisci le conversazioni utilizzando BigQuery Studio Explorer. Questo elenco di conversazioni fornisce un luogo centralizzato per cercare, aprire o creare conversazioni. Puoi anche copiare l'ID della conversazione o aggiornare l'elenco delle conversazioni.

Per gestire le conversazioni:

1. Vai alla pagina BigQuery Studio Explorer.

   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 del filtro.
   2. Per aprire una conversazione, fai clic su Visualizza azioni > Apri.
   3. Per copiare l'ID di una 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; non puoi scegliere la regione da utilizzare. Le conversazioni potrebbero non essere archiviate nella stessa regione delle relative origini dati.

Passaggi successivi

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