Vue d’ensemble du déclencheur d’événement (version préliminaire)

Vous pouvez configurer des agents personnalisés pour qu’ils effectuent des actions ou appellent des rubriques en réponse à un événement à l’aide de déclencheurs d’événements . Contrairement aux déclencheurs de rubrique, qui nécessitent l’entrée d’un utilisateur, les déclencheurs d’événements permettent à vos agent d’agir de manière autonome en réponse à l’événement défini qui se produit.

Important

L’utilisation de déclencheurs d’événements est une fonctionnalité en version préliminaire publique. L’utilisation des déclencheurs d’événement est gratuite pour les participants à la préversion, mais nécessite des messages qui sont pris en compte dans vos quotas d’utilisation. Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle, afin que les clients puissent y accéder de façon anticipée et apporter leurs commentaires.

Note

Cette fonctionnalité n’est disponible que pour les agents pour lesquels l’orchestration générative est activée.

Fonctionnement des déclencheurs d’événements

Les déclencheurs d’événements nécessitent un événement choisi qui génère la charge utile du déclencheur et l’envoie à l’agent via un connecteur. La charge utile contient des informations sur l’événement, y compris des variables pour des types de données spécifiques. Lorsque l’agent reçoit la charge utile, il exécute les instructions fournies par l’auteur de l’agent dans les instructions de l’agent et les instructions envoyées via la charge utile du déclencheur.

Les agents n’agissent qu’en fonction de la conception et des instructions de leur auteur. Par exemple, vous pouvez ajouter un déclencheur lors de l’ajout d’un nouveau membre de l’équipe et désigner la réponse comme l’action d’envoi au nouvel employé d’un message de bienvenue avec des ressources d’intégration.

Les déclencheurs d’événements sont activés en fonction d’événements externes à l’agent. Ils sont différents des déclencheurs de rubriques, qui sont utilisés pour activer des rubriques ou des actions en fonction de phrases déclencheurs saisies par les utilisateurs.

Cet article explique le fonctionnement des déclencheurs d’événements, leurs limites et les stratégies de dépannage. Pour plus d’informations sur l’ajout d’un déclencheur d’événement, consultez Ajouter un déclencheur d’événement.

D’autres exemples de déclencheurs d’événements sont les suivants :

• Quand un élément est créé dans SharePoint
• Quand un fichier est créé dans OneDrive
• Quand une tâche est terminée dans Planner
• Une durée définie écoulée (un déclencheur de périodicité )

Important

Les déclencheurs disponibles dépendent des stratégies de protection contre la perte de données de votre organisation, configurées Power Automate par un administrateur.

Flux de travail du déclencheur

Un déclencheur est une partie d’un workflow contenant plusieurs parties :

1. Un déclencheur d’événement enregistre qu’un événement spécifique s’est produit.
2. Le déclencheur envoie une charge utile contenant des informations sur l’événement et des instructions.
3. L’agent contient des instructions pour choisir une ou plusieurs actions ou rubriques en fonction de la charge utile.

Trouvez le déclencheur adapté à votre événement

Copilot Studio dispose d’une bibliothèque de déclencheurs pour une gamme d’événements pouvant se produire dans Microsoft et les services partenaires. La configuration du déclencheur détermine les paramètres de l’événement qui déclenche le déclencheur. Il détermine également le contenu de la charge utile du déclencheur.

La plupart des déclencheurs vous permettent de spécifier des paramètres sur l’événement qui active le déclencheur. Par exemple, dans le déclencheur Lorsqu’une ligne est ajoutée, modifiée ou supprimée pour Dataverse, vous sélectionnez les modifications de la table qui activent le déclencheur.

Définir la charge utile du déclencheur

La charge utile du déclencheur est un message JSON ou en texte brut qui contient des informations sur un événement. La charge utile est envoyée à votre agent sous forme de message. Lors de l’ajout d’un déclencheur, vous pouvez conserver le contenu de la charge utile par défaut pour ce déclencheur ou ajouter vos propres instructions. Par la suite, vous pouvez modifier le contenu de la charge utile, y compris l’ajout de variables et d’opérateurs de chaîne dans Power Automate.

Par exemple, le message par défaut du déclencheur Quand une ligne est ajoutée, modifiée ou supprimée est Utiliser le contenu de Body. Lorsque l’agent reçoit la charge utile, il dispose du contenu de la ligne et des instructions pour utiliser ce contenu.

Vous pouvez ajouter des instructions à envoyer à votre agent au sein de la charge utile qui indiquent à l’agent comment agir lorsqu’il est activé par le déclencheur. Si vous avez plusieurs déclencheurs, chaque charge utile du déclencheur peut avoir des instructions spécifiques et détaillées, sans que vous ayez besoin d’écrire des conseils longs et compliqués dans les instructions générales de l’agent ou de semer la confusion de l’agent sur quels instructions s’appliquent à quel déclencheur.

Par exemple, dans une charge utile de déclencheur Lorsqu’une ligne est ajoutée, modifiée ou supprimée , vous pouvez ajouter Envoyer un résumé des modifications dans la conversation instantanée. Lorsque l’agent reçoit la charge utile, il résume les modifications pour l’utilisateur dans la conversation instantanée de l’agent.

Cependant, évitez d’écrire des instructions de charge utile qui entrent en conflit avec les instructions générales de l’agent. Les conflits dans les instructions peuvent provoquer une erreur ou des résultats inattendus. Assurez-vous de tester toutes les modifications impliquant des déclencheurs d’événement.

Après avoir créé un déclencheur, vous pouvez ajouter ou modifier des variables ou des opérateurs de chaîne dans une charge utile de déclencheur et modifier les instructions de la charge utile existante à l’aide de Power Automate.

Agent instructions par rapport aux instructions de charge utile

Les instructions relatives à la charge utile sont spécifiques à la façon de réagir à un événement. Vous pouvez également utiliser les instructions agent pour indiquer à votre agent comment gérer les informations provenant d’un déclencheur et comment agir lorsqu’il reçoit une charge utile de déclencheur, ainsi que pour déterminer le comportement général de votre agent. Par exemple, pour un agent qui recherche les noms de compte en double dans les nouvelles Dataverse lignes de table, les instructions peuvent être : Lorsqu’une nouvelle ligne est ajoutée, vérifiez s’il s’agit d’un compte en double. S’il y a un doublon, créez une tâche À faire à examiner et incluez des détails sur les modifications et les doublons..

Cependant, les instructions agent peuvent ne pas fonctionner de manière optimale dans toutes les situations. Si votre agent a plusieurs déclencheurs ou plusieurs objectifs complexes, vous devez plutôt utiliser les instructions de la charge utile du déclencheur.

En poursuivant le dernier exemple, vous pouvez ajouter une instruction dans la charge utile du déclencheur pour rechercher des noms de compte en double dans la même Dataverse table. Lorsque le agent reçoit la charge utile, il lui est demandé de rechercher les noms de compte en double. Les instructions générales du agent indiquent alors : «  S’il y a un doublon, créez une tâche à faire à examiner et incluez des détails sur les modifications et les doublons. »

La création d’instructions pour les agents demande de la pratique. Accédez aux instructions de rédaction pour obtenir d’autres conseils et testez toujours toutes les modifications que vous apportez à votre agent.

Appeler une action ou une rubrique

Lorsqu’un agent reçoit une charge utile de déclencheur, les instructions que vous lui avez fournies déterminent l’action ou la rubrique qu’il appelle en réponse. Vos instructions permettent à votre agent de sélectionner une action ou un sujet en fonction des informations dont il dispose.

Votre agent ne crée pas une nouvelle action ou un nouveau sujet sur place. En tant qu’auteur de l’agent, vous devez définir les actions ou les rubriques qu’il peut sélectionner. Pour savoir comment votre agent détermine l’action ou le sujet à appeler, consultez Comment fonctionne le mode génératif ?

Si votre agent ne réagit pas comme prévu, vous pouvez utiliser la carte d’activité pour voir s’il lui manque des informations d’entrée clés.

Voici quelques améliorations que vous pouvez apporter aux instructions :

• Ajout d’instructions plus détaillées dans la charge utile du déclencheur ou dans les instructions de l’agent. Votre agent peut avoir besoin de plus d’instructions, comme les informations à utiliser dans un champ de saisie spécifique pour l’action.
• Ajout d’instructions dans la charge utile du déclencheur.
• Demander à votre agent d’appeler une action ou un sujet spécifique.
• Vérification des instructions en conflit entre la charge utile du déclencheur et les instructions de l’agent.
• Ajout aux descriptions des actions, afin que l’agent dispose de plus d’informations pour déterminer quand l’appeler.
• Ajout de descriptions aux champs de saisie de l’action pour aider votre agent à remplir correctement les paramètres. Si les entrées d’une action sont identiques à chaque fois, vous pouvez définir la valeur vous-même.
• Appeler moins de 15 actions ou sujets consécutivement. Les agents complexes qui exécutent de nombreuses actions ou rubriques en une seule séquence peuvent avoir du mal à les exécuter de manière fiable.

Si votre agent a toujours du mal à appeler l’action attendue, envisagez d’ajouter un Power Automate flux qui remplit votre objectif en tant qu’action pour votre agent.

Publication d’agents avec des déclencheurs d’événements

Avant de publier votre agent avec un nouveau déclencheur d’événement, l’agent ne réagit pas automatiquement à ce déclencheur. Assurez-vous de bien tester l’agent avant de le publier, car après avoir publié un agent avec un nouveau déclencheur, votre agent réagit automatiquement à chaque fois que ses déclencheurs sont activés. Vous pouvez voir un enregistrement étape par étape des déclencheurs et des réactions de votre agent dans la page Activité.

Pour plus d’informations sur l’activation des déclencheurs pendant les tests, consultez Tester un déclencheur.

Les déclencheurs d’événements ne peuvent utiliser que les informations d’identification du créateur de l’agent pour l’authentification (c’est-à-dire les informations d’identification que vous avez utilisées pour autoriser les connexions) pour votre déclencheur. Cela peut permettre aux utilisateurs d’un agent d’utiliser l’agent pour accéder aux données et aux systèmes utilisant cette même autorisation. Pour plus d’informations, consultez Résolution des problèmes et limitations.

Actions d’authentification après publication

Si votre agent ne dispose pas d’authentification pour effectuer une action ou est configuré pour demander l’authentification de l’utilisateur, il envoie un message à l’utilisateur pour lui demander ses informations d’identification. Si le flux d’un agent est interrompu parce qu’il ne peut pas recevoir d’informations ou qu’une action a échoué, il ne peut pas continuer la session. Si vous souhaitez que votre agent s’exécute de manière autonome, chaque action doit être configurée avec une authentification fonctionnelle qui ne nécessite pas d’entrée utilisateur. Vous pouvez également demander à votre agent de ne pas demander d’informations d’identification aux utilisateurs.

Les agents peuvent ne pas être en mesure d’exécuter tous les connecteurs correctement. Si un agent ne parvient pas à plusieurs reprises à appeler un connecteur, envisagez de créer une Power Automate action de flux qui utilise le connecteur problématique pour terminer l’action.

Résolution des problèmes et limitations

Limitations de quotas

Si les déclencheurs s’activent trop fréquemment, votre agent risque d’utiliser plus de ressources que prévu. Votre agent peut alors dépasser les limites de quota de la charge du service et votre service peut être limité.

Les administrateurs peuvent surveiller l’utilisation des ressources via Power Platform. Ils peuvent également empêcher l’utilisation de déclencheurs d’événements dans un environnement.

Pour éviter de dépasser les limites de quota :

• Soyez prudent lorsque vous ajoutez des déclencheurs très fréquents ou des déclencheurs qui se répètent indéfiniment. Par exemple, un déclencheur de périodicité s’active chaque fois qu’un laps de temps défini s’écoule. Plus le temps entre les activations est court, plus le déclencheur utilise de ressources.
• Gardez une trace du nombre de déclencheurs actifs dans un environnement.

Les déclencheurs ne peuvent utiliser que les informations d’identification du créateur

Actuellement, les déclencheurs d’événements peuvent utiliser uniquement les informations d’identification de l’auteur agent pour l’authentification. Si vous publiez ou partagez un agent avec des déclencheurs d’événements authentifiés, les utilisateurs peuvent être en mesure d’accéder aux informations ou d’inviter l’agent à effectuer des actions à l’aide des informations d’identification de l’auteur.

Afin d’empêcher les utilisateurs d’accéder ou de modifier des données ou des systèmes protégés, examinez attentivement si et comment les données et les systèmes nécessitant une authentification sont utilisés par l’agent avec des déclencheurs d’événement. Les auteurs doivent être vigilants lorsqu’ils partagent ou publient des agents contenant des déclencheurs d’événements.

Les administrateurs peuvent également empêcher Copilot Studio les utilisateurs d’utiliser les déclencheurs d’événements avec leurs agents. Pour plus d’informations, consultez Bloquer les déclencheurs d’événements.

Limitations de l’utilisation des sources de connaissances avec des déclencheurs d’événements

Les agents ne peuvent pas référencer certaines sources de connaissances en réponse à un déclencheur d’événement. Certaines sources de connaissances nécessitent que l’agent fournisse l’authentification pour accéder, mais les agents ne peuvent pas fournir cette authentification de manière autonome.

Évitez ces sources de connaissances lorsqu’elles sont référencées en réponse à un déclencheur d’événement :

• SharePoint
• Dataverse
• Connecteurs de graphique
• Invites AI Builder

Référencez plutôt ces sources de connaissances en réponse à un déclencheur d’événement :

• Sites web publics
• Fichiers chargés
• Données d’entreprise, avec des connecteurs