Analizzare i dati con le conversazioni

Questo documento descrive come creare, modificare ed eliminare le conversazioni in AlloyDB per PostgreSQL. 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 le 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 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 AlloyDB per PostgreSQL, l'API Data Analytics con Gemini e Gemini for Google Cloud APIs.

    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 utilizzo servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

    Abilita le API

Ruoli obbligatori

Per lavorare con gli agenti dati, devi disporre delle autorizzazioni IAM che corrispondono al tuo caso d'uso. La seguente tabella 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 ulteriori informazioni, consulta Ruoli IAM dell'API Analisi conversazionale roles.

Caso d'uso Ruoli obbligatori
Creare, modificare, pubblicare, condividere ed eliminare gli agenti
  • Per creare agenti dati in un progetto: Gemini Data Analytics Data Agent Creator (roles/geminidataanalytics.dataAgentCreator) sul progetto. Questo ruolo ti concede automaticamente il ruolo Gemini Data Analytics Data Agent Owner sugli agenti dati che crei.
  • Per modificare, condividere o eliminare un agente dati: Gemini Data Analytics Data Agent Owner (roles/geminidataanalytics.dataAgentOwner) sull'agente o sul progetto.
  • Per modificare un agente dati in un progetto: Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor) sul progetto.
  • Per visualizzare gli agenti dati in un progetto: Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer) sul progetto.
  • Inoltre, devi disporre dei seguenti ruoli per creare o modificare un agente dati:
Eseguire il provisioning degli agenti in Gemini Enterprise

Per rendere disponibile un agente pubblicato agli utenti in Gemini Enterprise, devi disporre delle autorizzazioni per registrare e gestire gli agenti A2A nella console di amministrazione di Gemini Enterprise.
Scoprire e utilizzare gli agenti
  • Per chattare con gli agenti dati: Gemini Data Analytics Data Agent User (roles/geminidataanalytics.dataAgentUser).
  • Per visualizzare tutti gli agenti dati nel progetto: Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer).

Per lavorare con le risorse AlloyDB, ad esempio visualizzare le tabelle o eseguire query, consulta Ruoli e autorizzazioni IAM per AlloyDB.

crea conversazioni

Puoi creare conversazioni persistenti con un agente o con un'origine dati in the Google Cloud console per AlloyDB 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:

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

    Vai ad AlloyDB

  2. Seleziona un cluster dall'elenco.

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

  4. Nella sezione I miei agenti o Condivisi da altri nella 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 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". Per iniziare, puoi anche fare clic su una delle domande suggerite da Gemini.

    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 delle 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

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

    Vai ad AlloyDB

  2. Seleziona un cluster dall'elenco.

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

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

    Vai ad AlloyDB

  2. Seleziona un cluster dall'elenco.

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

  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 Google Cloud console, vai alla pagina AlloyDB.

    Vai ad AlloyDB

  2. Seleziona un cluster dall'elenco.

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

Passaggi successivi