Créer et configurer les agents IA

Pour plus d'informations, consultez Configurer un agent IA scripté et Configurer un agent IA autonome dans le guide d'administration Webex AI Agent Studio.

Configurer les agents IA dans le flux

Vous pouvez utiliser un nœud AI Agent pour répondre à des requêtes spécifiques à partir d'un corpus ou d'une base de connaissances. Vous pouvez également activer des conversations à plusieurs tours. L'agent d'IA peut poser des questions de suivi, comprendre le contexte et fournir des réponses personnalisées.

Il vous suffit de glisser-déposer le nœud AI Agent sur votre générateur de flux visuel pour commencer. Ce nœud vous aide à utiliser des agents d'IA scriptés et autonomes configurés dans le Webex AI Agent Studio.

Configurer les variables d'entrée et de sortie dans le nœud d'agent AI

Le nœud AI Agent contient deux méthodes :

• Traiter le message : Vous permet d'envoyer des messages utilisateur à l'agent sélectionné et de recevoir des réponses de l'agent.

• Fermer la session : vous permet de fermer une session dans l'agent d'IA. Dans certains scénarios, il peut être nécessaire de fermer une session d'agent IA existante et d'en lancer une nouvelle. Cela peut être réalisé à l'aide d'une méthode spécifique au sein du nœud AI Agent. Par exemple, si une session reste inactive pendant une période spécifiée, le système ferme automatiquement la session pour optimiser les ressources.

1. Dans la méthode Process Message, configurez les variables d'entrée suivantes :

   • Type d'agent : type d'agent utilisé dans le flux, par exemple scripté ou autonome.

   • Agent : l'agent qui traite le message utilisateur et reçoit une réponse.

     Vous pouvez voir les agents AI auxquels vous avez accès dans le Webex AI Agent Studio. Pour plus d'informations sur la gestion des utilisateurs et des agents dans Webex AI Agent Studio, consultez Rôles d'utilisateur.

   • Message : le nom variable contenant le message client entrant envoyé à l'agent d'IA choisi

   • Langue : si l'agent AI choisi est multilingue, vous pouvez choisir la langue du message entrant dans la liste déroulante Langue. Nous remplissons la liste déroulante en fonction des langues dans les paramètres des agents AI.

     Remarque : Nous désactivons cette liste déroulante pour les agents disposant d'une seule langue.

   • Canal : nom du canal à partir duquel le système reçoit le message du client.

   • Identifiant de l'utilisateur : fournissez l'identifiant unique de l'utilisateur pour le canal choisi.

   • Paramètres personnalisés (facultatif) : Vous pouvez transmettre des informations supplémentaires sur le client à Webex AI Agent Studio en tant que paire de valeurs clés. Nous associons ces informations au profil de l'utilisateur et les utilisons pour des conversations ultérieures. Par exemple, vous pouvez spécifier si un utilisateur est un nouveau client ou un client existant.

     Les clés transmises en tant que paramètres personnalisés sont accessibles sous la forme ${consumerData.extra_params.<your_key>} dans les réponses de l'agent.

     Actuellement, les paramètres personnalisés ne sont pris en charge que pour l'agent d'IA scripté via des canaux numériques.

   • Paramètres de message (facultatif) : Vous pouvez transmettre des informations supplémentaires sur l'échange en cours à Webex AI Agent Studio en tant que paire de valeurs clés.

     Nous ne stockons pas ce message et il est uniquement disponible pour une utilisation dans la prochaine réponse de l'agent. Les clés transmises en tant que paramètres de message sont accessibles sous forme de ${extra_params.<your_key>} dans les réponses de l'agent.

2. Configurez les variables de sortie suivantes dans la méthode Process Message :

   • TextResponse : La sortie de texte configurée dans l'agent AI ; ne fonctionne que si aucun autre type d'éléments riches ou spéciaux n'est présent. En outre, pour plusieurs éléments de texte dans la réponse, le premier élément de texte est retourné.

   • Réponse complète : La réponse complète avec tous les éléments riches et plusieurs messages présents dans la sortie de l'agent.

   • Banque de données : JSON/dict de toutes les variables de session définies par l'utilisateur dans l'agent

   • TransactionId : l'identifiant de transaction pour la demande dans Webex AI Agent Studio

   • SessionId : L'identifiant de session/conversation dans Webex AI Agent Studio

   • ConsumerId : l'identifiant client dans Webex AI Agent Studio

   • MessageMetadata : métadonnées associées à la réponse actuelle de l'agent configuré

   • Métadonnées de session : métadonnées associées à la session pour la réponse actuelle de l'agent configuré

     Actuellement, MessageMetadata et SessionMetadata ne sont pris en charge que pour les agents d'IA scriptés via des canaux numériques.

   • ResponsePayload : La charge utile de réponse complète de Webex AI Agent Studio

3. Configurez les variables d'entrée suivantes dans la méthode Close Session :

   • Agent : l'agent qui traite le message utilisateur et reçoit une réponse.

     Vous pouvez voir les agents AI auxquels vous avez accès dans le Webex AI Agent Studio. Pour plus d'informations sur la gestion des utilisateurs et des agents dans Webex AI Agent Studio, consultez Rôles utilisateur.

   • ID de session : nous fermons la session AI agent. L'ID de session est disponible en tant que variable de sortie de la méthode de message Process.

Résultats des nœuds

Vous pouvez voir la liste des résultats de nœud possibles pour ce nœud. Vous pouvez personnaliser les étiquettes des nœuds à l'aide de l'icône Modifier (crayon). Le nœud sort par l'un des bords du nœud correspondant au résultat du nœud. Chaque nœud AI Agent correspond à un résultat de nœud. Voici une liste des résultats des nœuds.

• Erreur (rouge) : indique ce qui suit :

  • onError : lorsque l'agent n'a pas répondu par un message.

  • onInvalidCustomerID : lorsqu'un identificateur client est manquant.

  • onInvalidMessage : lorsque la valeur du message est manquante.

• Succès (vert) : indique ce qui suit :

  • onSuccess : lorsque l'agent répond par un message.

  • onAgentHandover : lorsque l'agent soulève une demande de transfert aux agents.

• Délai d'expiration (jaune/orange) : indique les valeurs suivantes :

  • onTimeOut : lorsque l'agent n'a pas répondu en moins de 15 secondes.