Ative a API Conversational Analytics

Este produto ou funcionalidade está sujeito aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais do Serviço dos Termos Específicos do Serviço. Os produtos e as funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

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, análises detalhadas do Looker, relatórios do Looker Studio e dados do AlloyDB, GoogleSQL para Spanner, Cloud SQL e Cloud SQL para PostgreSQL.

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.

   Nota: de momento, não existe faturação para 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

Nota: se não tiver autorização para ativar as APIs, peça ao administrador do projeto para as ativar a partir do painel de controlo de APIs e serviços. Em alternativa, o administrador do projeto pode conceder-lhe a função Administrador de utilização de serviços (roles/serviceusage.serviceUsageAdmin) na Google Cloud consola, o que lhe permite ativar e desativar APIs para o projeto atual.

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

Sugestão: quando ativa uma API, pode ter de atualizar a Google Cloud página da consola para confirmar que está ativada.

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

Sugestão: quando ativa uma API, pode ter de atualizar a Google Cloud página da consola para confirmar que está ativada.

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

• Gemini para Google Cloud User (roles/cloudaicompanion.user): necessário para criar conversas geridas por Google Cloud.
• Utilizador da instância do Looker (roles/looker.instanceUser): necessário para aceder a dados de uma instância do Looker (Google Cloud core)
• Utilizador do BigQuery (roles/bigquery.user): necessário para aceder aos dados no BigQuery
• Utilizador do BigQuery Studio (roles/bigquery.studioUser): obrigatório se usar o BigQuery Studio e a tela de dados
• Utilizador da base de dados do AlloyDB (roles/alloydb.databaseUser): necessário para aceder aos dados de uma instância do AlloyDB
• Utilizador do Cloud SQL e do Cloud SQL para PostgreSQL Studio (roles/cloudsql.studioUser): necessário para usar a Google Cloud consola para ver e gerir instâncias do Cloud SQL e do Cloud SQL para PostgreSQL
• Utilizador da instância do Cloud SQL e do Cloud SQL para PostgreSQL (roles/cloudsql.instanceUser): necessário para estabelecer ligação a instâncias do Cloud SQL e do Cloud SQL para PostgreSQL.
• Leitor da base de dados do Spanner (roles/spanner.databaseReader): necessário para ler dados de uma base de dados do GoogleSQL para Spanner

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 IAM da API 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:

• A partir de geminidataanalytics.googleapis.com, permita a seguinte API:
  • projects.locations.chat
• A partir de 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