Envoyer des activités d’événement

  • Article

Important

Les capacités et les fonctionnalités de Power Virtual Agents font maintenant partie de Microsoft Copilot Studio, suite à des investissements significatifs dans l’IA générative et des intégrations améliorées dans Microsoft Copilot.

Certains articles et captures d’écran peuvent faire référence à Power Virtual Agents pendant que nous mettons à jour la documentation et le contenu de la formation.

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é. Tout ceci est décrit 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 spécialement conçu pour envoyer des activités d’événement. Les activités d’événement sont envoyées depuis le bot 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 être dans 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 chat Web personnalisé pour gérer les événements envoyés par le bot. Par exemple, vous pouvez rechercher un événement provenant du bot et effectuer une action sur la page. L’exemple 04.api/c.incoming-activity-event dans le référentiel d’exemples de chat Web Microsoft Bot Framework sur GitHub montre comment cela 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 en savoir plus, consultez Enregistrement des 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 : cela enverra une activité de saisie, que le canal peut choisir de récupérer et afficher un indicateur de saisie sur le client.
  • Délai : ceci 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 selon le nombre de millisecondes du délai. Pour plus de détails, voir Champ ActivityTypes.Delay.
  • Invoquer/Invoquer une réponse : généralement utilisé pour Microsoft Teams. Un utilisateur créera un sujet avec un déclencheur Invoquer pour intercepter une action Invoquer entrante de Teams. Le C1 utilisera ensuite une activité Invoquer une réponse pour renvoyer une réponse appropriée à Teams.
  • Transfert : cela permet à un utilisateur d’envoyer une activité Transfert avec un contrôle explicite sur la valeur. Ceci 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.