Ajouter des actions Google Agenda et Gmail

La page suivante explique comment configurer les actions de l'assistant pour Google Agenda et Gmail.

Actions Google Agenda

Lorsque les actions Google Agenda sont activées, les utilisateurs finaux peuvent demander à l'assistant de créer des événements Google Agenda pour eux.

Par exemple, un utilisateur peut saisir "planifie une réunion avec [e-mail] à 15h demain". Si nécessaire, l'assistant demande des informations supplémentaires, puis demande à l'utilisateur de confirmer la création de l'événement.

L'assistant peut lire et modifier les champs suivants de Google Agenda grâce à des actions :

Champ	Description
Participants	Obligatoire. Liste des adresses e-mail des participants. L'utilisateur qui envoie la demande est automatiquement ajouté à la liste.
Titre	Titre de la réunion.
Heure de début	Heure de début de la réunion.
Durée	Durée de la réunion. La valeur par défaut est de 30 minutes.
Fuseau horaire	Fuseau horaire de la réunion. Si ce champ n'est pas spécifié, le fuseau horaire de l'utilisateur est utilisé.
Description	Description de la réunion.

Configurer l'authentification et les autorisations pour Google Agenda

Avant d'activer les actions Google Agenda, un administrateur a Google Cloud doit activer l'API Google Agenda et configurer l'autorisation comme suit.

Activer l'API Google Calendar

Dans la console Google Cloud , activez les API suivantes :

• API Google Calendar : activer l'API.

• API Google People : activez l'API.

Créer une application OAuth et ajouter des habilitations

Si vous n'avez pas d'application OAuth, suivez ces étapes. Si vous disposez déjà d'une application OAuth, passez à Créer des identifiants client OAuth.

1. Accédez à Google Auth Platform/Présentation.

2. Cliquez sur Commencer.

3. Saisissez un nom pour votre application OAuth.

4. Saisissez une adresse e-mail d'assistance aux utilisateurs.

5. Sélectionnez Interne.

6. Saisissez les coordonnées du développeur.

7. Cliquez sur Créer.

Créer des identifiants client OAuth

Cette procédure explique comment créer un ID client OAuth pour les actions Google Cloud. Ce code secret et cet ID client OAuth peuvent également être utilisés pour d'autres actions Google Cloud. Si vous disposez déjà d'un ID client OAuth Google Cloud pour les actions Google Cloud, vous pouvez utiliser cet ID client et ce code secret pour les actions Google Agenda au lieu d'en créer un autre.

1. Accédez à Google Auth Platform/Clients.

2. Cliquez sur Créer un client.

3. Dans le champ Type d'application, sélectionnez Application Web.

4. Dans Nom, saisissez un nom pour votre ID client.

5. Dans la section URI de redirection autorisés, cliquez sur Ajouter un URI et saisissez l'URI suivant : https://vertexaisearch.cloud.google.com/oauth-redirect

6. Cliquez sur Créer et copiez les informations suivantes :

   • ID client
   • Code secret du client

Ajouter une action Google Agenda

Pour créer une action Google Agenda à l'aide de la console ou de l'API, procédez comme suit :

Avant de commencer

Avant de pouvoir ajouter une action Google Agenda, assurez-vous de disposer des prérequis nécessaires, y compris d'une application existante et des informations d'authentification.

• Un administrateur Google Cloud doit d'abord suivre les étapes de la section Configurer l'authentification et les autorisations pour Google Agenda et vous fournir l'ID client et le code secret du client avant que vous puissiez ajouter des actions.

• Vous devez disposer d'une application Gemini Enterprise existante connectée à un datastore Google Agenda. Pour créer une application, consultez Créer une application.

• Si vous avez récemment activé l'API Discovery Engine dans votre projet Google Cloud et créé une application, attendez au moins 15 minutes que la configuration de l'application soit terminée avant de configurer les actions Google Agenda.

Configurer les actions Google Agenda

Console

Pour ajouter des actions à votre application à l'aide de la console, procédez comme suit :

1. Dans Gemini Enterprise, accédez à la page Gemini Enterprise.
2. Choisissez votre application Gemini Enterprise.
3. Dans le menu de navigation, cliquez sur Actions.

4. Ajoutez une action :

   • S'il s'agit de votre première action, cliquez sur Ajouter une action.

   • Si vous avez déjà créé des actions, cliquez sur Créer.

5. Pour Google Agenda, cliquez sur Connect (Associer).

6. Saisissez un nom pour votre connecteur d'action.

7. Saisissez les informations d'autorisation pour votre connecteur d'action :

   1. Dans les champs Nouvel ID client et Nouveau code secret client, saisissez l'ID client et le code secret du client créés par votre administrateur dans la section Créer des identifiants client OAuth.
   2. Cliquez sur Vérifier l'authentification et accordez à l'application Gemini Enterprise l'accès à votre agenda Google.

8. Sélectionnez les actions à activer.

9. Cliquez sur Terminer la configuration. Votre action s'affiche sur la page Actions.

REST

Pour ajouter des actions à votre application à l'aide de l'API, procédez comme suit.

1. Créez un connecteur d'action pour l'action Google Agenda.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-GFE-SSL: yes" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
   -d '{
     "collection_id":"CONNECTOR_ID",
     "collection_display_name":"CONNECTOR_DISPLAY_NAME",
     "data_connector":{
         "data_source":"google_calendar",
         "action_config":{
           "is_action_configured":true,
           "action_params":{
               "client_id":"CLIENT_ID",
               "client_secret":"CLIENT_SECRET"
           }
         },
         "connector_modes": ["ACTIONS"]
     }
   }'
   

   • PROJECT_ID : ID du projet dans lequel vous souhaitez créer le connecteur d'action Google Agenda.
   • LOCATION : multirégion de votre connecteur d'action Google Agenda : global, us ou eu.
   • CONNECTOR_ID : ID du connecteur que vous souhaitez créer. Cet ID ne peut contenir que des lettres minuscules, des chiffres, des traits de soulignement et des traits d'union.
   • CONNECTOR_DISPLAY_NAME : nom à afficher du connecteur que vous souhaitez créer.
   • CLIENT_ID : ID client créé par votre administrateur dans Créer des identifiants client OAuth.
   • CLIENT_SECRET : code secret du client créé par votre administrateur dans Créer des identifiants client OAuth.

2. Associez le connecteur d'action Google Agenda que vous avez créé à une application existante.

   Remarque : Si des actions sont déjà configurées pour votre application, l'exécution de la commande suivante les dissocie. Pour conserver les actions existantes et associer l'action Google Agenda, vous devez inclure les détails de vos actions existantes dans la requête API. Pour en savoir plus, consultez Associer les actions Google Agenda et Gmail à une application.

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
   -d '{
     "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
     "enabled_tools": {
       "projects/PROJECT_ID/locations/LOCATION/collections/CONNECTOR_ID/dataConnector": {
         "tool_info": [
           {
             "tool_name": "create_calendar_event",
             "tool_display_name": "Create Calendar Event"
           }
         ]
       }
     }
   }'
   

   • PROJECT_ID : ID du projet dans lequel se trouvent votre application et le connecteur d'action Google Agenda.
   • LOCATION : région multirégionale de votre application et de votre connecteur d'action : global, us ou eu.
   • APP_ID : ID de l'application à laquelle vous souhaitez associer l'action.
   • CONNECTOR_ID : ID du connecteur d'action Google Agenda créé à l'étape précédente.

Une fois que vous avez ajouté des actions, l'assistant peut les effectuer au nom de vos utilisateurs finaux dans l'application. La première fois qu'un utilisateur demande à l'assistant d'effectuer une action Google Agenda, il est invité à autoriser l'accès à son compte Google Agenda.

Actions dans Gmail

Lorsque les actions Gmail sont activées, les utilisateurs finaux peuvent demander à l'assistant d'envoyer des e-mails à leur place.

Par exemple, un utilisateur peut saisir "envoie un e-mail à [e-mail] avec le titre 'Salut' et le contenu 'comment vas-tu ?'". L'assistant demande des informations supplémentaires si nécessaire, puis demande à l'utilisateur de confirmer l'envoi de l'e-mail.

L'assistant peut lire et modifier les champs Gmail suivants grâce à des actions :

Champ	Description
À	Obligatoire. Liste des adresses e-mail des destinataires.
Objet	Obligatoire. Objet de l'e-mail
Contenu	Obligatoire. Contenu de l'e-mail au format Markdown.
CC	Liste des destinataires en copie Cc de l'e-mail.
BCC	Liste des destinataires en Cci de l'e-mail.

Configurer l'authentification et les autorisations pour Gmail

Avant d'activer les actions Gmail, un administrateur Google Cloud doit activer l'API Gmail et configurer l'autorisation.

Activer l'API Gmail

Dans la console Google Cloud , activez les API suivantes :

• API Gmail : activez l'API.

• API Google People : activez l'API.

Créer une application OAuth et ajouter des habilitations

Si vous n'avez pas d'application OAuth, suivez ces étapes. Si vous disposez déjà d'une application OAuth, passez à Créer des identifiants client OAuth.

1. Accédez à Google Auth Platform/Présentation.

2. Cliquez sur Commencer.

3. Saisissez un nom pour votre application OAuth.

4. Saisissez une adresse e-mail d'assistance aux utilisateurs.

5. Sélectionnez Interne.

6. Saisissez les coordonnées du développeur.

7. Cliquez sur Créer.

Créer des identifiants client OAuth

Cette procédure explique comment créer un ID client OAuth pour les actions Google Cloud. Ce code secret et cet ID client OAuth peuvent également être utilisés pour d'autres actions Google Cloud. Si vous disposez déjà d'un ID client OAuth Google Cloud pour les actions Google Cloud, vous pouvez utiliser cet ID client et ce code secret pour les actions Google Agenda au lieu d'en créer un autre.

1. Accédez à Google Auth Platform/Clients.

2. Cliquez sur Créer un client.

3. Dans le champ Type d'application, sélectionnez Application Web.

4. Dans Nom, saisissez un nom pour votre ID client.

5. Dans la section URI de redirection autorisés, cliquez sur Ajouter un URI et saisissez l'URI suivant : https://vertexaisearch.cloud.google.com/oauth-redirect

6. Cliquez sur Créer et copiez les informations suivantes :

   • ID client
   • Code secret du client

Ajouter une action Gmail

Pour créer une action Gmail à l'aide de la console ou de l'API, procédez comme suit :

Avant de commencer

Avant d'ajouter une action Gmail, assurez-vous de disposer des prérequis nécessaires, y compris d'une application existante et des informations d'authentification.

• Un administrateur Google Cloud doit d'abord suivre les étapes de la section Configurer l'authentification et les autorisations pour Gmail et vous fournir l'ID client et le code secret du client avant que vous puissiez ajouter des actions.

• Vous devez disposer d'une application Gemini Enterprise existante connectée à un datastore Gmail. Pour créer une application, consultez Créer une application.

• Si vous avez récemment activé l'API Discovery Engine dans votre projet Google Cloud et créé une application, attendez au moins 15 minutes que la configuration de l'application soit terminée avant de configurer les actions Gmail.

Configurer les actions Gmail

Console

Pour ajouter des actions à votre application à l'aide de la console, procédez comme suit :

1. Dans Gemini Enterprise, accédez à la page Gemini Enterprise.
2. Choisissez votre application Gemini Enterprise.
3. Dans le menu de navigation, cliquez sur Actions.

4. Ajoutez une action :

   • S'il s'agit de votre première action, cliquez sur Ajouter une action.

   • Si vous avez déjà créé des actions, cliquez sur Créer.

5. Pour Gmail, cliquez sur Connecter.

6. Saisissez un nom pour votre connecteur d'action.

