Créer un workflow d’agent de chat

Créez une expérience de chat en temps réel optimisée par l’IA dans Maestro Flow, qui inclut des fonctionnalités telles que le routage basé sur les sorties et le transfert d’agents.

Ce que vous allez créer: un flux conversationnel montrant comment les nœuds de chat principaux peuvent être utilisés pour orchestrer des expériences de chat flexibles.

Cette procédure pas à pas crée une expérience de chat composée d'un agent d'assistance générale qui décide du moment où transmettre une conversation à un agent spécialisé en compte.

Éléments requis

• Un compte UiPath Automation Cloud avec accès à Maestro Flow.
• Un modèle LLM disponible que l'agent peut utiliser.

Nœuds utilisés

• Conversation Trigger: marque le flux comme conversationnel et le démarre lorsqu'un utilisateur initie un chat.
• Attendre un message: suspend jusqu'à ce que l'utilisateur envoie un message et renvoie le dernier contexte de la conversation.
• Agent conversationnel: nœud d'IA conversationnel à invite unique qui exécute un tour de réponses et d'appels d'outil en fonction du contexte de la conversation.
• Décision: se fonde sur la sortie structurée d'un agent.
• Envoyer un message: envoyez un avis déterministe au chat.

Étapes

1. Créer le flux et ajouter un déclencheur de conversation

1. Dans Studio Web, choisissez Créer nouveau et sélectionnez Maestro Flow.
2. Sélectionnez le déclencheur par défaut (étiqueté Déclencheur manuel) et choisissez Modifier le déclencheur.
3. Dans le sélecteur de déclencheur, sélectionnez Déclencheur de conversation.

2. Attendre le premier message de l'utilisateur

L’activité Attendre le message doit être le premier nœud après le déclencheur de conversation:

1. Faites glisser un nœud Wait for Message depuis la palette d’outils conversationnels vers le canevas et connectez-le au déclencheur de conversation.
2. Dans le panneau Propriétés, définissez l'ID de la conversation sur $vars.conversationTrigger1.output.conversationId.

Le nœud affiche conversationContext — l'historique de chat récent, les données de profil de l'utilisateur et d'autres informations de tour — que les nœuds de chat en aval doivent utiliser.

3. Ajouter un nœud d'agent conversationnel

Le premier nœud d’agent conversationnel que nous ajouterons est un agent d’assistance générale pour gérer les questions informatiques quotidiennes et décide, via une sortie structurée, quand transmettre à un spécialiste.

1. Faites glisser un nœud d’agent conversationnel sur le canevas et connectez-le à l’activité Attendre le message.

2. Renommez- le Agent d’aide générale et renommez son ID dans le panneau Avancé de l’agent en generalHelpdeskAgent pour simplifier le suivi.

3. Dans le panneau Propriétés de l'agent, définissez l' invite système:

   You are the internal IT helpdesk assistant.
   Answer everyday questions about our tools, wifi, printers,
   meeting rooms, and where to find internal docs.
   
   When the employee is having an account problem — 
   a forgotten password, a locked account, an MFA issue, 
   or a missing permission — tell the user that they will
   be handed off to an account specialist agent.
   

4. Sous Paramètres de l'agent conversationnel, liez le contexte de la conversation à $vars.waitForMessage1.output.conversationContext.

5. Sous Sorties, ajoutez une variable de sortie:

   • Nom : needsAccountSpecialist
   • Type de données: booléen
   • Champ par défaut: false
   • Description : Set to true when the employee has an account problem — a forgotten password, a locked account, an MFA issue, or a missing permission. Otherwise false.

La description de la variable de sortie est nécessaire - l'agent utilise la description en plus de l'invite système pour générer les sorties structurées après son tour dans la conversation.

4. Brancher sur la décision du marqueur

Suivez l'agent avec un nœud de décision qui redirige vers la sortie structurée.

1. Faites glisser un nœud Décision sur la zone de dessin et connectez-le à l’agent d’assistance générale.
2. Définissez la condition: $vars.generalHelpdeskAgent.output.needsAccountSpecialist.
3. Reliez la branche Faux à l' activité Wait for Message d'origine (Étape 2). L’agent d’assistance générale conserve la conversation — il peut la transmettre plus tard, ou jamais.

