Partager via


Envoyer un événement ou une activité

Microsoft Copilot Studio fournit deux nœuds qui vous permettent d’envoyer des activités autres que des messages : Envoyer un événement et Envoyer une activité. Ces types de nœuds sont abordés dans les sections suivantes.

Capture d’écran de l’ajout d’un nœud Avancé, y compris les options Envoyer un événement et Envoyer une activité.

Envoyer des événements

Le nœud Envoyer un événement est conçu pour envoyer des activités d’événements. Les activités d’événements sont envoyées depuis le copilote et peuvent être interceptées et utilisées par le canal, qui décide si et comment utiliser les activités. Lorsque vous envoyez un événement, vous lui donnez un nom, puis vous pouvez définir une valeur sur l’événement. Cette valeur peut avoir n’importe quel format : une valeur littérale primitive, une référence de variable ou une formule Power Fx. La valeur est sérialisée en tant que JSON et ajoutée à l’activité sortante.

Capture d’écran montrant le menu des paramètres d’un nœud Activité d’événement.

Les utilisations de ce nœud incluent :

  • Vous pouvez configurer un contrôle de conversation instantanée web personnalisé pour gérer les événements envoyés depuis le copilote. Par exemple, vous pouvez rechercher un événement renvoyé par le copilote et effectuer une action sur la page. L’exemple 04.api/c.incoming-activity-event dans le référentiel des exemples Chat web Microsoft Bot Framework sur GitHub montre comment la gestion des événements pourrait fonctionner.
  • Les AudioCodes utilisent des activités d’événement pour vous permettre de contrôler le service. Par exemple, démarrer ou arrêter l’enregistrement d’appel. Pour obtenir des informations supplémentaires, consultez Enregistrement d’appels.

Envoi d’autres types d’activité

En plus des activités d’événement, vous pouvez envoyer des activités d’autres types à l’aide du nœud d’activité d’envoi. Généralement, l’utilisation de ce nœud est avancée ; il appartient donc à la sous-catégorie avancée. Les types d’activités que vous pouvez envoyer sont un sous-ensemble de ceux proposés dans le Bot Framework Schéma - ActivityTypes Class. Lorsque vous utilisez ce nœud, vous choisissez le type d’activité, puis définissez éventuellement un nom ou une valeur.

Les types courants sont :

  • Saisie : envoie une activité de saisie, que le canal peut choisir de sélectionner pour afficher un indicateur de saisie sur le client.
  • Délai : peut être utilisé pour fournir un délai entre les messages. Par exemple : envoi d’un message, puis envoi d’une activité de délai, suivi d’un autre message. L’utilisateur final voit le premier message, suivi d’une pause, puis du deuxième message. Dans ce cas, « Valeur » est défini sur le nombre de millisecondes de délai. Pour plus de détails, voir Champ ActivityTypes.Delay.
  • Invoquer/Invoquer la réponse : généralement utilisé pour Microsoft Teams. Un utilisateur crée une rubrique avec un déclencheur Invoquer pour intercepter une invocation entrante de Teams et utilise une activité Invoquer la réponse pour renvoyer une réponse appropriée à Teams.
  • Transfert : permet à un utilisateur d’envoyer une activité de transfert avec un contrôle explicite sur la valeur. Un transfert est utilisé pour certains canaux externes, tels qu’AudioCodes.

Capture d’écran montrant le nœud d’activité Invoquer avec la liste déroulante Type.