Analizzare i dati con le conversazioni

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

Puoi porre agli agenti 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 come testo e codice e genera grafici quando appropriato. La risposta include il ragionamento alla base dei risultati.

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

Prima di iniziare

Verifica che la fatturazione sia abilitata per il tuo Google Cloud progetto.
Abilita Cloud SQL, l'API Data Analytics con Gemini 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 lavorare con gli agenti dati, devi disporre di uno dei seguenti ruoli IAM (Identity and Access Management) dell'API Analisi conversazionale:

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

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

Un utente IAM o un account di servizio aggiunto a livello di istanza. Per ulteriori informazioni, consulta Aggiungere un binding di policy IAM a un utente, account di servizio o un gruppo.
I ruoli cloudsql.studioUser e cloudsql.instanceUser concessi all'utente IAM a livello di progetto. Per ulteriori informazioni, consulta Aggiungere un binding di policy IAM per un progetto.
Privilegi del database concessi a un utente IAM o a un service account accedendo come utente del database basato su password.
```
GRANT ALL PRIVILEGES ON *.* TO 'your-iam-user@example.com';
```
Per ulteriori informazioni, consulta Concedere i privilegi del database a un singolo utente IAM o service account.

Quando gestisci l'accesso alle risorse del database Cloud SQL per MySQL, tieni presente i seguenti livelli di autorizzazioni:

Google Cloud IAM: controlla l'accesso all'istanza del database come risorsa cloud. Sono incluse le autorizzazioni per connettersi, gestire l'istanza ed eseguire query SQL, ad esempio utilizzando l'autorizzazione executeSql.
Autorizzazioni del database: controllano l'accesso agli oggetti nel database, come tabelle, visualizzazioni e schemi. Questi vengono gestiti utilizzando comandi SQL come GRANT e sistemi di utenti e ruoli specifici del database.

Per Cloud SQL per MySQL, devi disporre dei ruoli IAM Cloud SQL appropriati per connetterti all'istanza ed essere autorizzato a inviare query. Per interagire con oggetti come tabelle e visualizzazioni, l'utente del database di connessione deve disporre dei privilegi necessari concessi utilizzando il sistema GRANT di Cloud SQL per MySQL. Per ulteriori informazioni, consulta Informazioni sugli utenti di Cloud SQL per MySQL. Se l'agente utilizza un account di servizio, puoi assegnare un ruolo database. Ad esempio, consulta Gestire gli utenti con l'autenticazione IAM del database.

Crea conversazioni

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

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, segui questi passaggi:

Nella Google Cloud console, vai alla pagina Cloud SQL per MySQL.

Vai a Cloud SQL
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Agenti.
Nella sezione I miei agenti o Condivisi da altri nella tua organizzazione, fai clic sulla scheda dell'agente con cui vuoi chattare.
Fai clic su Avvia una conversazione. Si apre un nuovo riquadro della chat.
Nel campo Fai una domanda, inserisci una domanda per l'agente dati. Ad esempio, "Quali sono state le nostre vendite totali nell'ultimo 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, quindi 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. Puoi copiare il codice e poi fare clic su Studio per incollarlo nell'editor di query.

Quando appropriato per i dati, l'agente dati fornisce grafici, tabelle e altre visualizzazioni. Per visualizzare la cronologia 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 origini di conoscenza.

Gestire le conversazioni

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

Apri una conversazione esistente

Nella Google Cloud console, vai alla pagina Cloud SQL per MySQL.

Vai a Cloud SQL
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Agenti.
Nella scheda Conversazioni, nell'elenco delle conversazioni, fai clic sulla conversazione che vuoi aprire.

Rinomina una conversazione

Nella Google Cloud console, vai alla pagina Cloud SQL per MySQL.

Vai a Cloud SQL
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Agenti.
Nella scheda Conversazioni, nell'elenco delle conversazioni, fai clic sulla conversazione che vuoi rinominare.
Fai clic su Visualizza azioni > Rinomina.
Nella finestra di dialogo Rinomina conversazione, inserisci un nuovo nome per la conversazione nel campo Nome conversazione.
Fai clic su Rinomina.

Elimina una conversazione

Nella Google Cloud console, vai alla pagina Cloud SQL per MySQL.

Vai a Cloud SQL
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Agenti.
Nella scheda Conversazioni, nell'elenco delle conversazioni, fai clic sulla conversazione che vuoi eliminare.
Fai clic su Visualizza azioni > Elimina.
Nella finestra di dialogo Eliminare la conversazione?, fai clic su Elimina.

Località

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

Passaggi successivi

Scopri di più sull'analisi conversazionale in Cloud SQL per MySQL.
Scopri di più sull'API Analisi conversazionale.
Crea un agente dati in Cloud SQL per MySQL.