Ativar a API Conversational Analytics

Este produto ou recurso está sujeitos 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 suporte limitado. 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 e relatórios do Looker Studio.

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 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 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 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"

• Usuário do Gemini para Google Cloud (roles/cloudaicompanion.user): necessário para criar conversas gerenciadas pelo 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 o painel de dados

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