Configurer des déclencheurs d'événements

Vous pouvez configurer votre workflow pour qu'il s'exécute automatiquement lorsque les données changent 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énement

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 Démarrer manuellement.
  5. Sur la page Qu'est-ce qui doit déclencher votre agent ?, cliquez sur Événement d'application.
  6. Dans le panneau d'informations, sous Événement d'application – Choisissez une application pour commencer, parcourez ou 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 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 déclencheurs et en exécutant des simulations avec des exemples de données d'événement.

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

Application

  1. Dans le canevas du workflow, cliquez sur le nœud du déclencheur d'événement en haut de votre workflow.
  2. Dans le panneau de configuration de droite, cliquez sur Prévisualiser les résultats.
  3. Gemini Enterprise récupère les événements récents à partir du connecteur. Chaque élément affiche le titre et le code temporel 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 pourraient ne pas refléter les événements récents.
  4. Vous pouvez cliquer sur un résultat d'aperçu pour afficher les détails de l'événement.

Tester le workflow de votre agent

Application

  1. Accédez à l'onglet Tester dans le canevas du workflow.
  2. Dans la section de saisie du déclencheur, sélectionnez un exemple d'événement dans la liste des événements prévisualisés à l'aide du sélecteur Sélectionner une entrée.
  3. Cliquez sur Démarrer manuellement pour exécuter la simulation du workflow à l'aide des exemples de données d'événement.
  4. Une fois l'exécution terminée, développez le résumé de la simulation pour inspecter les résultats 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 des workflows, ou en supprimant des déclencheurs.

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

  • Modifier un déclencheur d'événement : ouvrez l'agent en mode Édition, cliquez sur le nœud du déclencheur sur le canevas, puis modifiez ses paramètres ou ses critères de filtrage dans le panneau de configuration.
  • Activer un déclencheur d'événement : 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énement : pour suspendre ou désactiver l'interrogation d'événements, désactivez le workflow.

Limites et problèmes connus

Voici les problèmes et limites connus liés à l'utilisation 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énement est automatiquement mis en pause. Toutefois, aucune notification n'est envoyée à l'utilisateur, et les utilisateurs ne peuvent pas voir les agents mis en veille dans leur galerie.
  • Nouvelles tentatives de session ayant échoué : si l'exécution d'un agent échoue en raison d'erreurs lors de la récupération des données d'un connecteur associé dans un déclencheur d'événement, une session est créée avec l'état "Échec". Les nouvelles tentatives manuelles sur les sessions ayant échoué ne sont pas acceptées pour le moment.
  • Filtres : ajoutez toujours des filtres à vos déclencheurs d'événements pour que l'agent s'exécute rapidement sur les événements les plus importants.
  • Déclencheurs Gmail :
    • L'initialisation de l'agent peut être plus lente pour les utilisateurs qui reçoivent un volume élevé d'e-mails.
    • Gmail accepte deux déclencheurs : Lorsqu'un e-mail est envoyé et Lorsqu'un e-mail est reçu. Si vous souhaitez déclencher un agent en vous envoyant un e-mail, utilisez 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.

Étapes suivantes