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 Cloud SQL per MySQL. Le conversazioni sono chat persistenti con un agente per i dati.

Puoi porre agli agenti per i 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. La risposta della chat fornisce la risposta alla tua domanda sotto forma di testo e codice e genera grafici, se appropriato. 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 per i dati.

Prima di iniziare

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

2. Abilita le API Cloud SQL, API Data Analytics con Gemini e Gemini per Google Cloud , se non sono già abilitate.

   Ruoli richiesti per abilitare le API

   Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

   Abilita le API

Ruoli obbligatori

Per lavorare con gli agenti per i dati, devi disporre di autorizzazioni IAM corrispondenti al tuo caso d'uso. La tabella seguente elenca i ruoli richiesti in base al fatto che tu stia creando e pubblicando agenti, eseguendo il provisioning degli agenti in Gemini Enterprise o scoprendo e utilizzando gli agenti. Per saperne di più, consulta Ruoli di Identity and Access Management dell'API Conversational Analytics.

Caso d'uso	Ruoli obbligatori
Creare, modificare, pubblicare, condividere ed eliminare agenti	Per creare agenti per i dati in un progetto: Gemini Data Analytics Data Agent Creator (roles/geminidataanalytics.dataAgentCreator) sul progetto. Questo ruolo ti concede automaticamente il ruolo Data Agent Owner di Gemini Data Analytics sugli agenti per i dati che crei. Per modificare, condividere o eliminare un agente per i dati: Gemini Data Analytics Data Agent Owner (roles/geminidataanalytics.dataAgentOwner) sull'agente o sul progetto. Per modificare un agente per i dati in un progetto: Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor) nel progetto. Per visualizzare gli agenti per i dati in un progetto: Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer) sul progetto. Inoltre, per creare o modificare un agente per i dati, devi disporre dei seguenti ruoli: Un utente IAM o un account di servizio aggiunto a livello di istanza. Per saperne di più, consulta Aggiungi un'associazione di policy IAM a un utente, un account di servizio o un gruppo. I ruoli cloudsql.studioUser e cloudsql.instanceUser concessi all'utente IAM a livello di progetto. Per saperne di più, consulta Aggiungi l'associazione della policy IAM per un progetto. (Facoltativo) Se utilizzi i set di contesto (anteprima) con l'agente per i dati del database, per creare, caricare e gestire i set di contesto: il ruolo Dataplex Catalog Editor (roles/dataplex.catalogEditor) o Dataplex Catalog Admin (roles/dataplex.catalogAdmin) concesso all'utente IAM a livello di progetto. Per saperne di più, consulta Autorizzazioni per i set di contesti. Privilegi del database concessi a un utente IAM o a un account di servizio accedendo come utente del database basato su password. GRANT ALL PRIVILEGES ON *.* TO '[e-mail]'; Per saperne di più, consulta Concedi i privilegi del database a un singolo utente o service account IAM.
Esegui il provisioning degli agenti in Gemini Enterprise	Per rendere un agente pubblicato disponibile per gli utenti di Gemini Enterprise, devi disporre delle autorizzazioni per registrare e gestire gli agenti A2A nella console di amministrazione di Gemini Enterprise.
Scopri e utilizza gli agenti	Per chattare con gli agenti per i dati: Gemini Data Analytics Data Agent User (roles/geminidataanalytics.dataAgentUser). Per visualizzare tutti gli agenti per i dati nel progetto: Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer).

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, viste 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 e avere l'autorizzazione per inviare query. Per interagire con oggetti come tabelle e viste, l'utente del database che si connette deve disporre dei privilegi necessari concessi utilizzando il sistema GRANT di Cloud SQL per MySQL. Per saperne di più, consulta Informazioni sugli utenti di Cloud SQL per MySQL. Se l'agente utilizza un account di servizio, puoi farti assegnare un ruolo di database. Ad esempio, consulta Gestisci gli utenti con l'autenticazione IAM dei database.

crea conversazioni

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

Crea una conversazione con un agente per i dati

Per creare una conversazione con un agente per i dati, devi prima creare un agente per i dati e pubblicarlo. Puoi anche avviare una conversazione con gli agenti condivisi con te da altri utenti.

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

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

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

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

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

5. Nel campo Fai una domanda, inserisci una domanda per l'agente per i 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". Puoi anche fare clic su una delle domande suggerite da Gemini per iniziare.

   L'agente per i 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 per i 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.

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

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

Gestire le conversazioni

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

Apri una conversazione esistente

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

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

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

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

Rinomina una conversazione

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

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

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

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

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

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

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; non puoi scegliere quale regione utilizzare.

Passaggi successivi

• Scopri di più sull'analisi conversazionale in Cloud SQL per MySQL.
• Scopri di più sull'API Conversational Analytics.
• Crea un agente per i dati in Cloud SQL per MySQL.