- Démarrer
- Construire
- Ajouter un agent d'IA à un workflow
- Appeler une API externe
- Traiter les e-mails entrants
- Créer un workflow de notification Slack
- Ajouter une approbation humaine à un workflow
- Créer un workflow d’agent de chat
- Gérer les erreurs
- Principes de base du débogage
- L'humain dans la boucle: escalade ou étape humaine
- Évaluation de vos workflows
- Demande HTTP (HTTP Request)
- Fonctionnement des nœuds de connecteur
- Créer une connexion
- Sales and customer relationships
- Customer support and help desk
- Messaging and meetings
- E-mail (Email)
- Marketing
- Social media
- Files, documents, and e-signature
- Projects, collaboration, and code
- People and recruiting
- Finance and commerce
- AI models and agents
- Speech, vision, and language
- Data and location
- Cloud, identity, and security
- Déployer et exécuter
- Exemples
- Référence (Reference)
Créer un workflow d’agent de chat
Créez une expérience de chat en temps réel optimisée par l’IA sur le canevas, avec un routage basé sur les sorties et un transfert d’agent.
Ce que vous créez
Un workflow conversationnel qui montre comment les nœuds de chat principaux créent 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.
Avant de commencer
- Un modèle LLM (Large Language Model) que les Agents peuvent utiliser.
Nœuds utilisés
- Déclencheur de conversation: marque le workflow 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: envoie un avis déterministe au chat.
Étapes
Avec un agent de codage configuré, vous pouvez ignorer les étapes manuelles. Demandez-le:
Build a Maestro Automate chat workflow: a Conversation trigger, a Wait for message node, a general helpdesk Conversational agent that answers IT questions and hands account questions to an account specialist agent, and Send message nodes that reply, looping back to Wait for message.
Build a Maestro Automate chat workflow: a Conversation trigger, a Wait for message node, a general helpdesk Conversational agent that answers IT questions and hands account questions to an account specialist agent, and Send message nodes that reply, looping back to Wait for message.
Ouvrez ensuite le workflow sur la zone de dessin, vérifiez-le par rapport aux étapes ci-dessous et testez-le. Configurer votre agent de codage décrit la configuration.
1. Créer le workflow et ajouter un déclencheur de conversation
- Créez un projet comme votre premier workflow décrit.
- Sélectionnez le déclencheur par défaut (étiqueté Déclencheur manuel) et choisissez Modifier le déclencheur.
- 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:
- Sélectionnez + dans la gestion de la sortie du déclencheur de conversation, recherchez l'activité Attendre le message et sélectionnez-la.
- Dans le panneau Propriétés, définissez l'ID de la conversation sur
$vars.conversationTrigger1.output.conversationId.
La sortie du nœud conversationContext, qui contient l’historique de chat récent, les données de profil utilisateur et d’autres informations de tour, pour les nœuds de chat après sa consommation.
3. Ajouter un nœud d'agent conversationnel
Le premier nœud d’agent conversationnel est un agent d’assistance générale qui gère lui-même les questions informatiques quotidiennes et décide, via une sortie structurée, quand transmettre à un spécialiste.
-
Sélectionnez + dans la gestion de sortie du nœud Attendre le message, recherchez Agent conversationnel et sélectionnez-le.
-
Renommez- le Agent d’aide générale et renommez son ID dans l’onglet Avancé en
generalHelpdeskAgentpour simplifier le suivi. -
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.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. -
Sous Paramètres de l'agent conversationnel, liez le contexte de la conversation à
$vars.waitForMessage1.output.conversationContext. -
Sous Sorties, ajoutez une variable de sortie:
- Nom :
needsAccountSpecialist - Type de données: booléen
- Valeur 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.
- Nom :
La description de la variable de sortie est nécessaire, car 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.
- Sélectionnez + dans la gestion de sortie du nœud d'agent, recherchez Décision et sélectionnez-la.
- Définissez la condition:
$vars.generalHelpdeskAgent.output.needsAccountSpecialist. - Reliez la branche Faux à l' activité Wait for Message d'origine (Étape 2). L’agent de l’assistance générale conserve la conversation et peut la transmettre plus tard, ou jamais.
La branche Vrai reste ouverte jusqu'aux étapes suivantes.
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.
- 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."
- ID de la conversation:
6. Ajoutez une deuxième boucle Attendre le message avec le spécialiste du compte
-
Après Envoyer le message, ajoutez un autre nœud Attendre le message .
-
Définissez l'ID de la conversation sur
$vars.conversationTrigger1.output.conversationId. -
Sélectionnez + dans la gestion de sortie du deuxième nœud Attendre le message, recherchez Agent conversationnel et sélectionnez-le.
-
Vous pouvez éventuellement le renommer Agent spécialisé en compte.
-
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.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. -
Sous Paramètres de l'agent conversationnel, liez le contexte de la conversation à
$vars.waitForMessage2.output.conversationContext. -
Reconnectez la sortie du spécialiste du compte à
waitForMessage2pour fermer la boucle du spécialiste.
Avec plusieurs nœuds Attendre le message, un nœud en aval peut 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 workflow (par exemple, $vars.globalConversationContext) et mettez-la à jour à partir de la section Mettre à jour la variable de chaque nœud Attendre pour le 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 workflow
Select Run Debug (▶) in the bottom toolbar of the canvas. A chat panel opens next to the canvas.
- Demandez « Comment me connecter au réseau privé virtuel de mon bureau?».: 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 déployé, le workflow conversationnel apparaît aux utilisateurs comme un 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 workflow
- Donnez du contexte et des outils aux agents: connectez une ressource de contexte au gestionnaire 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 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 de formulaire rapide 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: truesur l'agent ou les agents qui dirigent vers une branche qui met fin à l'exécution. La conversation se termine correctement et les utilisateurs voient que la conversation est terminée.
Le workflow peut être étendu avec les fonctionnalités ci-dessus dans une expérience de chat complète.
Prochaines étapes
- Déployer un workflow: exécutez le workflow sans vous.
- Guides: davantage de workflows à créer.
- Communauté: partagez ce que vous avez créé ou demandez de l’aide à d’autres générateurs.
- Ce que vous créez
- Avant de commencer
- Nœuds utilisés
- Étapes
- 1. Créer le workflow et ajouter un déclencheur de conversation
- 2. Attendre le premier message de l'utilisateur
- 3. Ajouter un nœud d'agent conversationnel
- 4. Brancher sur la décision du marqueur
- 5. Annoncer le transfert
- 6. Ajoutez une deuxième boucle Attendre le message avec le spécialiste du compte
- 7. Déboguer le workflow
- Résultat
- Étendre ce workflow
- Prochaines étapes