Abilita l'API Conversational Analytics

Anteprima privata

Questo prodotto o questa funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

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 .

Nota :per utilizzare l'API Conversational Analytics, devi far parte dell'anteprima privata. Per esprimere il tuo interesse, compila il modulo di interesse per l'anteprima.

Prima di iniziare

Per utilizzare l'API Conversational Analytics, devi soddisfare i seguenti prerequisiti e disporre dei ruoli Identity and Access Management (IAM) richiesti nel tuo progetto Google Cloud .

Prerequisiti

1. 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.

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 la fatturazione per l'API Conversational Analytics.

   Vai al selettore dei progetti

Ruoli obbligatori

Assicurati di disporre dei seguenti ruoli IAM sul progetto Google Cloud che utilizzerai con l'API Conversational Analytics:

Vai a Ruoli.

• Gemini per Google Cloud (roles/cloudaicompanion.user)
• Utente BigQuery (roles/bigquery.user)
• BigQuery Studio User (roles/bigquery.studioUser) (se utilizzi BigQuery Studio e il canvas dei dati)

Abilita le API richieste

Per utilizzare l'API Conversational Analytics, devi abilitare le API richieste nel tuo progetto Google Cloud . Quando abiliti un'API, potresti dover aggiornare la pagina per confermare che l'API è stata abilitata.

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 console Google Cloud , che ti consente di attivare e disattivare le API per il progetto corrente.

Abilitare l'API Gemini Data Analytics

Per utilizzare l'API Conversational Analytics, abilita l'API Gemini Data Analytics utilizzando la console Google Cloud o Google Cloud CLI.

console

Attiva l'API Gemini Data Analytics nella console Google Cloud .

• Attiva l'API Gemini Data Analytics

gcloud

Per abilitare l'API Gemini Data Analytics con Google Cloud CLI, esegui il comando gcloud services enable nel seguente modo:

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

Nell'esempio precedente, sostituisci project_id con l'ID del tuo progetto Google Cloud .

Abilita le API richieste aggiuntive

Inoltre, per utilizzare l'API Conversational Analytics, devi abilitare le seguenti API nel progetto Google Cloud che utilizzerai con l'API Conversational Analytics:

• Abilita l'API Cloudaicompanion

• Abilita l'API BigQuery

Abilita le API per Colab Enterprise

Se prevedi di utilizzare l'API Conversational Analytics da un ambiente Colab Enterprise, abilita le seguenti API:

• Attiva l'API Dataform

• Abilita l'API Compute Engine

• Abilita l'API Vertex AI

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:
  • projects.locations.endpoints.generateContent
• Da datacatalog.googleapis.com, consenti le seguenti API:
  • entries.lookup
  • catalog.search
• Da bigquery.googleapis.com, consenti le seguenti API:
  • jobs.query
  • jobs.insert
  • jobs.getQueryResults