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.

Questo documento descrive come creare, modificare ed eliminare le conversazioni in Spanner. Le conversazioni sono chat persistenti con un agente dati.

Puoi porre agli agenti di 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 grafici, se opportuno. La risposta include il ragionamento alla base dei risultati.

Puoi creare una conversazione con un agente per i dati. 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. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .

2. Abilita le API Spanner, API Data Analytics con Gemini e Gemini for Google Cloud .

   Ruoli richiesti per abilitare le API

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

   Abilita le API

Ruoli obbligatori

Per lavorare con gli agenti dati, devi disporre di uno dei seguenti ruoli Identity and Access Management (IAM) dell'API Conversational Analytics:

• Esegui query sui dati dalle origini database supportate utilizzando il metodo QueryData: Gemini Data Analytics Data Query User (roles/geminidataanalytics.queryDataUser) a livello di progetto.
• Crea, modifica, condividi ed elimina tutti gli agenti di dati nel progetto: Gemini Data Analytics Data Agent Owner (roles/geminidataanalytics.dataAgentOwner) a livello di progetto.
• Crea i tuoi agenti dati nel progetto: Gemini Data Analytics Data Agent Creator (roles/geminidataanalytics.dataAgentCreator) a livello di progetto. Questo ruolo ti concede automaticamente il ruolo Gemini Data Analytics Data Agent Owner per gli agenti dati che crei.
• Visualizza e modifica tutti gli agenti dati nel progetto: Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor) a livello di progetto.
• Visualizza tutti gli agenti dati nel progetto: Gemini Data Analytics Data Agent Visualizzatore (roles/geminidataanalytics.dataAgentViewer) a livello di progetto.

Inoltre, per creare o modificare un agente di dati, devi disporre dei seguenti ruoli:

• Un utente IAM o un account di servizio aggiunto al cluster. Per maggiori informazioni, consulta Applicare i ruoli IAM.
• Il ruolo spanner.databaseReader concesso all'utente IAM a livello di progetto. Per saperne di più, consulta Aggiungi l'associazione di policy IAM per un progetto.
• Ruoli e autorizzazioni concessi all'utente IAM a livello di progetto per i database richiesti. Per saperne di più, consulta Concedere ruoli e autorizzazioni.

Per lavorare con le risorse Spanner, consulta Ruoli e autorizzazioni Spanner.

crea conversazioni

Puoi creare conversazioni persistenti con un agente o con un'origine dati nella console Google Cloud per Spanner dalla scheda Catalogo agenti nella pagina Agenti.

Crea una conversazione con un agente di dati

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

Per creare una conversazione con un agente dei dati nella console Google Cloud , segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina Spanner.

   Vai a Spanner

2. Seleziona un'istanza dall'elenco e poi seleziona un database.

3. Nel menu di navigazione, fai clic su Agenti.

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

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

6. 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 primi 5 utenti 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. Puoi copiare il codice e poi fare clic su Studio per incollarlo nell'editor di query.

   Quando appropriato per i dati, l'agente dei dati fornisce grafici, tabelle e altre visualizzazioni. Per visualizzare la cronologia della chat, vai all'elenco Gestione conversazioni.

   Per visualizzare le informazioni sull'agente, vai al riquadro Dettagli. Questo riquadro include una descrizione dell'agente e delle relative fonti di conoscenza.

Gestire le conversazioni

Puoi aprire, rinominare o eliminare una conversazione nella pagina Agenti.

Aprire una conversazione esistente

1. Nella console Google Cloud , vai alla pagina Spanner.

   Vai a Spanner

2. Seleziona un'istanza dall'elenco e poi seleziona un database.

3. Nel menu di navigazione, fai clic su Agenti.

4. 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 Spanner.

   Vai a Spanner

2. Seleziona un'istanza dall'elenco e poi seleziona un database.

3. Nel menu di navigazione, fai clic su Agenti.

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

5. Fai clic su Visualizza azioni > Rinomina.

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

7. Fai clic su Rinomina.

Eliminare una conversazione

1. Nella console Google Cloud , vai alla pagina Spanner.

   Vai a Spanner

2. Seleziona un'istanza dall'elenco e poi seleziona un database.

3. Nel menu di navigazione, fai clic su Agenti.

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

5. Fai clic su Visualizza azioni > Elimina.

6. 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 Spanner.
• Scopri di più sull'API Conversational Analytics (Analisi conversazionale).
• Crea un agente dati in Spanner.