Laissez la branche Vrai ouverte pour l'instant; vous le créerez dans les prochaines étapes.

5. Annoncer le transfert

Informez l’employé de ce qui se passe et demandez-lui les prochaines étapes avant que le spécialiste ne prenne le relais.

1. Dans la branche Vrai de la Décision, ajoutez un nœud Envoyer le message . Configurer:
   • ID de la conversation: $vars.conversationTrigger1.output.conversationId
   • ID d’échange: $vars.waitForMessage1.output.conversationContext.latestExchangeId
   • Contenu: "You've been connected to the account specialist, which can help with password resets, unlocking your account, and permission or group membership questions. Please explain your issue."

6. Ajoutez une deuxième boucle Attendre le message avec le spécialiste du compte

1. Après Envoyer le message, ajoutez un autre nœud Attendre le message .

2. Définissez l'ID de la conversation sur $vars.conversationTrigger1.output.conversationId.

3. Faites glisser un nœud d’agent conversationnel et connectez-le à cette deuxième attente de message.

4. Vous pouvez éventuellement le renommer Agent spécialisé en compte.

5. Définissez l’ invite système:

   You are the account specialist. The user has been handed off 
   to you from a general helpdesk assistant.
   
   Help only with account problems — password resets, unlocking
   accounts, MFA re-enrollment, and permission or group membership
   questions.
   

6. Sous Paramètres de l'agent conversationnel, liez le contexte de la conversation à $vars.waitForMessage2.output.conversationContext.

7. Reconnectez la sortie du spécialiste du compte à waitForMessage2 pour fermer la boucle du spécialiste.

Astuce :

Lorsque vous avez plusieurs nœuds Attendre le message, vous pouvez accidentellement configurer un nœud en aval pour référencer un contexte de conversation obsolète à partir d'un nœud Attendre le message qui a été exécuté précédemment.

Pour simplifier le suivi, créez une variable au niveau du flux (par exemple, $vars.globalConversationContext) et mettez-la à jour à partir de la section Mettre à jour la variable du nœud Attendre la valeur de message. Les nœuds en aval peuvent alors référencer cette source de vérité unique au lieu d’avoir à choisir la dernière sortie du nœud Attendre le message exécuté.

7. Déboguer le flux

Sélectionnez Debug dans la barre d'outils supérieure. Un panneau de discussion s’ouvre à côté du canevas.

• Demandez « Comment me connecter à mon bureau VPN?» — l'agent d'assistance générale doit répondre directement et revenir en arrière pour un autre tour.
• Demandez « J’ai des problèmes de connexion». — l'agent d'assistance générale doit définir needsAccountSpecialist: true, la Décision redirige vers la branche Vrai, l'avis de transfert apparaît et le spécialiste du compte prend le relais.

Inspectez la Trace d’exécution pour voir quel agent a été exécuté à chaque tour et quelle sortie structurée a produit l’agent d’assistance générale.

Résultat

Une fois publié et déployé, votre flux conversationnel s'affiche aux utilisateurs finaux en tant qu'agent conversationnel sur les canaux de déploiement de chat. Surveillez ses performances, ses mesures et les commentaires des utilisateurs via l’observabilité de l’agent de chat.

Étendre ce flux

• Donner un contexte et des outils aux agents: connectez une ressource de contexte au handle de contexte de l'agent afin qu'il réponde à partir d'une source de connaissances indexée au lieu du modèle seul. Connectez les ressources d’outils au handle Outils de l’agent afin qu’il puisse agir pendant ses tours conversationnels, et pas seulement pour répondre.
• Ajouter des branches d'exécution parallèles: en plus de rediriger vers Attendre le message, ajoutez des branches parallèles pour effectuer des actions en arrière-plan sans bloquer la conversation. Par exemple, une branche peut lancer un nœud humain pour l'approbation d'un gestionnaire, puis procéder à d'autres actions.
• Mettez fin au chat une fois le problème résolu: ajoutez une sortie resolved: true sur l'agent ou les agents qui redirigent vers une branche qui met fin à l'exécution. La conversation se termine correctement et les utilisateurs verront que la conversation est terminée.

Par exemple, l'extension du flux de la présentation avec les fonctionnalités ci-dessus peut entraîner une expérience de chat complète comme ceci: