Orchestrer un agent d’IA

Créez un agent autonome sur le canevas, transmettez-lui les données et acheminez l'exécution du workflow en fonction de la décision de l'agent.

Ce que vous allez créer: un flux qui invoque un agent d'IA que vous avez créé sur la zone de dessin, lui transmet les données et achemine l'exécution en fonction de la réponse de l'agent (approuvé, rejeté ou échoué). Il s'agit de la base de toute automatisation agentique: une décision basée sur un raisonnement intégrée dans un processus automatisé plus important.

L'agent que vous créez ici est un agent autonome: son modèle, ses invites, ses outils et son contexte se trouvent tous sur le nœud et se déplacent avec le flux. Pour réutiliser un agent déjà publié dans votre organisation au lieu d’en créer un intégré, utilisez plutôt le nœud de processus BPMN .

Éléments requis

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

Nœuds utilisés

• Déclencheur manuel: démarre le flux à la demande pendant que vous créez
• Agent: un agent d'IA que vous avez créé sur la zone de dessin, renvoie sa sortie
• Décision: ramifie l'exécution en fonction de la réponse de l'agent
• Terminer: termine le flux sur un chemin d'échec

Étapes

1. Créer un nouveau flux et ajouter un déclencheur

1. Ouvrez Maestro → Flow et sélectionnez Nouveau flux.
2. Faites glisser un nœud Déclencheur manuel sur le canevas.

Pour un flux de production, vous le remplacerez par un déclencheur planifié ou d'intégration. Un déclencheur manuel suffit pendant la création.

2. Ajouter un nœud d'agent

Le libellé de la palette de l'agent est Agent autonome.

1. Faites glisser un nœud Agent depuis la section Nœuds UiPath du panneau Nœuds vers le canevas.
2. Connectez-le au déclencheur manuel.
3. Dans le panneau Propriétés, créez l'agent:
   • Définissez le modèle ou laissez-le sur le modèle d’agent par défaut de votre organisation.
   • Écrivez l’ invite système, le rôle de l’agent et les instructions permanentes. Le modèle, l'invite système et l'invite utilisateur sont tous requis.
   • Écrivez l' invite de l'utilisateur, la tâche pour cette exécution. Référencer les données de flux avec des expressions; par exemple, le texte du document à classer: $vars.start.output.documentText.

3. Retourner un résultat structuré

Par défaut, l'agent renvoie un champ, content, contenant le texte de sa réponse. Pour se ramifier proprement, demandez à l’agent de renvoyer un champ structuré à la place.

1. Ouvrez l'onglet Variables dans le panneau Propriétés de l'agent.
2. Ajoutez une variable de sortie nommée decision de type string.
3. Dans l' invite système, indiquez à l'agent de définir decision sur approved ou rejected.

4. Gérer la réponse de l’agent

1. Faites glisser un nœud Décision sur la zone de dessin et connectez-le au nœud Agent.
2. Définissez la condition pour évaluer la sortie de l'agent, par exemple: $vars.agent1.output.decision === "approved".
3. Connectez la branche Vrai à l'étape suivante de votre automatisation (par exemple, une notification ou une écriture de données).
4. Connectez la branche Faux à un nœud Terminer .
5. Définissez le statut Terminer sur Failed et ajoutez un message tel que Agent returned: $vars.agent1.output.decision

5. Déboguer le flux

Sélectionnez Debug dans la barre d'outils. Dans le Trace de l’exécution:

• Sélectionnez le nœud de l'agent pour inspecter les entrées envoyées et ce que l'agent a renvoyé.
• Confirmez que le nœud Décision a pris la branche correcte en fonction de la sortie de l'agent.
• Si la réponse de l'agent ne correspond pas à ce que vous attendiez, examinez la requête système, la requête utilisateur et la sortie déclarée avant de modifier la logique de flux non liée.

Pour entraîner les deux branches sans attendre les réponses réelles de l'agent, activez la sortie simulée sur le nœud de l'agent et définissez une réponse fixe.

Résultat

Votre flux s’exécute de bout en bout: le Déclencheur manuel démarre l’exécution, le nœud Agent raisonne sur l’entrée et renvoie un champ decision structuré, le nœud Décision se ramifie sur la valeur et le nœud Terminer met fin au flux sur le chemin rejeté . Vous pouvez inspecter les entrées et les sorties de l'agent dans la Trace d'exécution et ajuster les requêtes directement sur le nœud.

Étendre ce flux

• Donner des outils à l'agent: connectez les ressources d'outils (outils intégrés, outils de connecteur, outils de workflow RPA ou d'API, extraction de documents ou serveurs MCP) au handle d'outils de l'agent afin qu'il puisse agir, et pas seulement en raison.
• Ancrez l’agent dans vos données: 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.
• Mettez un humain dans la boucle: connectez la gestion des escalades de l'agent à une ressource d'escalade pour les cas que l'agent ne doit pas décider seul.
• Ajouter une boucle: encapsulez l'invocation de l'agent dans un nœud de boucle pour traiter une liste d'éléments avec le même agent.
• Chaîne vers un autre système: après la branche Vrai du nœud de décision, ajoutez une requête HTTP ou un nœud d’intégration pour écrire le résultat dans un système externe.