En esta página se describen los pasos para habilitar la API Conversational Analytics (a la que se accede a través de geminidataanalytics.googleapis.com) en tu proyecto de Google Cloud . La API Conversational Analytics es la primera función de la API Data Analytics con Gemini en la consola Google Cloud .
Antes de empezar
Para poder usar la API Conversational Analytics, debes tener un Google Cloud proyecto que pueda acceder a los datos con los que quieras trabajar. Para configurar tu proyecto, sigue estos pasos:
- Identifica los datos que quieres usar con la API Conversational Analytics. Puedes usar fuentes de datos como tablas de BigQuery, Exploraciones de Looker e informes de Looker Studio.
En la consola de Google Cloud, en la página del selector de proyectos, crea un proyecto Google Cloud que pueda acceder a los datos que quieras usar con la API Conversational Analytics.
Habilitar las APIs necesarias
Para usar la API Conversational Analytics, debes habilitar un conjunto de APIs obligatorias en tu Google Cloud proyecto. Si tienes previsto usar la API Conversational Analytics desde un entorno de Colab Enterprise, también debes habilitar APIs adicionales.
API obligatorias
consola
Habilita las siguientes APIs en la Google Cloud consola del Google Cloud proyecto que vayas a usar con la API Conversational Analytics.
Habilitar la API Data Analytics de Gemini
gcloud
Con la CLI de Google Cloud, ejecute los siguientes comandos gcloud services enable para habilitar la API Gemini Data Analytics, la API Gemini for Google Cloud y la 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
En los comandos de ejemplo de gcloud CLI anteriores, sustituye project_id por el ID de tu proyecto. Google Cloud
APIs de Colab Enterprise
Si tienes previsto usar la API Conversational Analytics desde un entorno de Colab Enterprise, habilita también las siguientes APIs:
Habilitar la API de Compute Engine
Conceder los roles necesarios
Para usar la API Conversational Analytics, concede los siguientes roles de gestión de identidades y accesos (IAM) en la Google Cloud consola a las entidades (como usuarios o cuentas de servicio) que necesiten interactuar con la API:
- Gemini para Google Cloud User (
roles/cloudaicompanion.user): se necesita para crear conversaciones gestionadas por Google Cloud. - Usuario de instancia de Looker (
roles/looker.instanceUser): se necesita para acceder a los datos de una instancia de Looker (servicio principal de Google Cloud). - Usuario de BigQuery (
roles/bigquery.user): se necesita para acceder a los datos de BigQuery. - Usuario de BigQuery Studio (
roles/bigquery.studioUser): obligatorio si usas BigQuery Studio y el lienzo de datos.
Además, los permisos para realizar acciones como gestionar agentes se controlan mediante los roles de Gemini Data Analytics, tal como se describe en el artículo Otorgar roles y permisos de gestión de identidades y accesos de la API Conversational Analytics.
Configuración adicional de Controles de Servicio de VPC
Si Controles de Servicio de VPC está habilitado en tu organización o en el Google Cloud proyecto que estás usando, añade a la lista de permitidas las siguientes APIs, que usa la API Conversational Analytics:
- 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: