Configurer des déclencheurs d'événements

Vous pouvez configurer votre workflow pour qu'il s'exécute automatiquement lorsque des données sont modifiées dans un connecteur.

Les déclencheurs d'événements utilisent l'interrogation pour détecter les modifications, telles que les nouveaux e-mails, les événements d'agenda mis à jour ou les nouveaux fichiers dans un data store connecté. Lorsqu'une modification est détectée, le workflow configuré s'exécute.

Avant de commencer

Avant d'utiliser cette fonctionnalité, procédez comme suit :

Connecteurs compatibles

Les connecteurs suivants sont compatibles avec les déclencheurs d'événements :

  • Confluence
  • Gmail
  • Google Agenda
  • Google Drive
  • Jira Cloud
  • OneDrive
  • Outlook
  • ServiceNow
  • SharePoint
  • Équipes

Configurer un déclencheur d'événements

Application

  1. Ouvrez votre application Web Gemini Enterprise dans un navigateur.
  2. Dans le menu de navigation, cliquez sur Agents.
  3. Cliquez sur Create agent (Créer un agent).
  4. Cliquez sur Start manually (Démarrer manuellement).
  5. Sur la page Qu'est-ce qui doit déclencher votre agent ?, cliquez sur App event (Événement d'application).
  6. Dans le panneau de détails, sous App event - Choose an app to start with (Événement d'application – Choisissez une application pour commencer), recherchez le connecteur que vous souhaitez utiliser. Cliquez sur le nom du connecteur pour le sélectionner.
  7. Sélectionnez l'événement qui déclenche votre workflow. Les événements sont organisés par catégorie.
  8. Une fois que vous avez sélectionné un événement, le déclencheur est ajouté en haut de votre workflow dans le générateur de flux.
  9. Cliquez sur Add step (Ajouter une étape) pour ajouter des étapes de workflow qui s'exécutent lorsque le déclencheur se déclenche.

Tester un agent avec des déclencheurs d'événements

Avant d'activer votre workflow, vous pouvez tester son fonctionnement en prévisualisant les événements de déclenchement et en exécutant des simulations avec des exemples de données d'événements.

Prévisualiser les résultats du déclencheur d'événements

Application

  1. Dans le canevas du workflow, cliquez sur le nœud de déclencheur d'événements en haut de votre workflow.
  2. Dans le panneau de configuration de droite, cliquez sur Preview results (Prévisualiser les résultats).
  3. Gemini Enterprise récupère les événements récents du connecteur. Chaque élément affiche le titre et l'horodatage de l'événement. Les résultats de prévisualisation de Google Agenda sont basés sur les événements récemment mis à jour et peuvent ne pas refléter les événements récents.
  4. Vous pouvez cliquer sur un résultat de prévisualisation pour afficher les détails de l'événement.

Tester le workflow de votre agent

Application

  1. Accédez à l'onglet Test (Test) dans le canevas du workflow.
  2. Dans la section d'entrée du déclencheur, sélectionnez un exemple d'événement dans la liste des événements prévisualisés à l'aide du sélecteur Select input (Sélectionner l'entrée).
  3. Cliquez sur Start manually (Démarrer manuellement) pour exécuter la simulation de workflow à l'aide des exemples de données d'événements.
  4. Une fois l'exécution terminée, développez le résumé de la simulation pour inspecter les sorties et vérifier que chaque étape a traité correctement la charge utile du déclencheur.

Gérer les déclencheurs d'événements

Vous pouvez gérer les déclencheurs d'événements en modifiant leur configuration, en activant ou en désactivant les workflows, ou en supprimant les déclencheurs.

REMARQUE : L'affichage des événements peut prendre jusqu'à 10 minutes.

  • Modifier un déclencheur d'événements : ouvrez l'agent en mode édition, cliquez sur le nœud de déclencheur dans le canevas, puis mettez à jour ses paramètres ou ses critères de filtrage dans le panneau de configuration.
  • Activer un déclencheur d'événements : pour activer le déclencheur et commencer à interroger les événements, activez les workflows. Pour en savoir plus, consultez Activer ou désactiver un workflow.
  • Désactiver un déclencheur d'événements : pour suspendre ou désactiver l'interrogation des événements, désactivez le workflow.

Limites et problèmes connus

Voici les limites et problèmes connus lorsque vous utilisez des déclencheurs d'événements.

  • Dissociation d'un connecteur : lorsqu'un administrateur dissocie un connecteur du moteur ou de l'application, le déclencheur d'événements est automatiquement mis en veille. Toutefois, aucune notification n'est envoyée à l'utilisateur, et les utilisateurs ne peuvent pas afficher les agents mis en veille dans leur galerie.
  • Nouvelles tentatives de session infructueuses : si l'exécution d'un agent échoue en raison d'erreurs lors de la récupération de données à partir d'un connecteur associé dans un déclencheur d'événements, une session est créée avec un état d'échec. Les nouvelles tentatives manuelles sur les sessions ayant échoué ne sont actuellement pas prises en charge.
  • Filtres : ajoutez toujours des filtres à vos déclencheurs d'événements pour garantir l'exécution rapide de l'agent sur les événements les plus importants.
  • Déclencheurs Gmail
    • L'initialisation de l'agent peut être plus lente pour les utilisateurs ayant un volume d'e-mails élevé.
    • Gmail est compatible avec deux déclencheurs : When an email is sent (Lorsqu'un e-mail est envoyé) et When an email is received (Lorsqu'un e-mail est reçu). Si vous souhaitez déclencher un agent en vous envoyant un e-mail, utilisez When an email is sent (Lorsqu'un e-mail est envoyé). Si vous utilisez When an email is received (Lorsqu'un e-mail est reçu), l'agent ne sera pas déclenché.

Pour obtenir la liste complète des contraintes système, consultez Quotas et limites de Workflow Builder.

Étape suivante