Configurer un data store Google Agenda

Cette page explique comment créer un data store et associer Google Agenda à Gemini Enterprise.

Avant de commencer

  • Connectez-vous à la console Google Cloud avec le même compte que celui que vous utilisez pour l'instance Google Workspace que vous prévoyez d'associer. Vertex AI Search utilise votre numéro client Google Workspace pour se connecter à Google Agenda.

  • Pour appliquer le contrôle des accès aux sources de données et sécuriser les données dans Gemini Enterprise, assurez-vous d'avoir configuré votre fournisseur d'identité.

  • Avant d'ajouter des actions au data store Google Agenda, un administrateur Google Cloud doit d'abord suivre les étapes de la section Configurer l'authentification et les autorisations pour Google Agenda afin de configurer l'authentification OAuth 2.0 pour vous fournir l'ID client et le code secret du client, et configurer les niveaux d'accès.

Créer le datastore Google Agenda

Pour créer le datastore Google Agenda, procédez comme suit :

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

  2. Sélectionnez ou créez un projet Google Cloud .

  3. Dans le menu de navigation, cliquez sur Datastores.

  4. Cliquez sur Créer un datastore.

  5. Dans la section Source, recherchez Google Agenda, puis cliquez sur Sélectionner.

  6. Dans la section Actions :

    1. Saisissez l'ID client et le code secret du client obtenus à partir de l'application OAuth 2.0, puis cliquez sur Vérifier l'authentification.

      Pour en savoir plus, consultez Créer des identifiants client OAuth. Pour connaître les niveaux d'accès requis pour la recherche et les actions, consultez Niveaux d'accès requis.

    2. Facultatif : Développez Paramètres avancés et saisissez le Nom du service, c'est-à-dire le nom de ressource de votre service créé dans l'annuaire des services au sein de votre projet Google Cloud . Ce champ est obligatoire lorsque VPC Service Controls est activé.

    3. Choisissez les actions dans la liste afin de les activer pour le connecteur Google Agenda.

    Pour afficher et gérer la liste des actions, consultez Afficher et gérer les actions.

  7. Cliquez sur Continuer.

  8. Dans la section Configuration :

    1. Dans la liste Multirégional, sélectionnez l'emplacement de votre connecteur de données.
    2. Dans le champ Nom du connecteur de données, saisissez le nom de votre connecteur.
    3. Si vous avez sélectionné l'emplacement US ou EU, configurez les paramètres de chiffrement :
      • Sélectionnez Clé de chiffrement gérée parGoogle ou Clé Cloud KMS.
      • Si vous avez sélectionné Clé Cloud KMS :
        • Dans la liste Type de gestion des clés, sélectionnez le type approprié.
        • Dans la liste Clé Cloud KMS, sélectionnez la clé.
      Pour en savoir plus, consultez Clés de chiffrement gérées par le client.

  9. Cliquez sur Continuer.

  10. Dans la section Facturation, sélectionnez Tarification générale ou Tarification configurable. Pour en savoir plus, consultez Vérifier l'état de facturation de vos projets et Licences.

  11. Cliquez sur Créer. Gemini Enterprise crée votre datastore et l'affiche sur la page Datastores.

Sur la page Datastores, cliquez sur le nom de votre datastore pour afficher l'état. Lorsque l'état du data store passe de Création à Actif, le connecteur Google Agenda est prêt à être utilisé.

Après avoir créé le datastore, créez une application et associez-la au datastore Google Agenda avant d'exécuter la requête.

Exécution de la requête

Après avoir autorisé Google Agenda, lorsque vous saisissez une requête de recherche :

  1. Gemini Enterprise envoie votre requête de recherche à l'API Google Calendar.

  2. Gemini Enterprise fusionne les résultats avec ceux des autres sources et les affiche.

Messages d'erreur et dépannage

Le tableau suivant décrit les messages d'erreur, y compris les codes d'erreur HTTP et la procédure de dépannage suggérée, que vous pouvez rencontrer lorsque vous utilisez cette source de données Google .

Code d'erreur Message d'erreur Description Dépannage
403 Autorisation refusée La recherche à l'aide des identifiants de compte de service n'est pas compatible avec les datastores Google Workspace. Le moteur dans lequel la recherche est effectuée comporte des datastores Google Workspace, et les identifiants transmis sont ceux d'un compte de service. La recherche à l'aide des identifiants de compte de service dans les datastores Google Workspace n'est pas prise en charge. Appelez le service de recherche à l'aide des identifiants utilisateur ou supprimez les datastores Google Workspace du moteur.
403 Autorisation refusée Les comptes personnels ne sont pas compatibles avec les datastores Google Workspace. Le service de recherche est appelé à l'aide d'un identifiant de compte personnel (@gmail.com), qui n'est pas compatible avec les datastores Google Workspace. Supprimez les datastores Google Workspace du moteur ou utilisez un compte Google géré.
403 Autorisation refusée Non-concordance du numéro client pour le datastore La recherche n'est autorisée que pour les utilisateurs appartenant à la même organisation que les datastores Google Workspace. Supprimez les datastores Google Workspace du moteur ou contactez l'assistance si l'utilisateur et les datastores Google Workspace sont censés se trouver dans des organisations différentes.
403 Autorisation refusée L'administrateur de l'organisation a désactivé l'accès à Workspace pour Agentspace. Un administrateur Google Workspace a désactivé l'accès aux données Google Workspace pour Gemini Enterprise. Contactez votre administrateur Google Workspace pour [activer l'accès](https://support.google.com/a/answer/16479199).

Étape suivante