Abilitare l'API Conversational Analytics

Questa pagina descrive i passaggi per abilitare l'API Conversational Analytics (a cui si accede tramite geminidataanalytics.googleapis.com o endpoint regionali) per il tuo progetto Google Cloud . L'API Conversational Analytics è la prima funzionalità dell'API Data Analytics con Gemini nella console Google Cloud .

Prima di iniziare

Prima di poter utilizzare l'API Conversational Analytics, devi avere un progetto Google Cloud che possa accedere ai dati che vuoi utilizzare. Per configurare il tuo progetto, completa i seguenti passaggi:

1. Identifica i dati che vuoi utilizzare con l'API Conversational Analytics. Puoi utilizzare origini dati come tabelle BigQuery, esplorazioni di Looker, report di Data Studio e dati di AlloyDB per PostgreSQL, GoogleSQL per Spanner, Cloud SQL per MySQL e Cloud SQL per PostgreSQL.

2. Nella console Google Cloud , nella pagina di selezione del progetto, crea un progetto Google Cloud che possa accedere ai dati che vuoi utilizzare con l'API Conversational Analytics.

   Nota: al momento non è prevista alcuna fatturazione per l'API Conversational Analytics.

   Vai al selettore di progetti

Requisiti di Looker e Data Studio Pro

Se utilizzi l'API Conversational Analytics con Looker, l'istanza di Looker deve soddisfare requisiti specifici:

• Looker (originale)
• Looker (Google Cloud core)

Per utilizzare l'API Conversational Analytics con Data Studio Pro, l'abbonamento Pro deve trovarsi al di fuori di un perimetro VPC-SC.

Requisiti di AlloyDB

Se utilizzi l'API Conversational Analytics con AlloyDB, la tua istanza AlloyDB deve soddisfare requisiti specifici. Completa tutti i passaggi descritti nella sezione Prima di iniziare.

Requisiti di Cloud SQL per MySQL

Se utilizzi l'API Conversational Analytics con Cloud SQL per MySQL, l'istanza Cloud SQL deve soddisfare requisiti specifici. Completa tutti i passaggi in Prima di iniziare.

Requisiti di Cloud SQL per PostgreSQL

Se utilizzi l'API Conversational Analytics con Cloud SQL per PostgreSQL, l'istanza Cloud SQL deve soddisfare requisiti specifici. Completa tutti i passaggi descritti in Prima di iniziare.

Requisiti di Spanner

Se utilizzi l'API Conversational Analytics con Spanner, la tua istanza Spanner deve soddisfare requisiti specifici. Completa tutti i passaggi descritti in Prima di iniziare.

Abilita le API richieste

Per utilizzare l'API Conversational Analytics, devi abilitare un insieme di API richieste nel tuo progetto Google Cloud . Se prevedi di utilizzare l'API Conversational Analytics da un ambiente Colab Enterprise, devi anche abilitare API aggiuntive.

API obbligatorie

Nota: se non hai l'autorizzazione per abilitare le API, chiedi all'amministratore del progetto di abilitarle per te dalla dashboard API e servizi. In alternativa, l'amministratore del progetto può concederti il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin) nella console Google Cloud , che ti consente di gestire le API per il progetto corrente.

console

Se non sono già abilitate, abilita le seguenti API per il progettoGoogle Cloud che utilizzerai con l'API Conversational Analytics.

Attiva l'API Gemini Data Analytics

Abilita l'API Gemini per Google Cloud

Abilita l'API BigQuery

Suggerimento :quando abiliti un'API, potrebbe essere necessario aggiornare la pagina della console Google Cloud per verificare che sia abilitata.

gcloud

Con Google Cloud CLI, esegui i seguenti comandi gcloud services enable per abilitare rispettivamente l'API Gemini Data Analytics, l'API Gemini for Google Cloud e l'API BigQuery:

gcloud services enable geminidataanalytics.googleapis.com --project=project_id
gcloud services enable cloudaicompanion.googleapis.com --project=project_id
gcloud services enable bigquery.googleapis.com --project=project_id

