Habilita la API de Conversational Analytics

En esta página, se describen los pasos para habilitar la API de Conversational Analytics (a la que se accede a través de geminidataanalytics.googleapis.com o de extremos regionales) para tu proyecto de Google Cloud . La API de Conversational Analytics es la primera función de la API de Data Analytics with Gemini en la consola de Google Cloud .

Antes de comenzar

Antes de usar la API de Conversational Analytics, debes tener un proyecto Google Cloud que pueda acceder a los datos con los que deseas trabajar. Para configurar tu proyecto, completa los siguientes pasos:

1. Identifica los datos que deseas usar con la API de Conversational Analytics. Puedes usar fuentes de datos como tablas de BigQuery, Explorar de Looker, informes de Data Studio y datos de AlloyDB para PostgreSQL, GoogleSQL para Spanner, Cloud SQL para MySQL y Cloud SQL para PostgreSQL.

2. En la consola de Google Cloud , en la página del selector de proyectos, crea un proyecto de Google Cloud que pueda acceder a los datos que deseas usar con la API de Conversational Analytics.

   Nota: Por el momento, no se factura la API de Conversational Analytics.

   Ir al selector de proyectos

Requisitos de Looker y Data Studio Pro

Si usas la API de Conversational Analytics con Looker, tu instancia de Looker debe cumplir con requisitos específicos:

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

Para usar la API de Conversational Analytics con Data Studio Pro, tu suscripción a Pro debe estar fuera de un perímetro de VPC-SC.

Requisitos de AlloyDB

Si usas la API de Conversational Analytics con AlloyDB, tu instancia de AlloyDB debe cumplir con requisitos específicos. Completa todos los pasos en Antes de comenzar.

Requisitos de Cloud SQL para MySQL

Si usas la API de Conversational Analytics con Cloud SQL para MySQL, tu instancia de Cloud SQL debe cumplir con requisitos específicos. Completa todos los pasos de Antes de comenzar.

Requisitos de Cloud SQL para PostgreSQL

Si usas la API de Conversational Analytics con Cloud SQL para PostgreSQL, tu instancia de Cloud SQL debe cumplir con requisitos específicos. Completa todos los pasos de Antes de comenzar.

Requisitos de Spanner

Si usas la API de Conversational Analytics con Spanner, tu instancia de Spanner debe cumplir con requisitos específicos. Completa todos los pasos de Antes de comenzar.

Habilite las API necesarias

Para usar la API de Conversational Analytics, debes habilitar un conjunto de APIs obligatorias en tu proyecto de Google Cloud . Si planeas usar la API de Conversational Analytics desde un entorno de Colab Enterprise, también debes habilitar APIs adicionales.

APIs requeridas

Nota: Si no tienes permiso para habilitar las APIs, pídele al administrador del proyecto que las habilite por ti desde el panel de APIs y servicios. Como alternativa, el administrador del proyecto puede otorgarte el rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin) en la consola de Google Cloud , lo que te permite habilitar y, luego, inhabilitar las APIs para el proyecto actual.

Console

Habilita las siguientes APIs en la consola de Google Cloud para el proyecto Google Cloud que usarás con la API de Conversational Analytics.

Habilita la API de Gemini Data Analytics

Habilita la API de Gemini para Google Cloud

Habilita la API de BigQuery

Nota: Cuando habilites una API, es posible que debas actualizar la página de la consola de Google Cloud para confirmar que se habilitó.

gcloud

Con la CLI de Google Cloud, ejecuta los siguientes comandos de gcloud services enable para habilitar la API de Gemini Data Analytics, la API de Gemini para Google Cloud y la API de 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

En los comandos de gcloud CLI del ejemplo anterior, reemplaza project_id por el ID de tu proyecto de Google Cloud .

Nota: Habilita la API de BigQuery solo si usas BigQuery.

APIs para Colab Enterprise

Si planeas usar la API de Conversational Analytics desde un entorno de Colab Enterprise, también debes habilitar las siguientes APIs:

Habilita la API de Dataform

Habilita la API de Compute Engine

Habilita la API de Vertex AI

Nota: Cuando habilites una API, es posible que debas actualizar la página de la consola de Google Cloud para confirmar que se habilitó.

Otorga roles necesarios

Para usar la API de Conversational Analytics, los principales (como los usuarios o las cuentas de servicio) requieren roles de Identity and Access Management (IAM) que proporcionen acceso a la API y a las fuentes de datos subyacentes.

Para otorgar estos roles, usa la consola de Google Cloud :

Ir a Funciones

Roles de Gemini Data Analytics

Para permitir que las entidades principales creen agentes de la API de Conversational Analytics y usen el método de chat con estado para las conversaciones, otorga los siguientes roles de IAM:

• Creador de agentes de datos de Gemini Data Analytics (roles/geminidataanalytics.dataAgentCreator): Se requiere para comenzar a crear agentes solo en BigQuery, Looker y Data Studio Pro.
• Gemini for Google Cloud User (roles/cloudaicompanion.user): Se requiere para usar el método de chat con estado para las conversaciones.

Además, los permisos para acciones como la administración de agentes se controlan con los roles de Gemini Data Analytics, como se describe en Control de acceso a la API de Conversational Analytics con IAM.

Funciones de BigQuery

Para permitir que las entidades principales consulten fuentes de datos de BigQuery a través de la API de Conversational Analytics, otorga los siguientes roles de IAM:

• Usuario de BigQuery (roles/bigquery.user): Se requiere para acceder a los datos en BigQuery.
• Usuario de BigQuery Studio (roles/bigquery.studioUser): Se requiere si usas BigQuery Studio y el lienzo de datos.

Funciones de Looker

Para permitir que las entidades principales consulten fuentes de datos de Looker a través de la API de Conversational Analytics, otorga los siguientes roles de IAM:

• Usuario de instancia de Looker (roles/looker.instanceUser): Se requiere para acceder a los datos de una instancia de Looker (Google Cloud Core).

Para usar Conversational Analytics y la API de Conversational Analytics, se debe asignar a un usuario de Looker un rol de Looker que contenga el permiso gemini_in_looker para los modelos con los que interactúa.

Roles de bases de datos

Para permitir que las entidades principales consulten fuentes de datos de AlloyDB, Cloud SQL para MySQL, Cloud SQL para PostgreSQL o Spanner a través de la API de Conversational Analytics, otorga los siguientes roles de IAM:

• Usuario de base de datos de AlloyDB (roles/alloydb.databaseUser): Se requiere para acceder a los datos de una instancia de AlloyDB.
• Usuario de Cloud SQL para MySQL y Cloud SQL para PostgreSQL Studio (roles/cloudsql.studioUser): Se requiere para usar la consola de Google Cloud para ver y administrar instancias de Cloud SQL para MySQL y Cloud SQL para PostgreSQL.
• Usuario de instancia de Cloud SQL para MySQL y Cloud SQL para PostgreSQL (roles/cloudsql.instanceUser): Se requiere para conectarse a instancias de Cloud SQL para MySQL y Cloud SQL para PostgreSQL.
• Lector de base de datos de Spanner (roles/spanner.databaseReader): Se requiere para leer datos de una base de datos de GoogleSQL para Spanner.

¿Qué sigue?

• Obtén más información sobre el control de acceso a la API de Conversational Analytics.
• Obtén información para configurar los Controles del servicio de VPC para la API de Conversational Analytics.

¿Qué sigue?

• Obtén información para autenticarte en tu fuente de datos y en la API.
• Aprende a compilar un agente de datos con el SDK de Python.
• Obtén más información para compilar un agente de datos con HTTP y Python.