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 Google Cloud projet. L'API Conversational Analytics est la première fonctionnalité de l'API Data Analytics avec Gemini de la Google Cloud console.

Avant de commencer

Avant de pouvoir utiliser l'API Conversational Analytics, vous devez disposer d'un Google Cloud projet pouvant accéder 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 Google Cloud console, sur la page de sélection du projet, créez un Google Cloud projet ayant accès aux données que vous souhaitez utiliser avec l'API Conversational Analytics.

    Accéder au sélecteur de projet

Conditions requises pour 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.

Conditions requises pour AlloyDB

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

Conditions requises pour 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 décrites dans Avant de commencer.

Conditions requises pour 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 décrites dans Avant de commencer.

Conditions requises pour Spanner

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

Activer les API requises

Pour utiliser l'API Conversational Analytics, vous devez activer un ensemble d'API requises dans votre Google Cloud projet. 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 dans la Google Cloud console pour le Google Cloud projet que vous utiliserez avec l'API Conversational Analytics.

Activer l'API Gemini Data Analytics

Activer Gemini for Google Cloud API

Activer l'API BigQuery

gcloud

Avec Google Cloud CLI, exécutez les commandes gcloud services enable suivantes pour activer respectivement l'API Gemini Data Analytics, Gemini for Google Cloud API 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 Google Cloud projet.

API pour Colab Enterprise

Si vous prévoyez d'utiliser l'API Conversational Analytics à partir d'un environnement Colab Enterprise, activez également les API suivantes :

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) nécessitent des rôles IAM (Identity and Access Management) qui permettent d'accéder à l'API et aux sources de données sous-jacentes.

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

Accéder à la page "Rôles"

Rôles Gemini Data Analytics

Pour permettre aux comptes principaux de créer des agents d'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 comptes principaux d'interroger des sources de données BigQuery via l'API Conversational Analytics, attribuez les rôles IAM suivants :

Rôles Looker

Pour permettre aux comptes principaux d'interroger des sources de données Looker via l'API Conversational Analytics, attribuez 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 comptes principaux d'interroger des sources de données AlloyDB, Cloud SQL pour MySQL, Cloud SQL pour PostgreSQL ou Spanner via l'API Conversational Analytics, attribuez les rôles IAM suivants :

Étape suivante

Étape suivante