Nei comandi gcloud CLI di esempio precedenti, sostituisci project_id con il tuo ID progetto Google Cloud .

Nota: abilita l'API BigQuery solo se utilizzi BigQuery.

API per Colab Enterprise

Se prevedi di utilizzare l'API Conversational Analytics da un ambiente Colab Enterprise, verifica anche che siano abilitate le seguenti API:

Abilita l'API Dataform

Abilita l'API Compute Engine

Abilita l'API Vertex AI

Suggerimento: quando abiliti un'API, potresti dover aggiornare la pagina della console Google Cloud per verificare che sia abilitata.

Concedi i ruoli richiesti

Per utilizzare l'API Conversational Analytics, le entità (come utenti o service account) richiedono ruoli Identity and Access Management (IAM) che forniscono l'accesso sia all'API sia alle origini dati sottostanti.

Per concedere questi ruoli, utilizza la console Google Cloud :

Vai a Ruoli.

Ruoli Gemini Data Analytics

Per consentire alle entità di creare agenti API Conversational Analytics e utilizzare il metodo di chat stateful per le conversazioni, concedi i seguenti ruoli IAM:

• Data Agent Creator di Gemini Data Analytics (roles/geminidataanalytics.dataAgentCreator): necessario per iniziare a creare agenti solo in BigQuery, Looker e Data Studio Pro.
• Gemini per l'utente Google Cloud (roles/cloudaicompanion.user): necessario per utilizzare il metodo di chat stateful per le conversazioni.

Inoltre, le autorizzazioni per azioni come la gestione degli agenti sono controllate dai ruoli Gemini Data Analytics, come descritto in Controllo dell'accesso all'API Conversational Analytics con IAM.

Ruoli BigQuery

Per consentire alle entità di eseguire query sulle origini dati BigQuery tramite l'API Conversational Analytics, concedi i seguenti ruoli IAM:

• Utente BigQuery (roles/bigquery.user): necessario per accedere ai dati in BigQuery.
• Utente BigQuery Studio (roles/bigquery.studioUser): obbligatorio se utilizzi BigQuery Studio e il data canvas.

Ruoli Looker

Per consentire alle entità di eseguire query sulle origini dati di Looker tramite l'API Conversational Analytics, concedi i seguenti ruoli IAM:

• Utente istanza di Looker (roles/looker.instanceUser): necessario per accedere ai dati da un'istanza di Looker (Google Cloud core).

Per utilizzare Conversational Analytics e l'API Conversational Analytics, a un utente Looker deve essere assegnato un ruolo Looker che contenga l'autorizzazione gemini_in_looker per i modelli con cui interagisce.

Ruoli database

Per consentire ai principal di eseguire query sulle origini dati AlloyDB, Cloud SQL per MySQL, Cloud SQL per PostgreSQL o Spanner tramite l'API Conversational Analytics, assegna i seguenti ruoli IAM:

• AlloyDB Database User (roles/alloydb.databaseUser): necessario per accedere ai dati da un'istanza AlloyDB.
• Utente Studio Cloud SQL per MySQL e Cloud SQL per PostgreSQL (roles/cloudsql.studioUser): necessario per utilizzare la Google Cloud console per visualizzare e gestire le istanze Cloud SQL per MySQL e Cloud SQL per PostgreSQL.
• Utente istanza Cloud SQL per MySQL e Cloud SQL per PostgreSQL (roles/cloudsql.instanceUser): necessario per connettersi alle istanze Cloud SQL per MySQL e Cloud SQL per PostgreSQL.
• Lettore del database Spanner (roles/spanner.databaseReader): necessario per leggere i dati da un database GoogleSQL per Spanner.

Passaggi successivi

• Scopri di più sul controllo dell'accesso per l'API Conversational Analytics.
• Scopri come configurare i Controlli di servizio VPC per l'API Conversational Analytics.

Passaggi successivi

• Scopri come eseguire l'autenticazione nell'origine dati e nell'API.
• Scopri come creare un agente di dati utilizzando l'SDK Python.
• Scopri come creare un agente di dati utilizzando HTTP e Python.