- 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
- Déployer et exécuter
- Exemples
- Référence (Reference)
Votre premier workflow
Créez un workflow de prise de commande avec deux appels d'API, un agent d'IA qui décide et deux branches, puis testez-le et déployez-le, avec un agent de codage ou sur la zone de dessin.
Dans ce tutoriel, vous créez le workflow de saisie de commande Qu'est- ce que Maestro Automate? décrit. Pour chaque nouvelle commande, le workflow vérifie le stock et le crédit du client, permet à un agent d'IA de décider s'il doit accepter la commande, puis crée la commande ou notifie un représentant commercial.
Le tutoriel prend environ 15 minutes. L'appel de vérifications des stocks et des crédits d Vérifier.com, un exemple d'API gratuit, vous n'avez donc pas besoin d'un compte ou d'une clé API pour une autre application. Les deux dernières étapes sont des scripts qui remplacent la gestion de la relation client et Slack, de sorte que le workflow s'exécute sans connexion à ces applications. La capture d'écran ci-dessus montre ce que serait le connecteur Slack dans le cadre d'un workflow réel.
Vous pouvez créer le workflow de deux manières. Choisissez-en un et le reste de la page suivra votre choix:
- Avec un agent de codage: décrivez le workflow et l’agent le crée pour vous.
- Manuellement sur la zone de dessin: ajoutez et configurez vous-même chaque nœud.
Avant de commencer
- Un compte UiPath. S’inscrire décrit comment en créer une.
- Un agent de codage avec UiPath CLI et les compétences. Configurez votre agent de codage pour le préparer en trois étapes.
- VS Code avec l'extension UiPath Maestro, pour voir le workflow sur la zone de dessin. Construire dans VS Code décrit comment l’installer.
- Un compte UiPath. S’inscrire décrit comment en créer une.
- VS Code, Studio Web ou Studio Desktop. Studio Web s'exécute dans votre navigateur et ne nécessite aucune installation. Où construire les compare.
1. Créer le workflow
-
Créez un dossier vide pour le projet et ouvrez-le dans VS Code.
-
Démarrez votre agent de codage dans ce dossier. Par exemple, pour Claude Code, exécutez
claudedans le terminal VS Code. -
Collez cette invite:
Create a Maestro Automate project named OrderIntake with a workflow that does exactly this. Don't add, remove, or rename nodes. 1. Rename the Manual trigger to "New order", set its ID to newOrder, and add two input arguments: productId (number) and customerId (string). 2. Add an HTTP Request node "Check stock" (ID checkStock), GET, with the URL as an expression: "https://dummyjson.com/products/" + $vars.newOrder.output.productId 3. Add an HTTP Request node "Check credit" (ID checkCredit), GET https://dummyjson.com/users/1 4. Add an Autonomous Agent node "Review order" (ID reviewOrder) with the default model. System prompt: "You review new customer orders. Accept an order only if the product has stock greater than 0 and the customer record is present. Otherwise reject it. Always give a short reason." Give the agent the response body of Check stock as the product, and the response body of Check credit as the customer. Output variables: accepted (boolean) and reason (string). 5. Add a Decision node "Accepted?" (ID accepted) with the condition $vars.reviewOrder.output.accepted 6. On True, add a Script node "Create order in CRM" (ID createOrderInCrm): return { orderCreated: true, productId: $vars.newOrder.output.productId }; 7. On False, add a Script node "Notify sales rep" (ID notifySalesRep): return { notified: true, reason: $vars.reviewOrder.output.reason }; The order is: New order → Check stock → Check credit → Review order → Accepted? → True: Create order in CRM, False: Notify sales rep. dummyjson.com is a public sample API, so these URLs work as they are. Then validate the workflow and fix any problems.Create a Maestro Automate project named OrderIntake with a workflow that does exactly this. Don't add, remove, or rename nodes. 1. Rename the Manual trigger to "New order", set its ID to newOrder, and add two input arguments: productId (number) and customerId (string). 2. Add an HTTP Request node "Check stock" (ID checkStock), GET, with the URL as an expression: "https://dummyjson.com/products/" + $vars.newOrder.output.productId 3. Add an HTTP Request node "Check credit" (ID checkCredit), GET https://dummyjson.com/users/1 4. Add an Autonomous Agent node "Review order" (ID reviewOrder) with the default model. System prompt: "You review new customer orders. Accept an order only if the product has stock greater than 0 and the customer record is present. Otherwise reject it. Always give a short reason." Give the agent the response body of Check stock as the product, and the response body of Check credit as the customer. Output variables: accepted (boolean) and reason (string). 5. Add a Decision node "Accepted?" (ID accepted) with the condition $vars.reviewOrder.output.accepted 6. On True, add a Script node "Create order in CRM" (ID createOrderInCrm): return { orderCreated: true, productId: $vars.newOrder.output.productId }; 7. On False, add a Script node "Notify sales rep" (ID notifySalesRep): return { notified: true, reason: $vars.reviewOrder.output.reason }; The order is: New order → Check stock → Check credit → Review order → Accepted? → True: Create order in CRM, False: Notify sales rep. dummyjson.com is a public sample API, so these URLs work as they are. Then validate the workflow and fix any problems.L'agent crée le projet, ajoute les nœuds et valide le workflow. Il est possible qu'il vous pose des questions au cours du processus. Répondez-leur à partir de l'invite.
-
Lorsque l'agent se termine, ouvrez le fichier
.flowà partir de l'explorateur. Il s'ouvre sur la zone de dessin Flux. -
Vérifiez le résultat:
- La zone de dessin correspond au workflow en haut de cette page.
- Aucun nœud n'affiche une icône d'avertissement et le panneau Problèmes est vide.
- La barre d'outils inférieure affiche Maestro Automate. Si Maestro Orchestrate s'affiche, sélectionnez-le et choisissez Maestro Automate.
Si un élément ne correspond pas, indiquez à l’agent ce qui est différent, par exemple: « Vérifier le crédit manquant». Ajoutez-le entre Vérifier le stock et Réviser la commande.
Résultat: votre zone de dessin correspond au workflow en haut de cette page.
Créer le projet
Créez un projet Maestro Automate partout où vous créez:
| L’endroit où vous créez | Comment créer le projet |
|---|---|
| Code VS | Ouvrez la vue UiPath Maestro avec l'icône UiPath dans la barre d'activité. Sélectionnez Créer nouveau, puis sélectionnez Maestro Automate dans la liste Nouveau projet . |
| Studio Web | Sélectionnez la flèche située en regard de Créer nouveau, puis sélectionnez Flux sous Maestro Automate. |
| StudioDesktop | Ouvrez une solution. Dans l' explorateur, sélectionnez Ajouter un projet, puis sélectionnez Maestro Automate sous Ajouter à la solution. |
Le projet s'ouvre sur le canevas Flux, avec un déclencheur manuel déjà sur ce canevas. La barre d'outils inférieure affiche Maestro Automate comme mode de création.
Chaque outil offre également un projet pour Maestro Orchestrate: Maestro Orchestrate dans VS Code, Flow sous Maestro Orchestrate dans Studio Web et Maestro Flow dans Studio Desktop. Assurez-vous de sélectionner celle de Maestro Automate.
Commencer par un déclencheur
Lors de la création d'un workflow, la première question à répondre est de savoir comment il démarre. Un déclencheur est l'étape qui démarre chaque exécution. Ce workflow démarre à la demande, ce qui est le moyen le plus simple de le tester, il utilise donc le déclencheur manuel qui se trouve déjà sur la zone de dessin.
- Double-cliquez sur le nom du déclencheur manuel et saisissez Nouvelle commande. Vous renommez chaque nœud de la même manière.
- Dans l'onglet Avancé , définissez son ID sur
newOrder. Les expressions des étapes ultérieures utilisent cet ID. - Dans l'onglet Paramètres , sélectionnez Ajouter un argument d'entrée deux fois pour ajouter les détails de la commande:
productId, de type nombre.customerId, de type chaîne.
Résultat: le workflow accepte un ID de produit et un ID de client à chaque démarrage.
Vérifier le stock
La première question concernant une commande est de savoir si le produit est en stock. Un nœud de requête HTTP demande à un autre système en appelant son API, l'interface que les applications utilisent pour échanger des données.
-
Sélectionnez + dans le handle sortant de Nouvelle commande, recherchez Requête HTTP et sélectionnez-la.
-
Renommez le nœud Vérifier le stock et, dans l'onglet Avancé, définissez son ID sur
checkStock. -
Dans l'onglet Paramètres , laissez Authentification définie sur Authentification manuelle et Méthode définie sur
GET. -
Faites basculer le champ URL en mode expression, pour qu’il affiche
=au début, et saisissez:"https://dummyjson.com/products/" + $vars.newOrder.output.productId"https://dummyjson.com/products/" + $vars.newOrder.output.productIdL'adresse Web est entre guillemets, et
$vars.newOrder.output.productIdajoute l'ID de produit du déclencheur à la fin de celui-ci. Vous pouvez ajouter la partie$varsavec { } Insérer au lieu de la saisir.Si l'éditeur suggère
productIdcomme vous le saisissez, acceptez la suggestion avecEnterau lieu de saisir le nom, ou elle est saisie deux fois.
$vars contient la sortie des nœuds antérieurs. Une expression le lit comme $vars.<node ID>.output. Un champ en mode d'expression est JavaScript, donc le texte comme une adresse Web va entre guillemets. Les variables et le flux de données décrivent comment les données sont déplacées entre les nœuds.
Testez ce que vous avez jusqu’à présent
- Sélectionnez Exécuter le débogage (▶) dans la barre d’outils inférieure de la zone de dessin, saisissez
1pour productId etc-100pour CustomerId, puis démarrez l’exécution. Dans Studio Web, démarrez-le avec Enregistrer et Debug. - Dans le panneau inférieur à la zone de dessin, dans l'onglet Variables , développez Vérifier le stock. Ses sorties affichent
codedéfini sur200et les données du produit dansbody, y compris sonstock.
Si l'option Vérifier le stock échoue, sélectionnez-la dans le Traçage d'exécution pour voir l'erreur. La cause la plus courante est une expression URL sans guillemets autour de l’adresse Web.
Résultat: le workflow lit déjà les données réelles d'une API. Vous pouvez le réexécuter de la même manière après chaque nœud que vous ajoutez.
Vérifier le crédit du client
- Sélectionnez + dans le handle sortant de Vérifier le stock, ajoutez une autre requête HTTP, renommez-la Vérifier le crédit et définissez son ID sur
checkCredit. - Laissez Méthode définie sur
GETet dans l'URL, entrezhttps://dummyjson.com/users/1.
Dans ce tutoriel, l’exemple de dossier d’utilisateur remplace le dossier de crédit du client.
Laisser un agent en décider
Un agent est un modèle d'IA auquel vous donnez des instructions et des outils. Au lieu de suivre des règles fixes, il lit les données et décide.
-
Sélectionnez + dans la gestion sortante de Vérifier le crédit, ouvrez la catégorie Agent et sélectionnez Agent autonome.
-
Renommez le nœud Réviser la commande et définissez son ID sur
reviewOrder. -
Laissez Modèle défini sur le modèle par défaut.
-
Dans Invite système, saisissez les instructions de l’agent:
You review new customer orders. Accept an order only if the product has stock greater than 0 and the customer record is present. Otherwise reject it. Always give a short reason.You review new customer orders. Accept an order only if the product has stock greater than 0 and the customer record is present. Otherwise reject it. Always give a short reason. -
Dans Invite utilisateur, entrez
Product:, ajoutez$vars.checkStock.output.bodyavec { } Insérer, puis entrezCustomer:et ajoutez$vars.checkCredit.output.bodyde la même manière. Chaque valeur insérée s'affiche sous la forme d'une puce dans l'invite. -
Sous Sorties, sélectionnez Ajouter une variable de sortie deux fois:
accepted, de type booléen.reason, de type chaîne.
Résultat: l'agent renvoie accepted et reason, que les nœuds suivants peuvent lire.
Branche sur la décision
-
Sélectionnez + dans la gestion sortante de l'ordre de révision, ouvrez la catégorie Contrôle et sélectionnez Décision. Le renommer Accepté? et définissez son ID sur
accepted. -
Dans la condition, saisissez
$vars.reviewOrder.output.accepted. Le nœud de décision obtient le handle Vrai et Faux . -
Sur le handle Vrai , ajoutez un nœud Script nommé Créer une commande dans CRM avec l'ID
createOrderInCrmet saisissez ce code:return { orderCreated: true, productId: $vars.newOrder.output.productId };return { orderCreated: true, productId: $vars.newOrder.output.productId }; -
Dans le handle Faux , ajoutez un nœud Script nommé Aviser le représentant des ventes avec l'ID
notifySalesRepet entrez ce code:return { notified: true, reason: $vars.reviewOrder.output.reason };return { notified: true, reason: $vars.reviewOrder.output.reason };
Dans un workflow réel, les options Créer une commande dans CRM et Aviser le représentant des ventes seraient des connecteurs, des connexions prêtes à l'emploi à des applications telles que votre CRM et Slack. Connector (Connecteur) répertorie chaque connecteur.
Résultat: votre zone de dessin correspond au workflow en haut de cette page et aucun nœud n'affiche une icône d'avertissement.
2. Testez-le
Le test exécute le workflow sur la zone de dessin avec des exemples de données.
- Demandez à l’agent: « Déboguer le workflow avec ProductId 1 et CustomerId c-100 ».
- L'agent exécute le workflow et rapporte le résultat. Chaque nœud doit se terminer et l'exécution doit prendre le chemin Vrai vers Créer une commande dans CRM, car l'exemple de produit est en stock.
- Vérifiez la décision de l’agent dans le rapport:
acceptedesttrue, avec une courte raison, telle que « Le produit est en stock et le dossier du client est présent.»
Pour voir l'exécution vous-même, sélectionnez Exécuter le débogage (▶) dans la barre d'outils inférieure de la zone de dessin et suivez les étapes dans l'onglet Manuellement sur la zone de dessin .
-
Sélectionnez Exécuter le débogage (▶) dans la barre d’outils inférieure du canevas. Une boîte de dialogue vous demande les valeurs des entrées du déclencheur.
-
Saisissez
1pour ProductId etc-100pour CustomerId, puis démarrez l'exécution. Dans Studio Web, la boîte de dialogue est Configuration du débogage et vous démarrez l'exécution avec Enregistrer et déboguer.Dans Studio Web, les valeurs sont enregistrées pour la prochaine exécution.
-
Attendez la fin de l'exécution. Chaque nœud affiche une coche verte, et l'exécution prend le chemin Vrai vers Créer une commande dans CRM, car l'exemple de produit est en stock.
-
Dans le Trace d'exécution, développez Examiner l'ordre et sélectionnez Sortie de l'agent. L'onglet Résultat affiche la décision de l'agent,
accepted: true, et sa raison.
Sélectionnez Examiner la commande elle-même pour voir les données que l’agent a reçues: l’enregistrement complet du produit depuis Vérifier le stock et l’enregistrement de l’utilisateur depuis Vérifier le crédit.
Si un nœud échoue, sélectionnez-le dans le traçage de l'exécution pour voir l'erreur. Les bases du débogage couvrent les outils de débogage en détail.
Résultat: votre workflow s'exécute du déclencheur à la branche et la décision de l'agent est visible dans le traçage.
3. Le déployer et l’exécuter
Jusqu’à présent, le workflow n’a été exécuté qu’en tant que test. Son déploiement en fait un workflow actif qui s'exécute sans le canevas. Chaque exécution est prise en compte dans les exécutions mensuelles de votre plan.
-
Demandez à l’agent:
Deploy this workflow, then start one run with productId 1 and customerId c-100, and tell me where I can see the run.Deploy this workflow, then start one run with productId 1 and customerId c-100, and tell me where I can see the run.L'agent empaquète le projet, le déploie et lance une exécution avec ces entrées.
-
Lorsque l'exécution a eu le temps de se terminer, demandez: &`L'exécution est-elle terminée? Indiquez-moi son statut final et la branche qu’elle a prise.»
L'agent signale que l'exécution est réussie et a emprunté le chemin Vrai pour Créer une commande dans CRM.
- Déployez le workflow:
- Studio Web: sélectionnez Déployer et attendez que le déploiement soit réussi.
- VS Code ou Studio Desktop: suivez Déployer un workflow.
- Ouvrez la tâche Démarrer:
- Studio Web: sur l’écran de réussite, sélectionnez Démarrer la tâche.
- VS Code ou Studio Desktop: dans Orchestrator, sélectionnez Solutions, sélectionnez le dossier dans lequel vous avez effectué le déploiement, puis sélectionnez votre solution. Dans son panneau, sélectionnez Démarrer la tâche.
- Sous Input (Entrée), saisissez
1pour productId etc-100pour CustomerId, puis sélectionnez Start (Démarrer). - Pour suivre l'exécution, sélectionnez le lanceur de produits, l'icône de grille en haut à gauche de la page, puis sélectionnez Maestro.
- Sélectionnez Instances de flux, puis le nom de votre workflow.
- Sélectionnez l'exécution pour voir chaque étape qu'elle a nécessaire sur le canevas.
Résultat: votre workflow est déployé et sa première exécution a emprunté le chemin Vrai pour Créer une commande dans CRM.
Ce que vous avez appris
- Déclencheurs: chaque workflow commence par un, et les arguments d'entrée comportent les données avec lesquelles chaque exécution commence.
- Requêtes HTTP: un nœud appelle l'API d'un autre système et rend la réponse disponible aux nœuds suivants.
- Expressions:
$vars.<node ID>.outputlit la sortie d'un nœud précédent. - Agents: un agent lit les données, décide et renvoie les variables de sortie que vous définissez.
- Décisions: une condition envoie chaque exécution sur l'un des deux chemins.
- Test: une exécution de Debug affiche ce que chaque nœud a reçu et retourné.
- Codage des agents: un agent peut créer le même workflow à partir d’une description, et vous le vérifiez sur le canevas.
- Déploiement: un workflow déployé s’exécute sans le canevas, et chaque exécution est répertoriée avec son statut.
Prochaines étapes
- Évaluations: vérifiez les décisions de l'agent par rapport à un ensemble d'exemples de commandes. Le bouton Ajouter aux évaluations sur une entrée de traçage est un moyen rapide de commencer.
- Déployer un workflow: exécutez le workflow sans vous.
- Connecteur: remplacez les deux scripts par de vraies applications.
- Référence du nœud: chaque nœud et comment le configurer.
- Community (Communauté): posez des questions et partagez les workflows avec d'autres générateurs.