Configurer les événements personnalisés entrants dans AI Agent Studio

1. Sur la page de configuration de l'agent IA, créez une nouvelle réponse dans l' onglet Réponses.
2. Dans Réponse par défaut, cliquez sur + à côté de la chaîne par défaut (Web) pour ajouter la chaîne vocale
3. Dans le champ Nom de l'événement entrant, définissez le nom de l'événement que l'agent reçoit.

Invoquer un événement personnalisé depuis Flow Designer

1. Dans le Webex Contact Center Flow Designer, configurez l' activité Virtual Agent V2 dans le flux.
2. Dans les paramètres de l'événement national, indiquez les informations suivantes dans les colonnes Nom de l'événement et Données de l'événement :

   1. Entrez le nom personnalisé de l'événement que vous avez configuré dans l'onglet Réponse de la page de configuration des agents IA d'AI Agent Studio.

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

Accédez à des données personnalisées sur les événements dans AI Agent Studio

Vous pouvez accéder aux données de l'événement (configurées dans le Flow Designer) dans la section Réponse par défaut où vous avez configuré votre événement entrant. Sur la figure suivante, vous pouvez voir que le nom personnalisé de l'événement « custom_welcome» et les données de l'événement store name« » sont transmis par Flow Designer à AI Agent Studio.

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

1. Dans AI Agent Studio, accédez à la page de configuration des agents d'IA par script et accédez à Response 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 ses données utiles dans le fichier JSON que vous souhaitez renvoyer dans le flux.

Dans cet exemple, les créneaux collectés sont replacés dans le flux grâce à un événement de sortie personnalisé “order_details”.

Accédez à des données personnalisées sur les événements dans Flow Designer

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

Event nameest renvoyé sous la StateEventName variable et Event payload est renvoyé Metadatacomme indiqué dans la figure suivante :

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

Vous pouvez mettre à jour les valeurs du système telles que le contexte, l'intention et le créneau horaire lors d'un événement spécial state_updateet à l'Event payloadaide des valeurs, comme le montre l'exemple suivant :

{ 
 "intent": "order_status", 
 "slots": { 
 "first_name": "John" 
 } 
"context": {
    "track": 1
 }
} 

Dans l'exemple ci-dessus, l'intention de l'agent scripté est définie sur order_status, le créneau « 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 scriptée d'un agent doit être contrôlée par une logique de flux. Cela est particulièrement utile dans certains cas d'utilisation, notamment :

• Demander de nouveau des informations à l'utilisateur en cas d'échec du traitement du flux

  Imaginez un scénario dans lequel l'agent prend rendez-vous pour un utilisateur. Une fois la date et l'heure collectées, ces informations sont envoyées au flux par le biais d'un événement personnalisé, qui tente ensuite de prendre rendez-vous en utilisant une activité de requête HTTPS. Si le rendez-vous est refusé en raison d'un conflit d'horaire, l'agent IA doit demander un autre créneau horaire. Pour gérer cela, le développeur peut utiliser la charge utile des événements suivante :

  {
  "intent": "book appointment",
  "slots": {
  "time": ""
  }
  }

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

• Naviguez vers une autre intention

  Imaginez un scénario dans lequel un utilisateur demande à vérifier son solde, mais comme condition préalable, il doit d'abord vérifier son identité. Dans le cadre du processus de demande de solde, les développeurs peuvent envoyer une charge utile d'événement pour indiquer au flux si l'utilisateur a déjà été vérifié. S'il est vérifié, le système peut récupérer le solde ; sinon, le flux peut demander à l'agent IA de lancer le processus de vérification des utilisateurs en utilisant la charge utile suivante :

  {
  "intent": "verify user",
  }

  Dans le même exemple, supposons que la vérification nécessite la date de naissance et le code PIN de l'utilisateur. Si le flux contient déjà des informations sur la date de naissance de l'utilisateur via CJDS, elles peuvent être transmises par créneau et seul le code PIN peut être collecté. La charge utile de l' événement sera la suivante :

  {
  "intent": "verify user",
  "slots": {
  "date of birth": "06/26/1993"
  }
  }

• Introduire ou réinitialiser le contexte d'une conversation

  Lorsque le contexte de la conversation doit être mis à jour, les développeurs peuvent l'inclure dans la charge utile de l' state_updateévénement. Par exemple, une fois que l'agent IA a collecté les emplacements correspondant à l'intention de « vérifier l'utilisateur », il définit le contexte de la conversation pour « 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 de « vérification ». La charge utile de l'événement pour ce scénario serait la suivante :

  {
  "intent": "verify user",
  "slots": {
  "date of birth": "",
  "pincode": ""
  },
  "context": {
  "verify": 0
  }
  }