Créer un agent dans Studio Web

Créez un agent dans Studio Web à l'aide du canevas principal du concepteur, en suivant les étapes recommandées et les meilleures pratiques pour développer des agents de niveau production.

Cette section explique comment créer un agent dans Studio Web. Pour créer des agents de production fiables, nous vous recommandons vivement de consulter les Meilleures pratiques.

Explorer l'espace de travail de l'agent

Utilisez le canevas principal du concepteur de Studio Web pour concevoir votre agent, et les panneaux gauche et droit pour explorer la structure et les ressources de l'agent.

Choisir votre type de canevas

Vous pouvez concevoir votre agent à l'aide de deux vues distinctes : Formulaire et Zone de dessin.

• Zone de dessin est une zone de dessin visuelle. Il comporte une visualisation par glisser-déposer basée sur des nœuds dans laquelle chaque composant (modèle, requête, contexte, outil ou escalade) est représenté par un nœud sur le canevas. Cette vue est idéale pour les utilisateurs qui privilégient une approche graphique et exploratoire de la conception d'agents, leur permettant de créer, Debug et affiner la logique en manipulant directement des éléments visuels.
• Form est l'expérience standard basée sur des formulaires de Studio Web. Il fournit une expérience de création structurée et basée sur des formulaires, dans laquelle chaque composant de l'agent est configuré à l'aide de panneaux et de champs d'entrée dédiés. Cette vue est idéale pour les utilisateurs qui préfèrent une approche tabulaire ou basée sur la configuration de la conception de l'agent, ce qui permet une configuration, une validation et des tests étape par étape sans avoir à utiliser de diagrammes visuels.

Basculez entre les modes Formulaire et Zone de dessin avec une synchronisation sans perte entre les deux expériences.Toute propriété modifiée dans le formulaire est immédiatement reflétée sur la zone de dessin et inversement.

Affichage Zone de dessin

La zone de dessin est structurée autour de quatre zones principales :

• Canevas central : la surface de conception principale où la logique de l'agent est représentée par des nœuds connectés. Le canevas prend en charge le zoom, le déplacement et la navigation via une mini-carte pour les agents complexes.
• Volet latéral gauche : donne accès à l'Explorateur de projet, au Gestionnaire de données, aux Erreurs et aux panneaux de Configuration de déploiement, conformément à l'interface basée sur des formulaires.
• Volet latéral droit : affiche les onglets Propriétés et Dev, permettant aux utilisateurs de modifier les attributs des nœuds ou d'exécuter rapidement des tests de Debug.
• Panneau inférieur : affiche la piste d'exécution, l'historique et les évaluations, et intègre les données de traçage en direct lors du débogage en phase de conception.

Types de nœud sur la zone de dessin

Chaque nœud du canevas représente un composant logique dans la définition de l'agent :

• Nœud de l'agent : définissez les requêtes système et utilisateur et exposez le schéma (arguments d'entrée/sortie) dans le Gestionnaire de données. Configurez le modèle, la température et les paramètres de jetons.
• Nœuds de contexte : liez les index d'ancrage dans le contexte, ce qui permet de configurer la stratégie de requête, les seuils et les limites de récupération.
• Nœuds d'outils : visualisez les automatisations, activités ou autres agents connectés. Chaque nœud d'outil peut être développé pour afficher des schémas d'entrée/sortie, des garde-fous et des options de simulation.
• Nœuds d'escalade - Indiquent les mécanismes d'intervention humaine. Leur sélection ouvre le panneau Configuration de l'escalade avec les destinataires de la tâche et les résultats.

Débogage dans la vue Zone de dessin

La zone de dessin fournit des commentaires visuels en temps réel pendant le débogage :

• Flux de traçage : lorsque l'agent s'exécute au moment de la conception, les plages de traçage apparaissent directement sur le canevas et les nœuds s'allument lorsqu'ils sont activés dans la boucle de l'agent.
• Agents conversationnels : lors du débogage d'un agent conversationnel, une fenêtre de discussion persistante permet aux utilisateurs d'échanger des messages avec l'agent. Chaque message déclenche une exécution de Debug.
• Points d'arrêt : vous pouvez suspendre l'exécution d'un agent à des nœuds spécifiques en définissant des points d'arrêt. Lorsqu’un point de rupture est atteint, l’agent s’arrête juste avant d’exécuter ce nœud, ce qui vous permet d’inspecter ses entrées, sorties et données de Trace.

