Ative a API Conversational Analytics

Esta página descreve os passos para ativar a API Conversational Analytics (acedida através de geminidataanalytics.googleapis.com) para o seu Google Cloud projeto. A API Conversational Analytics é a primeira capacidade na API Data Analytics com o Gemini na Google Cloud consola.

Antes de começar

Antes de poder usar a API Conversational Analytics, tem de ter um Google Cloud projeto que possa aceder aos dados com os quais quer trabalhar. Para configurar o seu projeto, conclua os seguintes passos:

  1. Identifique os dados que quer usar com a API Conversational Analytics. Pode usar origens de dados como tabelas do BigQuery, explorações do Looker e relatórios do Looker Studio.

  2. Na Google Cloud Console, na página do seletor de projetos, crie um Google Cloud projeto que possa aceder aos dados que quer usar com a API Conversational Analytics.

    Aceder ao seletor de projetos

Ative as APIs necessárias

Para usar a API Conversational Analytics, tem de ativar um conjunto de APIs necessárias no seu Google Cloud projeto. Se planeia usar a API Conversational Analytics a partir de um ambiente do Colab Enterprise, também tem de ativar APIs adicionais.

APIs necessárias

consola

Ative as seguintes APIs na Google Cloud consola para o Google Cloud projeto que vai usar com a API Conversational Analytics.

Ative a API Gemini Data Analytics

Ative a API Google Cloud Gemini for

Ative a API BigQuery

gcloud

Com a CLI do Google Cloud, execute os seguintes comandos gcloud services enable para ativar a API Gemini Data Analytics, a API Gemini for Google Cloud e a API BigQuery, respetivamente:

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

Nos comandos da CLI gcloud de exemplo anteriores, substitua project_id pelo seu Google Cloud ID do projeto.

APIs para o Colab Enterprise

Se planear usar a API Conversational Analytics a partir de um ambiente do Colab Enterprise, também deve ativar as seguintes APIs:

Ative a API Dataform

Ative a API Compute Engine

Ative a API Vertex AI

Conceda as funções necessárias

Para usar a API Conversational Analytics, conceda as seguintes funções de gestão de identidades e acessos (IAM) na Google Cloud consola aos responsáveis (como utilizadores ou contas de serviço) que precisam de interagir com a API:

Aceda a Funções

Além disso, as autorizações para ações como a gestão de agentes são controladas pelas funções do Gemini Data Analytics, conforme descrito no artigo Conceda funções e autorizações da API IAM Conversational Analytics.

Configuração adicional para os VPC Service Controls

Se o VPC Service Controls estiver ativado para a sua organização ou para o Google Cloud projeto que está a usar, adicione as seguintes APIs, que são usadas pela API Conversational Analytics, à lista de autorizações: