Ajouter des déclencheurs à un agent (GitHub Copilot) (aperçu)

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Utilisez des déclencheurs pour créer des agents autonomes alimentés par le GitHub Copilot Harness. Les agents autonomes s’exécutent lorsqu’un événement se produit dans un service connecté. Par exemple, un assistant peut répondre lorsqu’un élément est créé dans SharePoint, qu’un courrier électronique arrive ou qu’une heure planifiée se produit.

Le déclencheur envoie les détails de l’événement à l’agent. Les instructions et outils de votre agent déterminent ce que l’agent fait avec ces détails.

Remarque

L’environnement d’exécution utilisé pour créer cet assistant repose sur une facturation à l’utilisation. L’utilisation, la création, le test et l’évaluation des agents peuvent consommer des crédits Copilot. En savoir plus dans Aperçu de la facturation basée sur l’utilisation.

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Avant d’ajouter un déclencheur

Avant d’ajouter un déclencheur :

Ajoutez et configurez un déclencheur

  1. Ouvrez l’agent dans Copilot Studio.

  2. Sélectionnez Déclencheurs.

    Capture d’écran du panneau de configuration de l’agent dans Copilot Studio avec la section Déclencheurs surlignée, montrant des déclencheurs tels que Chat avec l’agent et Nouvel email.

  3. Sélectionnez le déclencheur.

  4. Configurez le déclencheur :

    1. Configurez la connexion utilisée par le déclencheur. Si vous voyez une coche verte, votre connexion fonctionne. Si vous ne voyez pas de coche verte, sélectionnez le compte, puis choisissez un autre compte ou créez une nouvelle connexion.

      Capture d’écran du panneau du déclencheur « New email » avec la connexion Office 365 Outlook surlignée, montrant une icône d’avertissement au lieu d’une coche verte.

      Remarque

      Certains déclencheurs, comme les déclencheurs Recurrence, Copilot et Teams, ne nécessitent pas de vérification de connexion.

    2. En option, ajoutez des instructions supplémentaires que vous souhaitez envoyer à votre agent pour ce déclencheur. Cette étape est particulièrement importante lorsque vous avez plusieurs déclencheurs dans votre agent et que chaque déclencheur pilote l’exécution de l’agent différemment.

    3. Configurez les options de déclenchement qui déterminent quand l’agent doit être invoqué lorsque l’événement déclencheur est détecté.

    4. Si vous partagez cet agent avec d’autres utilisateurs, choisissez quelles options les utilisateurs peuvent ou ne peuvent pas configurer eux-mêmes en activant ou en désactivant Modifiable par utilisateur pour chaque option.

      Capture d’écran des options de déclenchement de Nouveau courrier électronique avec les champs Dossier, À, CC et À ou CC, et Modifiable par l’utilisateur activé et mis en surbrillance.

    5. Dépliez les paramètres avancés pour configurer tous les paramètres avancés dont vous avez besoin.

  5. Sélectionnez Ajouter un déclencheur.

Tester et publier l’agent

Testez chaque déclencheur avant de publier l’agent.

  1. Testez un déclencheur en sélectionnant le bouton de test flask ( ). Pour accéder au bouton, il faut soit :

    • Sélectionnez le déclencheur dans l’onglet Build.
    • Ouvre l’onglet Aperçu .
  2. Effectuez l’une des actions suivantes :

    • Sélectionnez Commencer l’écoute pour le premier test. Générez un événement correspondant à la configuration du déclencheur, comme l’envoi d’un e-mail ou la création d’un élément SharePoint. Votre assistant attend que l’événement déclencheur se produise et réagit comme un test. En fonction des résultats, modifiez les instructions, outils, personnalisation des déclencheurs ou messages de votre agent pour correspondre à vos besoins.
    • Choisissez un événement déclencheur précédent (dernier e-mail, fichier, etc.) dans la liste Test avec événements déclencheurs précédents. Cette action invoque l’agent avec cet événement déclencheur.

Publier et activer un agent autonome

L’agent ne fonctionne pas de façon autonome tant que vous ne l’avez pas publié. Republiez l’agent après avoir modifié un déclencheur, ses instructions ou ses outils. La mise à jour d’un agent invite les utilisateurs à accepter les nouveaux changements.

  1. Sélectionnez Publier pour mettre à jour la dernière version de l’agent associée au déclencheur.

  2. Après la publication, utilisez la boîte de dialogue de réussite pour choisir à qui vous souhaitez envoyer l’assistant :

    • Activer pour moi-même : Vous seul, le créateur, pouvez utiliser l’agent, en utilisant vos propres identifiants de créateur.
    • Partagez avec d’autres : Autorisez d’autres utilisateurs à utiliser l’agent, avec leurs propres identifiants. Vous devez aussi partager l’agent avec ces utilisateurs.

    Capture d’écran de la boîte de dialogue « Votre agent est publié » avec les options Activez cet agent pour moi et Partagez avec d’autres.

Activer pour moi

Remarque

L’utilisation d’agents autonomes est facturée selon les tarifs de facturation de Copilot Studio.

Activer pour moi vous emmène à la gestion des assistants, où vous activez l’assistant. Après avoir activé l’agent, celui-ci commence à agir en votre nom.

Vous pouvez également accéder à la gestion des agents et activer votre agent autonome depuis le lien sous le nom de l’agent.

Partager avec d’autres

Permettre aux gens d’utiliser un agent autonome avec leurs propres identifiants, de configurer ses déclencheurs et outils pour l’authentification des utilisateurs, puis de partager l’agent publié. Les destinataires complètent toutes les connexions requises et ne peuvent modifier que les options de déclenchement que vous autorisez.

Remarque

L’utilisation de l’agent autonome de chaque utilisateur final est totalisée et facturée via l’environnement sous-jacent où l’agent est hébergé. En savoir plus dans Aperçu de la facturation pour les agents alimentés par le harnais GitHub Copilot.

En savoir plus dans Partagez un agent autonome. Pour les instructions pour les utilisateurs finaux qui configurent un agent partagé, allez dans Configurer un agent autonome partagé.