Ajout de notes à la zone de dessin

Les notes de zone de dessin vous permettent d’annoter la vue de dessin avec du texte libre pour décrire les zones de la zone de dessin, documenter les objectifs de l’outil ou laisser des rappels aux collaborateurs.

Pour ajouter une note :

1. Dans la barre d’outils de la zone de dessin, sélectionnez l’icône Note.
2. Sélectionnez un emplacement sur la zone de dessin pour placer la note. Un modèle de note apparaît avec un texte d'espace réservé.
3. Sélectionnez la note et entrez votre contenu. Les notes prennent en charge le formatage Markdown.

Pour gérer une note, sélectionnez-la pour révéler les icônes d'action, puis utilisez les options disponibles :

• Modifier (icône en forme de crayon) - Ouvrez la note pour la modifier.
• Modifier la couleur (icône en forme de point coloré) - Appliquez une couleur à la note pour regrouper visuellement ou catégoriser les zones de dessin.
• Supprimer (icône en forme de corbeille) - Supprimez la note de la zone de dessin.

Vous pouvez également faire glisser une note pour la repositionner n'importe où sur la zone de dessin et faire glisser ses bords pour la redimensionner.

Vue du formulaire

La vue Formulaire offre un WorkSpace structuré, basé sur des panneaux, pour créer et configurer des agents à l'aide d'entrées guidées. Il fournit une présentation claire et étape par étape adaptée à la configuration et à la validation précises des composants de l'agent.

Présentation de la mise en page

• Formulaire de définition de l'agent : affiche la définition de l'agent et ses composants de base – Requêtes, Outils, Contextes et Escalades – organisés dans une structure linéaire basée sur un formulaire.
• Panneau latéral gauche : comprend les panneaux Explorateur de projet, Gestionnaire de données, Erreurs et Configuration du déploiement pour naviguer dans les ressources du projet et les gérer.
• Panneau de droite : Contient les onglets Propriétés et Dev, utilisés pour modifier les paramètres des composants, exécuter des tests rapides et afficher les traçages au moment de la conception.
• Panneau inférieur : permet d'accéder à Piste d'exécution, Historique et Évaluations, affichant les résultats du Debug et les mesures d'évaluation en temps réel.

Configuration de l’agent

Chaque section du formulaire correspond à un composant principal de l'agent :

• Requêtes : Définissez les instructions système et utilisateur qui orientent le comportement de l'agent.

• Outils : Ajoutez et configurez des automatisations, des activités Integration Service ou d'autres agents que l'agent peut appeler pendant l'exécution.

• Contextes : connectez les index d'ancrage dans le contexte pour fournir des données pertinentes pour le raisonnement.

• Escalades - Configurez des actions d'intervention humaine.

  Figure 1. La vue formulaire

Débogage dans la vue Formulaire

Lorsque vous testez un agent dans la vue Formulaire, vous pouvez exécuter des sessions de Debug directement depuis la barre d'outils pour vérifier la logique et les sorties. Les traces de conception apparaissent dans le panneau Piste d'exécution, affichant les entrées, les sorties et les éventuelles erreurs de chaque exécution. Pour les Agents conversationnels, une fenêtre de chat intégrée vous permet d’échanger des messages et d’observer les réponses en temps réel.

Utiliser les panneaux Studio Web

Le panneau gauche montre la structure de l'agent et comprend :

• Project Explorer (Explorateur de projets) : organisez et créez votre agent. Définissez les requêtes, les outils, le contexte, les escalades, etc.
• Data Manager (Gestionnaire de données) : définissez les arguments d'entrée et de sortie.
• Le panneau Errors (Erreurs) : examinez les problèmes liés à la conception, les configurations défectueuses ou les échecs de tests.
• Le panneau Deployment configuration (Configuration du déploiement) : définissez la configuration spécifique à l'environnement pour publier et exécuter l'agent.

Le panneau droit comprend :

