Ativar a API Conversational Analytics

Este produto ou recurso está sujeito aos "Termos das Soluções Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

Nesta página, descrevemos as etapas para ativar a API Conversational Analytics (acessada por geminidataanalytics.googleapis.com) no projeto Google Cloud . A API Conversational Analytics é o primeiro recurso da API Data Analytics com Gemini no console Google Cloud .

Antes de começar

Antes de usar a API Conversational Analytics, você precisa ter um projeto Google Cloud que possa acessar os dados com que quer trabalhar. Para configurar seu projeto, siga estas etapas:

1. Identifique os dados que quer usar com a API Conversational Analytics. É possível usar fontes de dados como tabelas do BigQuery, análises detalhadas do Looker, relatórios do Looker Studio e dados do AlloyDB, do GoogleSQL para Spanner, do Cloud SQL e do Cloud SQL para PostgreSQL.

2. No console do Google Cloud, na página do seletor de projetos, crie um Google Cloud projeto que possa acessar os dados que você quer usar com a API Conversational Analytics.

   Observação: no momento, não há faturamento para a API Conversational Analytics.

   Acessar o seletor de projetos

Ative as APIs necessárias

Para usar a API Conversational Analytics, ative um conjunto de APIs necessárias no projeto Google Cloud . Se você pretende usar a API Conversational Analytics em um ambiente do Colab Enterprise, também é necessário ativar outras APIs.

APIs necessárias

Observação: se você não tiver permissão para ativar as APIs, peça para o administrador do projeto fazer isso no painel "APIs e serviços". Como alternativa, o administrador do projeto pode conceder a você o papel Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin) no console Google Cloud , o que permite ativar e desativar APIs para o projeto atual.

Console

Ative as seguintes APIs no console do Google Cloud para o projeto Google Cloud que você vai usar com a API Conversational Analytics.

Ativar a API Gemini Data Analytics

Ativar a API Gemini para Google Cloud

Ativar a API BigQuery

Dica: ao ativar uma API, pode ser necessário atualizar a página do console do Google Cloud para confirmar que ela está ativada.

gcloud

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

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 de exemplo da CLI gcloud anteriores, substitua project_id pelo ID do projeto Google Cloud .

APIs para o Colab Enterprise

Se você pretende usar a API Conversational Analytics em um ambiente do Colab Enterprise, ative também as seguintes APIs:

Ativar a API Dataform

Ativar a API Compute Engine

Ativar a API Vertex AI

Dica: ao ativar uma API, pode ser necessário atualizar a página do console do Google Cloud para confirmar que ela está ativada.

Conceder os papéis necessários

Para usar a API Conversational Analytics, conceda os seguintes papéis do Identity and Access Management (IAM) no console Google Cloud aos principais (como usuários ou contas de serviço) que precisam interagir com a API:

Acessar "Papéis"

• Gemini para Google Cloud usuário (roles/cloudaicompanion.user): necessário para criar conversas gerenciadas por Google Cloud.
• Usuário da instância do Looker (roles/looker.instanceUser): necessário para acessar dados de uma instância do Looker (Google Cloud Core)
• Usuário do BigQuery (roles/bigquery.user): necessário para acessar dados no BigQuery
• Usuário do BigQuery Studio (roles/bigquery.studioUser): necessário se você usa o BigQuery Studio e a tela de dados
• Usuário do banco de dados do AlloyDB (roles/alloydb.databaseUser): necessário para acessar dados de uma instância do AlloyDB.
• Usuário do Cloud SQL e do Cloud SQL para PostgreSQL Studio (roles/cloudsql.studioUser): necessário para usar o console Google Cloud e visualizar e gerenciar instâncias do Cloud SQL e do Cloud SQL para PostgreSQL.
• Usuário da instância do Cloud SQL e do Cloud SQL para PostgreSQL (roles/cloudsql.instanceUser): necessário para se conectar às instâncias do Cloud SQL e do Cloud SQL para PostgreSQL.
• Leitor do banco de dados do Spanner (roles/spanner.databaseReader): necessário para ler dados de um banco de dados do GoogleSQL para Spanner.

Além disso, as permissões para ações como gerenciar agentes são controladas pelos papéis do Gemini Data Analytics, conforme descrito em Conceder papéis e permissões do IAM da API Conversational Analytics.

Configuração adicional para o VPC Service Controls

Se o VPC Service Controls estiver ativado na organização ou no projeto Google Cloud que você está usando, adicione as seguintes APIs, usadas pela API Conversational Analytics, à lista de permissões:

• Em geminidataanalytics.googleapis.com, permita a seguinte API:
  • projects.locations.chat
• Em aiplatform.googleapis.com, permita a seguinte API:
  • projects.locations.endpoints.generateContent
• Em datacatalog.googleapis.com, permita as seguintes APIs:
  • entries.lookup
  • catalog.search
• Em bigquery.googleapis.com, permita as seguintes APIs:
  • jobs.query
  • jobs.insert
  • jobs.getQueryResults