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 une application connectée.

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 :

Applications compatibles

Les applications suivantes 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 What should trigger your agent? (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 l'application que vous souhaitez utiliser. Cliquez sur le nom de l'application pour la 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 est activé.

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

Avant d'activer votre agent de workflow, vous pouvez tester ses fonctionnalités 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 de l'agent de workflow, cliquez sur le nœud du 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 de l'application connectée. Chaque élément affiche le titre et l'horodatage de l'événement. Les résultats de l'aperçu de Google Agenda sont basés sur les événements mis à jour récemment et peuvent ne pas refléter les événements récents.
  4. Vous pouvez cliquer sur un résultat de l'aperçu pour afficher les détails de l'événement.

Tester le workflow de votre agent

Application

  1. Accédez à l'onglet Test (Tester) dans le canevas de l'agent de 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 l'agent 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 agents de workflow, 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 du 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 l'agent de workflow. Pour en savoir plus, consultez Activer ou désactiver un agent de workflow.
  • Désactiver un déclencheur d'événements : pour mettre en pause ou désactiver l'interrogation des événements, désactivez l'agent de workflow.

Limites et problèmes connus

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

  • Dissociation du connecteur : lorsqu'un administrateur dissocie un connecteur du moteur ou de l'application, le déclencheur d'événements est automatiquement mis en pause. Toutefois, aucune notification n'est envoyée à l'utilisateur, et les utilisateurs ne peuvent pas afficher les agents mis en pause dans leur galerie.
  • Échecs de nouvelles tentatives de session : 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 vous assurer que l'agent s'exécute en temps voulu 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 du système, consultez Quotas et limites de Workflow Builder.

Étape suivante