Ativar a API Conversational Analytics

Nesta página, descrevemos as etapas para ativar a API Conversational Analytics (acessada por geminidataanalytics.googleapis.com ou endpoints regionais) 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 Data Studio e dados do AlloyDB para PostgreSQL, do GoogleSQL para Spanner, do Cloud SQL para MySQL 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

Requisitos do Looker e do Data Studio Pro

Se você usar a API Conversational Analytics com o Looker, sua instância do Looker precisará atender a requisitos específicos:

• Looker (original)
• Looker (Google Cloud Core)

Para usar a API Conversational Analytics com o Data Studio Pro, sua assinatura do Pro precisa estar fora de um perímetro do VPC-SC.

Requisitos do AlloyDB

Se você usar a API Conversational Analytics com o AlloyDB, sua instância do AlloyDB precisará atender a requisitos específicos. Conclua todas as etapas em Antes de começar.

Requisitos do Cloud SQL para MySQL

Se você usar a API Conversational Analytics com o Cloud SQL para MySQL, sua instância do Cloud SQL precisará atender a requisitos específicos. Conclua todas as etapas em Antes de começar.

Requisitos do Cloud SQL para PostgreSQL

Se você usar a API Conversational Analytics com o Cloud SQL para PostgreSQL, sua instância do Cloud SQL precisará atender a requisitos específicos. Conclua todas as etapas em Antes de começar.

Requisitos do Spanner

Se você usar a API Conversational Analytics com o Spanner, sua instância do Spanner precisará atender a requisitos específicos. Conclua todas as etapas em Antes de começar.

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

Observação: ative a API BigQuery somente se você estiver usando o BigQuery.

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, os principais (como usuários ou contas de serviço) precisam de papéis do Identity and Access Management (IAM) que forneçam acesso à API e às fontes de dados subjacentes.

Para conceder esses papéis, use o console do Google Cloud :

Acessar "Papéis"

Funções do Gemini Data Analytics

Para permitir que os principais criem agentes da API Conversational Analytics e usem o método de chat com estado para conversas, conceda os seguintes papéis do IAM:

• Criador de agentes de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentCreator): necessário para começar a criar agentes apenas no BigQuery, Looker e Data Studio Pro.
• Usuário do Gemini para Google Cloud (roles/cloudaicompanion.user): necessário para usar o método de chat com estado em conversas.

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 Controle de acesso da API Conversational Analytics com o IAM.

Papéis do BigQuery

Para permitir que os principais consultem fontes de dados do BigQuery usando a API Conversational Analytics, conceda os seguintes papéis do IAM:

• Usuário do BigQuery (roles/bigquery.user): necessário para acessar dados no BigQuery.
• Usuário do BigQuery Studio (roles/bigquery.studioUser): obrigatório se você usa o BigQuery Studio e a tela de dados.

Papéis do Looker

Para permitir que os principais consultem fontes de dados do Looker pela API Conversational Analytics, conceda os seguintes papéis do IAM:

• Usuário da instância do Looker (roles/looker.instanceUser): necessário para acessar dados de uma instância do Looker (Google Cloud Core).

Para usar a API Conversational Analytics e o recurso de análise de conversação, um usuário do Looker precisa receber um papel do Looker que contenha a permissão gemini_in_looker para os modelos com que ele interage.

Papéis de banco de dados

Para permitir que os principais consultem fontes de dados do AlloyDB, do Cloud SQL para MySQL, do Cloud SQL para PostgreSQL ou do Spanner usando a API Conversational Analytics, conceda os seguintes papéis do IAM:

• 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 Studio do Cloud SQL para MySQL e do Cloud SQL para PostgreSQL (roles/cloudsql.studioUser): necessário para usar o console Google Cloud e visualizar e gerenciar instâncias do Cloud SQL para MySQL e do Cloud SQL para PostgreSQL.
• Usuário da instância do Cloud SQL para MySQL e do Cloud SQL para PostgreSQL (roles/cloudsql.instanceUser): necessário para se conectar às instâncias do Cloud SQL para MySQL 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.

A seguir

• Saiba mais sobre o controle de acesso para a API Conversational Analytics.
• Saiba como configurar o VPC Service Controls para a API Conversational Analytics.

A seguir

• Saiba como autenticar sua fonte de dados e a API.
• Saiba como criar um agente de dados usando o SDK do Python.
• Saiba como criar um agente de dados usando HTTP e Python.