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) 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:
- Identifica los datos que deseas usar con la API de Conversational Analytics. Puedes usar fuentes de datos, como tablas de BigQuery, Explorar de Looker y los informes de Looker Studio.
En la página del selector de proyectos de la consola de Google Cloud, crea un Google Cloud proyecto que pueda acceder a los datos que deseas usar con la API de Conversational Analytics.
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
Console
Habilita las siguientes APIs en la Google Cloud consola para el proyecto Google Cloud que usarás con la API de Conversational Analytics.
Habilita la API de Gemini Data Analytics
gcloud
Con Google Cloud CLI, 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 .
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 Compute Engine
Otorga roles necesarios
Para usar la API de Conversational Analytics, otorga los siguientes roles de Identity and Access Management (IAM) en la consola de Google Cloud a las entidades principales (como usuarios o cuentas de servicio) que necesiten interactuar con la API:
- Gemini for Google Cloud User (
roles/cloudaicompanion.user): Se requiere para crear conversaciones que administra Google Cloud. - Usuario de instancia de Looker (
roles/looker.instanceUser): Se requiere para acceder a los datos de una instancia de Looker (Google Cloud Core) - 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.
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 Cómo otorgar roles y permisos de IAM de la API de Conversational Analytics.
Configuración adicional para los Controles del servicio de VPC
Si los Controles del servicio de VPC están habilitados para tu organización o para el proyecto Google Cloud que usas, agrega las siguientes APIs, que usa la API de Conversational Analytics, a la lista de entidades permitidas:
- En
geminidataanalytics.googleapis.com, permite la siguiente API:projects.locations.chat
- En
aiplatform.googleapis.com, permite la siguiente API: - En
datacatalog.googleapis.com, permite las siguientes APIs: - En
bigquery.googleapis.com, permite las siguientes APIs: