Configurer un événement personnalisé entrant dans AI Agent Studio

1. Sur la page de configuration de l'agent AI, créez une nouvelle réponse dans le champ Réponses Tab.
2. Sous Réponse par défaut, cliquez sur + en regard du canal (Web) par défaut pour ajouter le canal vocal
3. Dans le champ Nom de l'événement entrant, définissez le nom de l'événement que l'agent reçoit.

Appeler un événement personnalisé à partir du Concepteur de flux

1. Dans le Concepteur de flux Webex Contact Center, configurez l'activité Virtual Agent V2 dans le flux.
2. Dans les paramètres d'événement d'état , spécifiez les détails suivants dans les colonnes Nom de l'événement - Données de l'événement :

   1. Entrez le nom de l'événement personnalisé que vous avez configuré dans la réponse Tab de la page de configuration de l'agent AI dans AI Agent Studio.

   2. Entrez les données personnalisées que vous souhaitez transmettre du Concepteur de flux à l'agent d'IA scripté.

Accéder aux données d'événements personnalisés dans AI Agent Studio

Vous pouvez accéder aux données d'événement (configurées dans le Concepteur de flux) dans la section Réponse par défaut où vous avez configuré votre événement entrant. Dans la figure suivante, vous pouvez voir que le nom de l'événement personnalisé «  custom_welcome » et le «  nom du magasin" des données d'événement sont transmis du Concepteur de flux à AI Agent Studio.

Configurer un événement de sortie personnalisé et une charge utile dans AI Agent Studio

1. Dans AI Agent Studio, accédez à la page de configuration de l'agent AI scripté et accédez à Réponse où vous souhaitez que le contrôle soit renvoyé au concepteur de flux.

2. Ajoutez un événement personnalisé à la section Réponse par défaut .

3. Entrez le nom de l'événement et les données utiles de l'événement dans le JSON que vous souhaitez renvoyer dans le flux.

Dans cet exemple, les emplacements collectés sont renvoyés dans le flux avec l'événement de sortie personnalisé "order_details".

Accéder aux données d'événement personnalisées dans Flow Designer

Vous pouvez accéder à l'événement personnalisé et à la charge utile à partir de la section Variables de sortie de l'activité Virtual Agent V2 .

Le nom de l'événement est renvoyé sous la variable StateEventName et la charge utile de l'événement est renvoyée sous forme de métadonnées , comme illustré dans la figure suivante :

Mettre à jour les valeurs système dans AI Agent Studio

Vous pouvez mettre à jour les valeurs système telles que le contexte, l'intention et l'emplacement à l'aide d'un state_update d'événement spécial et d'une charge utile d'événement avec les valeurs, comme illustré dans l'exemple suivant :

{ "intention" : "order_status", "slots" : { "first_name" : "John" } } 

Dans l'exemple ci-dessus, l'intention de l'agent scripté est définie sur order_status, l'emplacement 'first_name' dans cette intention est défini sur 'John' et un contexte appelé 'track' est ajouté à la session.

Cet événement est utile pour les cas d'utilisation où la conversation d'agent scriptée doit être contrôlée par une logique de flux. Certains cas d'utilisation où cela est particulièrement utile incluent :

• Demander à nouveau à l'utilisateur des informations si l'exécution du flux échoue

  Prenons un scénario dans lequel l'agent prend rendez-vous pour un utilisateur. Après avoir collecté la date et l'heure, ces informations sont envoyées au flux via un événement personnalisé, qui tente ensuite de prendre rendez-vous à l'aide d'une activité de requête HTTPS. Si le rendez-vous est rejeté en raison d'un conflit d'horaire, l'agent AI doit demander un autre créneau horaire. Pour gérer cela, le développeur peut utiliser la charge utile d'événement suivante :

  { "intention" : "réserver un rendez-vous", "créneaux horaires" : { "time" : «  » } }

  Dans ce cas, la valeur collectée pour le temps est effacée et l'agent AI invite l'utilisateur à en fournir une nouvelle. Les développeurs peuvent configurer des réponses conditionnelles pour informer les utilisateurs que l'emplacement précédent n'était pas disponible et demander un nouvel horaire.

• Naviguer vers une autre intention

  Prenons un scénario dans lequel un utilisateur demande à vérifier son solde, mais comme condition préalable, l'utilisateur doit d'abord vérifier son identité. Dans le cadre du processus d'enquête de balance, les développeurs peuvent envoyer une charge utile d'événement pour informer le flux si l'utilisateur a déjà été vérifié. S'il est vérifié, le système peut procéder à la récupération du solde ; si ce n'est pas le cas, le flux peut inviter l'agent d'IA à lancer le processus de vérification de l'utilisateur à l'aide de la charge utile d'événement suivante :

  { "intention" : "vérifier l'utilisateur", }

  Dans ce même exemple, disons que la vérification nécessite la date de naissance de l'utilisateur et son code PIN. Du flux contient déjà des informations sur la date de naissance de l'utilisateur via CJDS, qui peuvent être transmises sous forme de fente et seul le code PIN peut être collecté. La charge utile de l'événement pour cela ressemblera à :

  { "intention" : "vérifier l'utilisateur", "créneaux horaires" : { "date de naissance" : "26/06/1993" } }

• Introduire ou réinitialiser le contexte dans une conversation

  Lorsque le contexte de conversation doit être mis à jour, les développeurs peuvent l'inclure dans la charge utile de l'événement state_update . Par exemple, une fois que l'agent AI a collecté les créneaux pour l'intention "vérifier l'utilisateur", il définit le contexte de conversation sur "vérifier". Si la vérification échoue dans le flux, le contexte doit être réinitialisé pour empêcher l'utilisateur d'accéder aux intentions qui nécessitent le contexte "vérifier". La charge utile de l'événement pour ce scénario ressemblerait à :

  { "intention" : "verify user", "slots" : { "date de naissance" : «  », "pincode" : «  » }, "context" : { "verify" : 0 } }