7. Saisissez les informations d'autorisation pour votre connecteur d'action :

   1. Dans les champs Nouvel ID client et Nouveau code secret client, saisissez l'ID client et le code secret du client créés par votre administrateur dans la section Créer des identifiants client OAuth.
   2. Cliquez sur Verify Auth (Valider l'authentification) et accordez à l'application Gemini Enterprise l'accès à votre compte Gmail.

8. Sélectionnez les actions à activer.

9. Cliquez sur Terminer la configuration. Votre action s'affiche sur la page Actions.

REST

Pour ajouter des actions à votre application à l'aide de l'API, procédez comme suit.

1. Créez un connecteur d'action pour l'action Gmail.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-GFE-SSL: yes" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
   -d '{
     "collection_id":"CONNECTOR_ID",
     "collection_display_name":"CONNECTOR_DISPLAY_NAME",
     "data_connector":{
         "data_source":"gmail",
         "action_config":{
           "is_action_configured":true,
           "action_params":{
               "client_id":"CLIENT_ID",
               "client_secret":"CLIENT_SECRET"
           }
         },
         "connector_modes": ["ACTIONS"]
     }
   }'
   

   • PROJECT_ID : ID du projet dans lequel vous souhaitez créer le connecteur d'action Gmail.
   • LOCATION : région multirégionale de votre connecteur d'actions Gmail : global, us ou eu.
   • CONNECTOR_ID : ID du connecteur que vous souhaitez créer. Cet ID ne peut contenir que des lettres minuscules, des chiffres, des traits de soulignement et des traits d'union.
   • CONNECTOR_DISPLAY_NAME : nom à afficher du connecteur que vous souhaitez créer.
   • CLIENT_ID : ID client créé par votre administrateur dans Créer des identifiants client OAuth.
   • CLIENT_SECRET : code secret du client créé par votre administrateur dans Créer des identifiants client OAuth.

2. Associez le connecteur d'action Gmail que vous avez créé à une application existante.

   Remarque : Si des actions sont déjà configurées pour votre application, l'exécution de la commande suivante les dissocie. Pour conserver les actions existantes et associer l'action Gmail, vous devez inclure les détails de vos actions existantes dans la requête API. Pour en savoir plus, consultez Associer les actions Google Agenda et Gmail à une application.

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
   -d '{
     "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
     "enabled_tools": {
       "projects/PROJECT_ID/locations/LOCATION/collections/CONNECTOR_ID/dataConnector": {
         "tool_info": [
           {
             "tool_name": "send_email",
             "tool_display_name": "Send Email"
           }
         ]
       }
     }
   }'
   

   • PROJECT_ID : ID du projet dans lequel se trouvent votre application et le connecteur d'actions Gmail.
   • LOCATION : emplacement multirégional de votre application et de votre connecteur : global, us ou eu.
   • APP_ID : ID de l'application à laquelle vous souhaitez associer l'action.
   • CONNECTOR_ID : ID du connecteur d'action Gmail créé à l'étape précédente.

Une fois que vous avez ajouté des actions, l'assistant peut les effectuer au nom de vos utilisateurs finaux dans l'application. La première fois qu'un utilisateur demande à l'assistant d'effectuer une action Gmail, il est invité à autoriser l'accès à son compte Gmail.

Associer des actions Google Agenda et Gmail à une application

La requête API suivante montre comment associer les actions Google Agenda et Gmail à une application existante.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
   "name":"projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
   "enabled_tools":{
      "projects/PROJECT_ID/locations/LOCATION/collections/GMAIL_CONNECTOR_ID/dataConnector":{
         "tool_info":[
            {
               "tool_name":"send_email",
               "tool_display_name":"Send Email"
            }
         ]
      },
      "projects/PROJECT_ID/locations/LOCATION/collections/CALENDAR_CONNECTOR_ID/dataConnector":{
         "tool_info":[
            {
               "tool_name":"create_calendar_event",
               "tool_display_name":"Create Calendar Event"
            }
         ]
      }
    }
  }'

• PROJECT_ID : ID du projet dans lequel se trouvent votre application et les connecteurs d'actions Google Agenda et Gmail.
• LOCATION : emplacement multirégional de votre application et de vos connecteurs : global, us ou eu.
• APP_ID : ID de l'application à laquelle vous souhaitez associer l'action.
• CALENDAR_CONNECTOR_ID : ID du connecteur d'action Google Agenda créé à l'étape précédente.
• GMAIL_CONNECTOR_ID : ID du connecteur d'action Gmail créé à l'étape précédente.

Une fois que vous avez ajouté des actions, l'assistant peut les effectuer au nom de vos utilisateurs finaux dans l'application. La première fois qu'un utilisateur demande à l'assistant d'effectuer une action Google Agenda ou Gmail, il est invité à autoriser l'accès à son compte.