• Le panneau Propriétés, divisé comme suit :
  • L'onglet Propriétés : configurez les paramètres au niveau de l'agent et des composants.
  • L'onglet Dév : exécutez des entrées de test, déboguez et inspectez les traçages de conception.
• Score de l'agent (aperçu) : examinez l'état de préparation de votre agent en fonction des résultats d'évaluation et de la couverture des tests.
• Le panneau Run output (Sortie d'exécution) : examiner les résultats des dernières exécutions de test.
• Autopilot (aperçu) : obtenez des suggestions pilotées par l'IA pour affiner les requêtes, les outils et la configuration de l'agent.

Figure 2. Le WorkSpace des agents

Le panneau inférieur fait des évaluations un élément essentiel de l'expérience de conception en conservant l'historique, les résultats et les traçages en temps réel au même endroit. Les onglets disponibles dépendent du type d'agent que vous créez :

• Pour les agents autonomes, le panneau inférieur comprend les éléments suivants :
  • Traçage d'exécution : affiche les détails du traçage de l'exécution en cours. Lorsque vous exécutez votre agent, cet onglet s'ouvre automatiquement pour que vous puissiez suivre les traçages en temps réel.
  • Historique : affiche toutes les exécutions de votre agent avec leurs traçages et leurs détails. À partir de là, vous pouvez ajouter des exécutions directement aux ensembles d'évaluation.
  • Évaluations – Répertorie tous vos ensembles d'évaluation, affichant les scores récents. Développez un ensemble pour afficher ses évaluations, afficher les détails ou exécuter des tests individuellement ou en tant qu'ensemble complet.
• Pour les agents conversationnels, le panneau inférieur comprend les éléments suivants :
  • Chat – Remplace l'onglet Chemin d'exécution. Fournit une fenêtre de chat interactive pour tester les conversations avec votre agent tout en affichant également le chemin d'exécution de chaque échange.
  • Historique : affiche l'ensemble de vos exécutions conversationnelles avec leurs traçages et détails. À partir de là, vous pouvez ajouter des exécutions directement aux ensembles d'évaluation.
  • Évaluations – Répertorie tous vos ensembles d'évaluation, affichant les scores récents. Développez un ensemble pour afficher ses évaluations, afficher les détails ou exécuter des tests individuellement ou en tant qu'ensemble complet.

Créer l'agent

1. Accédez à studio.uipath.com.
2. Sélectionnez le bouton Create New (Créer nouveau), puis Agent.
3. Sélectionnez le type d'agent :
   • Autonome : créez un agent qui agit de manière indépendante pour effectuer une tâche donnée.
   • Conversationnel : créez un Assistant qui interagit avec les utilisateurs via un dialogue en temps réel.
4. Pour créer un agent de A à Z, sélectionnez Partir de zéro.
5. Si vous souhaitez générer votre agent à l’aide d’Autopilot, décrivez l’agent que vous souhaitez créer dans la zone de message disponible, puis sélectionnez Générer l’agent. Soyez aussi spécifique que possible, afin qu’Autopilot puisse générer efficacement un agent.

La nouvelle solution s'ouvre et le canevas de conception Agent s'affiche.

Configurer l'agent

Lors de la configuration de votre agent, vous pouvez choisir entre deux modes de conception : la vue Formulaire traditionnelle et la vue Zone de dessin. Les deux modes partagent la même définition d'agent sous-jacente et restent entièrement synchronisés de sorte que vous pouvez passer de l'un à l'autre à tout moment sans perdre de données.

Utilisez Formulaire pour une expérience de configuration structurée étape par étape ou passez à Zone de dessin pour une mise en page visuelle basée sur des nœuds qui vous permet de voir comment les composants de votre agent se connectent et interagissent.

Créer un agent à l’aide de la vue Formulaire (par défaut)

1. Depuis le panneau Explorateur de projets à gauche, accédez à la définition de l'agent, aux ensembles d'évaluation et aux évaluateurs.

   Graphique 3. L'agent dans une solution

   

   1. The Definition panel is where you design and define the core elements of an agent. It contains four sections: General (define prompts), Tools (connect Integration Service connectors or published automations), Contexts (link Context Grounding indexes), and Escalations (set up human-in-the-loop fallbacks).
   2. Le panneau Evaluation sets (Ensembles d'évaluation) est l'endroit où vous créez des évaluations et stockez les résultats. Les évaluations mesurent objectivement les sorties de votre agent et déterminent si elles sont conformes ou non à vos objectifs. Pour de plus amples informations, reportez-vous à la section Évaluations.
   3. Le panneau Evaluators (Évaluateurs) est l'endroit où vous créez et gérez les évaluateurs utilisés dans les évaluations.

2. Sélectionnez tout d’abord votre agent dans Project Explorer. Ouvrez le menu contextuel et sélectionnez Renommer, puis attribuez un nom unique à votre agent. Le nom de l'agent permet de l'identifier dans les projets.

3. Accédez ensuite au panneau Propriétés dans le menu de droite pour sélectionner le grand modèle de langage que vous souhaitez utiliser avec votre agent.

   1. Sélectionnez un modèle dans la liste déroulante disponible. Les modèles sont fournis via UiPath AI Trust Layer. Pour de plus amples informations, consultez la section Configurer des LLM.
   2. Configurer les champs Température et Max. de jetons par réponse.Ces paramètres peuvent être contrôlés par une politique de gouvernance Automation Ops. Pour de plus amples informations, consultez la section Paramètres des politiques Studio Web.
      • Le champ Temperature détermine le facteur de créativité de la génération LLM. Vous pouvez définir une valeur comprise entre 0 (Précis) et 1 (Créatif).
      • Jetons max. par réponse fait référence au nombre maximum de jetons à générer avec la réponse de l’agent.Des valeurs plus faibles produisent des sorties plus courtes et plus concises et aident à contrôler l’utilisation tandis que des valeurs plus élevées permettent des réponses plus détaillées et complètes.
   3. Définir Max. itérations - Le nombre maximal de boucles de raisonnement que l'agent peut exécuter avant de devoir terminer la tâche ou arrêter.

4. Dans le panneau Définition de l’agent, fournissez à votre agent une invite Système et une invite Utilisateur. Ajoutez une invite bien structurée pour donner à votre agent des instructions sur ce qu’il doit faire et les contraintes qu’il doit suivre. Pour de plus amples informations, consultez la section Requêtes.

5. Utilisez le panneau Data Manager (Gestionnaire de données) pour définir les arguments d'entrée et de sortie de l'agent utilisés dans les requêtes.

   Figure 5. Arguments d'entrée dans le panneau Gestionnaire de données

   

6. Dans la section Outils, sélectionnez Ajouter un outil pour ajouter des outils que votre agent peut utiliser pendant l'exécution.Il peut s'agir d'un ensemble d'activités Integration Service, d'agents existants et d'automatisations publiées auxquelles vous avez accès. Chaque outil doit être accompagné d’une description détaillée qui aide l’agent à déterminer quand et comment utiliser cet outil. Pour de plus amples informations, reportez-vous à la section Outils.

7. (Facultatif) Dans la section Contextes, sélectionnez Ajouter un contexte pour donner à l’agent un accès aux index d’ancrage dans le contexte. Choisissez un index existant disponible dans votre locataire, ou sélectionnez Créer nouveau pour créer un nouvel index directement dans Orchestrator. Pour de plus amples informations, reportez-vous à la section Contextes.

8. (Facultatif) Dans la section Escalades, sélectionnez Ajouter une escalade pour ajouter une intervention humaine par le biais d'une application d'escalade. L'ajout d'une escalade permet à votre agent de faire appel à un humain pour examiner, approuver ou mettre à jour la sortie en cours d'exécution. Pour de plus amples informations, reportez-vous à la section Escalades.

Créer un agent à l'aide de la vue Zone de dessin

1. Ouvrez votre projet d'agent dans Studio Web.

2. Dans le coin supérieur droit de la zone de dessin au moment de la conception, sélectionnez l'option Zone de dessin dans le bouton d'activation/de désactivation du mode de création.

   • La zone de dessin s'ouvre, affichant la structure de l'agent sous forme de nœuds.
   • Vous pouvez revenir à la vue Formulaire à tout moment. Toutes les modifications sont enregistrées et traduites automatiquement entre les deux modes.

3. Commencez par le nœud LLM.

   • Sélectionnez-le pour ouvrir le panneau Propriétés à droite, puis choisissez et configurez votre modèle.
     • Sélectionnez un modèle dans la liste déroulante disponible. Les modèles sont provisionnés par le biais d'UiPath AI Trust Layer. Pour savoir comment utiliser un modèle personnalisé, consultez la section Configurer des LLM.
     • Configure the Temperature (creativity factor, 0 = Precise to 1 = Creative) and Max. tokens per response (maximum tokens for the agent's response). These settings may be controlled by an Automation Ops governance policy. For details, refer to Settings for Studio Web Policies.
     • Set Max. iterations — the maximum number of reasoning loops the agent can run before it must complete the task or stop.
   • Une fois qu'un modèle est sélectionné, le nœud est mis à jour avec l'icône de la famille de modèles correspondante et la surbrillance disparaît.

4. Configurez le nœud d'agent.

   • Le nœud Agent est créé par défaut en même temps que le nœud LLM.
   • Ouvrez la section Invite à droite pour définir vos invites système et utilisateur. Pour les Agents conversationnels, cette section est simplifiée et seule l'invite système s'affiche.
   • Ouvrez la section Schéma à gauche pour définir les arguments d'entrée et de sortie dans le panneau Gestionnaire de données.

5. Ajoutez du contexte, des outils et des escalades. Après avoir terminé les nœuds LLM et Agent, trois nouveaux types de nœuds deviennent disponibles :

   • Contexte: sélectionnez un index d'ancrage dans le contexte et ajustez ses paramètres de recherche.
   • Outils: ouvrez le palette de commandes, recherchez un outil déployé et ajoutez-le à votre zone de dessin. Vous pouvez configurer davantage chaque outil une fois celui-ci ajouté.
   • Escalades: ajoutez un nœud d’intervention humaine qui se connecte à l’expérience de configuration d’escalade existante.

6. Accédez à des options supplémentaires en sélectionnant le menu ⋮ (Plus d’actions) sur un nœud d’outil. Les actions suivantes sont disponibles :

   • Ajouter un point d'arrêt – Insère un point d'arrêt au nœud de l'outil. Lorsque l’agent est débogué, l’exécution marque une pause juste avant l’exécution de cet outil, ce qui vous permet d’inspecter ses entrées, sorties et données de Trace. Les points d'arrêt sont utiles pour vérifier la logique de l'outil et déboguer les erreurs pendant les tests de conception.

   • Ajouter un garde-fou – Ouvre la fenêtre de configuration de garde-fou où vous pouvez définir des règles qui restreignent ou surveillent l'utilisation de l'outil au moment du Runtime.

   • Désactiver - Désactive temporairement le nœud de l’outil sélectionné à partir de l’exécution de l’agent.Les outils désactivés restent sur la zone de dessin, mais sont ignorés pendant le Runtime et le débogage, ce qui vous permet de tester ou d’affiner le comportement de l’agent sans supprimer définitivement l’outil.

     

7. Déboguez votre agent.

   • Sélectionnez Debug pour exécuter votre agent en mode conception.
   • Pendant que l'agent s'exécute, les nœuds s'allumeront en séquence pour afficher le flux d'exécution.
   • Si vous exécutez des simulations, les nœuds apparaissent dans une couleur différente pour indiquer les données simulées ou les appels d’outils.
   • Pour les Agents conversationnels, une fenêtre de chat persistante vous permet de tester les échanges ; chaque message déclenche une exécution de Debug qui affiche les surbrillances sur les nœuds connectés.
   • Vous pouvez également définir des points d'arrêt sur des nœuds spécifiques pour suspendre l'exécution et inspecter les entrées, les sorties et les données de traçage.

8. Enregistrez et publiez vos modifications.

   • Toutes les mises à jour dans la vue Zone de dessin sont automatiquement stockées et restent synchronisées avec la vue Formulaire.
   • Lorsque vous êtes prêt, publiez l’agent afin de le rendre disponible pour les tests et le déploiement.

Tester l'agent

Il est maintenant temps de tester votre agent et de voir comment vous pouvez l'améliorer.

1. Accédez à la barre d'outils au-dessus du concepteur Studio Web.
2. Sélectionnez la flèche en regard de l'environnement de débogage, puis sélectionnez Configuration de débogage.
3. Dans la fenêtre Configuration du débogage , confirmez les ressources utilisées dans la solution et l'exemple d'entrée.
4. Sélectionnez Enregistrer et Exécuter.

Évaluer l'agent

Accédez ensuite aux panneaux Evaluation sets (Ensembles d'évaluation) et Evaluators (Évaluateurs) pour examiner et mesurer votre agent.

1. Dans le panneau Ensembles d'évaluation, renommez l'ensemble d'évaluation par défaut et ajoutez des cas de test avec les résultats attendus.
2. Dans le panneau Evaluators (Évaluateurs), ajoutez des évaluateurs pour valider la sortie de l'agent.

Chaque évaluation lie une entrée connue à une assertion concernant la sortie.

Calculer la note de l'agent [Aperçu]

Sélectionnez Open health score (Ouvrir la note de santé) dans le panneau de droite pour calculer la note de l'agent. Reportez-vous à la section Note de l'agent pour savoir comment elle est calculée.

Utiliser Autopilot pour améliorer votre agent [Aperçu]

Sélectionnez Open Autopilot (Ouvrir Autopilot) dans le panneau de droite pour recevoir des suggestions sur l'amélioration des requêtes, les outils et d'autres composants. Ces améliorations permettent d'accroître la note de l'agent et le rendent prêt pour le déploiement.

Publier et déployer l'agent

Une fois que vous avez testé, évalué et affiné votre agent, il est temps de le publier. Cette étape est nécessaire pour que l'agent soit disponible dans l'activité Run Job (Exécuter la tâche).

1. Sélectionnez Publish (Publier) pour publier l'agent dans Orchestrator en tant que processus. Sélectionnez l'emplacement de publication :
   1. Orchestrator Personal Workspace Feed : le processus est publié dans votre espace de travail personnel et n'est disponible qu'à vous. Il s'agit de la sélection par défaut.
   2. Orchestrator Tenant Processes Feed (Flux des processus du locataire Orchestrator) : le processus est publié dans le flux global du locataire et est disponible à tous les utilisateurs des dossiers éligibles.
2. Sélectionnez une version. Une version sera générée automatiquement, qui commencera par 1.0.0 lors de la première publication et sera automatiquement à chaque nouvelle publication.
3. Vous pouvez également sélectionner Submit as a template (Soumettre comme modèle) pour que l'agent soit disponible en tant que modèle dans votre organisation, ou Share (Partager) pour le partager avec les utilisateurs de votre organisation.

Exécuter l'agent

L'utilisation d'agents comme activités permet de les intégrer dans des flux de travail pour gérer des parties de processus déterministes de grande taille, de permettre à plusieurs agents d'agir en série, et de lancer l'exécution des agents à partir de déclencheurs.

Pour intégrer votre agent dans un workflow, procédez comme suit :

1. Publiez votre agent dans Orchestrator.
2. Dans Studio, utilisez l'activité Run Job (Exécuter la tâche) our intégrer votre agent dans un workflow.
3. Chaque fois que vous apportez des modifications à votre agent, publiez à nouveau l'agent mis à jour dans Orchestrator et mettez à niveau le processus correspondant dans Orchestrator. L'activité Run Job (Exécuter la tâche) exécute toujours la version de l'agent actuellement configurée dans Orchestrator. Cela garantit que votre workflow utilise systématiquement la version la plus récente de votre agent.

Reportez-vous au Guide des activités système pour savoir comment configurer et utiliser l'activité Run Job (Exécuter la tâche) ans vos workflows Studio.

Remarque :

Depuis la version 25.4.2 d'UiPath.System.Activities, l'exécution des agents et des autres tâches Orchestrator a été consolidée et améliorée dans le cadre de l'activité Run Job . Les workflows existants utilisant l'activité Exécuter l'agent continuent de fonctionner sans modification, ce qui garantit une transition en douceur. Lorsque vous ajoutez de nouvelles fonctionnalités d'exécution d'agent à vos workflows, le système suggère et implémente automatiquement l'activité Run Job , même si vous recherchez Run Agent.