Activer l'API Conversational Analytics

Cette page décrit la procédure à suivre pour activer l'API Conversational Analytics (accessible via geminidataanalytics.googleapis.com ou des points de terminaison régionaux) pour votre projetGoogle Cloud . L'API Conversational Analytics est la première fonctionnalité de l'API Data Analytics avec Gemini de la console Google Cloud .

Avant de commencer

Avant de pouvoir utiliser l'API Conversational Analytics, vous devez disposer d'un projet Google Cloudayant accès aux données que vous souhaitez utiliser. Pour configurer votre projet, procédez comme suit :

  1. Identifiez les données que vous souhaitez utiliser avec l'API Conversational Analytics. Vous pouvez utiliser des sources de données telles que des tables BigQuery, des explorations Looker, des rapports Data Studio et des données provenant d'AlloyDB pour PostgreSQL, de GoogleSQL pour Spanner, de Cloud SQL pour MySQL et de Cloud SQL pour PostgreSQL.

  2. Dans la console Google Cloud , sur la page de sélection du projet, créez un projet Google Cloud ayant accès aux données que vous souhaitez utiliser avec l'API Conversational Analytics.

    Accéder au sélecteur de projet

Exigences concernant Looker et Data Studio Pro

Si vous utilisez l'API Conversational Analytics avec Looker, votre instance Looker doit répondre à des exigences spécifiques :

Pour utiliser l'API Conversational Analytics avec Data Studio Pro, votre abonnement Pro doit se trouver en dehors d'un périmètre VPC-SC.

Exigences AlloyDB

Si vous utilisez l'API Conversational Analytics avec AlloyDB, votre instance AlloyDB doit répondre à des exigences spécifiques. Suivez toutes les étapes de la section Avant de commencer.

Exigences de Cloud SQL pour MySQL

Si vous utilisez l'API Conversational Analytics avec Cloud SQL pour MySQL, votre instance Cloud SQL doit répondre à des exigences spécifiques. Suivez toutes les étapes de la section Avant de commencer.

Exigences Cloud SQL pour PostgreSQL

Si vous utilisez l'API Conversational Analytics avec Cloud SQL pour PostgreSQL, votre instance Cloud SQL doit répondre à des exigences spécifiques. Suivez toutes les étapes de la section Avant de commencer.

Exigences concernant Spanner

Si vous utilisez l'API Conversational Analytics avec Spanner, votre instance Spanner doit répondre à des exigences spécifiques. Suivez toutes les étapes de la section Avant de commencer.

Activer les API requises

Pour utiliser l'API Conversational Analytics, vous devez activer un ensemble d'API requises dans votre projet Google Cloud . Si vous prévoyez d'utiliser l'API Conversational Analytics à partir d'un environnement Colab Enterprise, vous devez également activer des API supplémentaires.

API requises

Console

Activez les API suivantes, si elles ne le sont pas déjà, pour le projetGoogle Cloud que vous utiliserez avec l'API Conversational Analytics.

Activer l'API Gemini Data Analytics

Activer l'API Gemini pour Google Cloud

Activer l'API BigQuery

gcloud

Avec la Google Cloud CLI, exécutez les commandes gcloud services enable suivantes pour activer respectivement l'API Gemini Data Analytics, l'API Gemini pourGoogle Cloud et l'API BigQuery :

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

Dans les exemples de commandes gcloud CLI précédents, remplacez project_id par l'ID de votre projet Google Cloud .

API pour Colab Enterprise

Si vous prévoyez d'utiliser l'API Conversational Analytics à partir d'un environnement Colab Enterprise, vérifiez également que les API suivantes sont activées :

Activer l'API Dataform

Activer l'API Compute Engine

Activer l'API Vertex AI

Attribuer les rôles requis

Pour utiliser l'API Conversational Analytics, les comptes principaux (tels que les utilisateurs ou les comptes de service) ont besoin de rôles Identity and Access Management (IAM) qui leur donnent accès à l'API et aux sources de données sous-jacentes.

Pour accorder ces rôles, utilisez la console Google Cloud  :

Accéder à la page "Rôles"

Rôles Gemini Data Analytics

Pour permettre aux comptes principaux de créer des agents de l'API Conversational Analytics et d'utiliser la méthode de chat avec état pour les conversations, attribuez les rôles IAM suivants :

De plus, les autorisations pour des actions telles que la gestion des agents sont contrôlées par les rôles Gemini Data Analytics, comme décrit dans Contrôle des accès à l'API Conversational Analytics avec IAM.

Rôles BigQuery

Pour permettre aux principaux d'interroger des sources de données BigQuery via l'API Conversational Analytics, accordez les rôles IAM suivants :

Rôles Looker

Pour permettre aux comptes principaux d'interroger les sources de données Looker via l'API Conversational Analytics, accordez les rôles IAM suivants :

Pour utiliser Conversational Analytics et l'API Conversational Analytics, un utilisateur Looker doit disposer d'un rôle Looker contenant l'autorisation gemini_in_looker pour les modèles avec lesquels il interagit.

Rôles de base de données

Pour permettre aux principaux d'interroger les sources de données AlloyDB, Cloud SQL pour MySQL, Cloud SQL pour PostgreSQL ou Spanner via l'API Conversational Analytics, accordez les rôles IAM suivants :

Étapes suivantes

Étapes suivantes