Intégrer à Agent Platform

Cette page explique comment configurer l'intégration entre AlloyDB pour PostgreSQL et Gemini Enterprise Agent Platform, ce qui vous permet d'envoyer des requêtes qui transmettent vos données aux modèles Agent Platform.

Ces instructions concernent spécifiquement l'utilisation d'AlloyDB, et non d'AlloyDB Omni. Pour intégrer une installation locale d' AlloyDB Omni à l'aide d'Agent Platform, consultez Installer AlloyDB Omni avec AlloyDB AI.

Pour en savoir plus sur l'utilisation de modèles de ML avec AlloyDB, consultez Créer des applications d'IA générative à l'aide d'AlloyDB AI.

Pour en savoir plus sur Agent Platform, consultez Présentation d'Agent Platform.

Avant de commencer

  1. Connectez-vous à votre Google Cloud compte. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Agent Platform API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. Installez la Google Cloud CLI.

  6. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  7. Pour initialiser la gcloud CLI, exécutez la commande suivante : 

    gcloud init

  8. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  9. Verify that billing is enabled for your Google Cloud project.

  10. Enable the Agent Platform API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  11. Installez la Google Cloud CLI.

  12. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  13. Pour initialiser la gcloud CLI, exécutez la commande suivante : 

    gcloud init

À propos de l'agent de service AlloyDB

Lorsque vous utilisez AlloyDB avec d'autres Google Cloud services, AlloyDB utilise un agent de service Identity and Access Management (IAM) pour s'authentifier auprès de ces services. Cet agent de service est un compte principal IAM contrôlé par AlloyDB. Vous attribuez des rôles IAM à cet agent de service pour lui permettre d'accéder à d'autres Google Cloud services en votre nom.

Attribuer le rôle Vertex AI User à l'agent de service AlloyDB

Pour activer l'intégration de la base de données à Agent Platform, vous attribuez le rôle Vertex AI User à l'agent de service AlloyDB. Cela permet à l'agent de service AlloyDB d'accéder à Agent Platform en votre nom.

Procédez comme suit pour attribuer le rôle Vertex AI User à l'agent de service AlloyDB :

Ajoutez des autorisations Agent Platform à l'agent de service AlloyDB pour le projet dans lequel se trouve le cluster de la base de données AlloyDB :

Console

  1. Accédez à la page Bienvenue de la Google Cloud console, puis copiez le numéro de projet du projet contenant des clusters ou des instances AlloyDB. Vous utiliserez ce numéro de projet lors des prochaines étapes.

    Accéder à la page d'accueil

  2. Dans la Google Cloud console, accédez à la page IAM.

    Accéder à IAM

  3. Sélectionnez le projet qui doit appeler les points de terminaison Agent Platform.

  4. Activez l'option Inclure les attributions de rôle fournies par Google.

  5. Cliquez sur Accorder l'accès.

  6. Dans le champ Nouveaux comptes principaux, saisissez les éléments suivants :

        service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com

    Remplacez PROJECT_NUMBER par le numéro de projet.

  7. Dans le champ Rôle, saisissez Utilisateur Vertex AI.

  8. Cliquez sur Enregistrer.

gcloud

Pour utiliser la gcloud CLI, vous pouvez installer et initialiser la Google Cloud CLI, ou vous pouvez utiliser Cloud Shell.

        gcloud projects add-iam-policy-binding PROJECT_ID 

        --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com" 

        --role="roles/aiplatform.user"

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet contenant le point de terminaison Agent Platform.
  • PROJECT_NUMBER : numéro de projet du projet contenant des clusters ou des instances AlloyDB.

Vérifier l'extension installée

Vérifiez si google_ml_integration est installé dans la base de données contenant les données sur lesquelles vous souhaitez effectuer des prédictions :

Console

  1. Dans la console Google Cloud , accédez à la page Clusters.

    accéder aux clusters

  2. Pour afficher la page Présentation du cluster, cliquez sur le nom du cluster AlloyDB dans la colonne Nom de la ressource.

  3. Dans le menu de navigation, cliquez sur AlloyDB Studio.

  4. Sur la page Se connecter à AlloyDB Studio , authentifiez-vous à l'aide du nom de votre base de données, de votre nom d'utilisateur et de votre mot de passe.

  5. Dans l'onglet Éditeur 1, procédez comme suit :

    1. Vérifiez que la version 1.4.2 ou ultérieure de l'extension google_ml_integration est installée :

      SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

    2. Cliquez sur Exécuter. Attendez que la version de l'extension s'affiche dans le volet Résultats.

psql

  1. Connectez un client psql à l'instance principale du cluster, comme décrit dans Connecter un client psql à une instance.

  2. À l'invite de commande psql, connectez-vous à la base de données : 

    \c DB_NAME

    Remplacez DB_NAME par le nom de la base de données sur laquelle vous souhaitez installer l'extension.

  3. Vérifiez que la version 1.4.2 ou ultérieure de l'extension google_ml_integration est installée : 

    SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

Étape suivante