Questa pagina descrive i passaggi per abilitare l'API Conversational Analytics (a cui si accede tramite geminidataanalytics.googleapis.com
) 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 disporre di un progetto Google Cloud che possa accedere ai dati che vuoi utilizzare. Per configurare il progetto, completa i seguenti passaggi:
- Identifica i dati che vuoi utilizzare con l'API Conversational Analytics. Puoi utilizzare origini dati come tabelle BigQuery, esplorazioni di Looker e report di Looker Studio.
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.
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
console
Abilita le seguenti API nella console Google Cloud per il progetto Google Cloud che utilizzerai con l'API Conversational Analytics.
Attiva l'API Gemini Data Analytics
gcloud
Con la Google Cloud CLI, esegui i seguenti comandi gcloud services enable
per attivare 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 l'ID del tuo progetto Google Cloud .
API per Colab Enterprise
Se prevedi di utilizzare l'API Conversational Analytics da un ambiente Colab Enterprise, abilita anche le seguenti API:
Concedere i ruoli richiesti
Per utilizzare l'API Conversational Analytics, concedi i seguenti ruoli Identity and Access Management (IAM) nella console Google Cloud alle entità (come utenti o service account) che devono interagire con l'API:
- Gemini per Google Cloud User (
roles/cloudaicompanion.user
): necessario per creare conversazioni gestite da Google Cloud. - Utente istanza Looker (
roles/looker.instanceUser
): necessario per accedere ai dati da un'istanza di Looker (Google Cloud core) - Utente BigQuery (
roles/bigquery.user
): necessario per accedere ai dati in BigQuery - BigQuery Studio User (
roles/bigquery.studioUser
): obbligatorio se utilizzi BigQuery Studio e il canvas dei dati
Inoltre, le autorizzazioni per azioni come la gestione degli agenti sono controllate dai ruoli Gemini Data Analytics, come descritto in Concedere ruoli e autorizzazioni IAM per l'API Conversational Analytics.
Configurazione aggiuntiva per i Controlli di servizio VPC
Se Controlli di servizio VPC è abilitato per la tua organizzazione o per il progetto Google Cloud che stai utilizzando, aggiungi alla lista consentita le seguenti API, utilizzate dall'API Conversational Analytics:
- Da
geminidataanalytics.googleapis.com
, consenti la seguente API:projects.locations.chat
- Da
aiplatform.googleapis.com
, consenti la seguente API: - Da
datacatalog.googleapis.com
, consenti le seguenti API: - Da
bigquery.googleapis.com
, consenti le seguenti API: