Analizzare i dati con le conversazioni

Accesso in anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione 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 delle fasi di lancio.

Nota: per registrarti all'accesso in anteprima all'analisi conversazionale, compila il modulo di richiesta. Per richiedere assistenza o fornire un feedback su questa funzionalità, invia un'email all'indirizzo [e-mail].

Utilizza questo documento per scoprire come creare, modificare ed eliminare le conversazioni in BigQuery. Le conversazioni sono chat utente persistenti con un agente dati o un'origine dati. Gli utenti possono porre agli agenti dei dati domande in più parti che utilizzano termini comuni come "vendite" o "più popolari", senza dover specificare i nomi dei campi della tabella o definire le condizioni per filtrare i dati. La risposta della chat restituita all'utente fornisce la risposta alla domanda dell'utente come testo e codice e genera anche grafici, se appropriato. La risposta include anche la motivazione alla base dei risultati.

Puoi creare una conversazione con un agente dei 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 di dati.

Prima di iniziare

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

3. Enable the BigQuery, Gemini Data Analytics, and Gemini for Google Cloud API 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:

• Visualizza e crea conversazioni con qualsiasi data agent condiviso con te: Gemini Data Analytics Data Agent User (roles/geminidataanalytics.dataAgentUser) a livello di progetto.
• Crea una conversazione diretta: Gemini Data Analytics Stateless Chat User (roles/geminidataanalytics.dataAgentStatelessUser)

Inoltre, qualsiasi utente che crea una conversazione deve disporre dei seguenti ruoli:

• Visualizzatore dati BigQuery (roles/bigquery.dataViewer) in qualsiasi tabella che l'agente dati utilizza come origine dati.
• Se una tabella dell'origine dati utilizza il controllo dell'accesso a livello di colonna, Lettore granulare (roles/datacatalog.categoryFineGrainedReader) sul tag di criteri appropriato. Per saperne di più, consulta Ruoli utilizzati con il controllo dell'accesso a livello di colonna.
• Se una tabella dell'origine 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 Crea o aggiorna le policy di accesso a livello di riga.
• Se una tabella dell'origine dati utilizza il mascheramento dei dati, lettore mascherato (roles/bigquerydatapolicy.maskedReader) nella policy sui dati appropriata. Per ulteriori informazioni, consulta Ruoli per l'esecuzione di query sui dati mascherati.

Se un utente della conversazione non dispone dei ruoli appropriati nelle tabelle dei dati di origine utilizzate dall'agente dati, viene restituito il seguente errore quando l'utente chatta con l'agente dati:

Schema_Resolution: Access Denied

Crea una conversazione con un agente di dati

Segui questi passaggi per creare una conversazione con un agente per i dati. Devi creare un agente dati prima di poter avviare una conversazione con uno.

1. Vai alla pagina Agenti di BigQuery.

   Vai alla pagina Agenti

2. Nella scheda Conversazioni, nel riquadro Chatta con i tuoi dati, fai clic sulla scheda dell'agente di dati con cui vuoi chattare. Si apre la pagina della conversazione.

3. Nel campo Poni una domanda, digita una domanda a cui vuoi che l'agente risponda. Per iniziare, puoi anche fare clic su una delle domande suggerite da Gemini.

   L'agente dei dati risponde, indicando l'azione che sta intraprendendo per rispondere alla tua domanda e restituendo i risultati.

   Per visualizzare i passaggi eseguiti dall'agente dei dati, fai clic su Visualizza passaggi.

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

   

   La scheda Testo descrive il codice generato, mentre la scheda Codice fornisce il codice generato:

   

   Se appropriato per i dati, l'agente dati fornisce anche grafici, tabelle e altre visualizzazioni.

Creare una conversazione diretta con un'origine dati

Per creare una conversazione diretta con un'origine dati:

1. Vai alla pagina Agenti di BigQuery.

   Vai alla pagina 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 Poni una domanda, digita una domanda a cui vuoi che l'agente risponda. Per iniziare, puoi anche fare clic su una delle domande suggerite da Gemini.

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

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

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

   

   La scheda Testo descrive il codice generato, mentre la scheda Codice fornisce il codice generato:

   

Aprire una conversazione esistente

Per aprire una conversazione:

1. Vai alla pagina Agenti di BigQuery.

   Vai alla pagina Agenti

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

Rinominare una conversazione

Per rinominare una conversazione:

1. Vai alla pagina Agenti di BigQuery.

   Vai alla pagina 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, digita un nuovo nome per la conversazione nel campo Nome conversazione.

5. Fai clic su Rinomina.

Eliminare una conversazione

Per eliminare una conversazione, segui questi passaggi:

1. Vai alla pagina Agenti di BigQuery.

   Vai alla pagina Agenti

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

3. Fai clic su Visualizza azioni > Elimina.

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

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.