Abilitare l'API Conversational Analytics

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

Prima di iniziare

Prima di poter utilizzare l'API Analisi conversazionale, devi avere un Google Cloud progetto che possa accedere ai dati con cui vuoi lavorare. Per configurare il progetto, completa i seguenti passaggi:

1. Identifica i dati che vuoi utilizzare con l'API Analisi conversazionale. Puoi utilizzare origini dati come tabelle BigQuery, Esplora 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 Google Cloud console, nella pagina di selezione del progetto, crea un Google Cloud progetto che possa accedere ai dati che vuoi utilizzare con l'API Analisi conversazionale.

   Nota: al momento non è prevista la fatturazione per l'API Analisi conversazionale.

   Vai al selettore di progetti

Requisiti di Looker e Data Studio Pro

Se utilizzi l'API Analisi conversazionale con Looker, l'istanza di Looker deve soddisfare requisiti specifici:

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

Per utilizzare l'API Analisi conversazionale con Data Studio Pro, l'abbonamento Pro deve essere al di fuori di un perimetro VPC-SC.

Requisiti di AlloyDB

Se utilizzi l'API Analisi conversazionale con AlloyDB, l'istanza di AlloyDB deve soddisfare requisiti specifici. Completa tutti i passaggi descritti in Prima di iniziare.

Requisiti di Cloud SQL per MySQL

Se utilizzi l'API Analisi conversazionale 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 Analisi conversazionale 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 Analisi conversazionale con Spanner, l'istanza di Spanner deve soddisfare requisiti specifici. Completa tutti i passaggi descritti in Prima di iniziare.

Abilita le API richieste

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

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 utilizzo servizi (roles/serviceusage.serviceUsageAdmin) nella Google Cloud console, che ti consente di abilitare e disabilitare le API per il progetto corrente.

console

Abilita le seguenti API nella Google Cloud console per il Google Cloud progetto che utilizzerai con l'API Analisi conversazionale.

Abilita l'API Gemini Data Analytics

Abilita Gemini per l' Google Cloud API

Abilita l'API BigQuery

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

gcloud

Con la Google Cloud CLI, esegui i seguenti comandi gcloud services enable per abilitare rispettivamente l'API Gemini Data Analytics, Gemini per l' Google Cloud API 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 l' Google Cloud ID progetto.

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

API per Colab Enterprise

Se prevedi di utilizzare l'API Analisi conversazionale da un ambiente Colab Enterprise, abilita anche 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 Google Cloud pagina della console per confermare che sia abilitata.

Concedi i ruoli richiesti

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

Per concedere questi ruoli, utilizza la Google Cloud console:

Vai a Ruoli.

Ruoli di Gemini Data Analytics

Per consentire alle entità di creare agenti API Analisi conversazionale e utilizzare il metodo di chat con stato per le conversazioni, concedi i seguenti ruoli IAM:

• Creatore agente dati Gemini Data Analytics (roles/geminidataanalytics.dataAgentCreator): necessario per iniziare a creare agenti solo in BigQuery, Looker e Data Studio Pro.
• Gemini per Google Cloud l'utente (roles/cloudaicompanion.user): necessario per utilizzare il metodo di chat con stato 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 Analisi conversazionale con IAM.

Ruoli di BigQuery

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

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

Ruoli di Looker

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

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

Per utilizzare Analisi conversazionale e l'API Analisi conversazionale, 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 alle entità di eseguire query sulle origini dati AlloyDB, Cloud SQL per MySQL, Cloud SQL per PostgreSQL o Spanner tramite l'API Analisi conversazionale, concedi i seguenti ruoli IAM:

• Utente database AlloyDB (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 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 Analisi conversazionale.
• Scopri come configurare i Controlli di servizio VPC per l'API Analisi conversazionale.

Passaggi successivi

• Scopri come autenticarti all'origine dati e all'API.
• Scopri come creare un agente dati utilizzando l'SDK Python.
• Scopri come creare un agente dati utilizzando HTTP e Python.