Créer un agent dans Studio Web

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.

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 (Aperçu) : créez un Assistant qui interagit avec les utilisateurs par le biais de dialogues 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 (préversion), 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.
6. La nouvelle solution s'ouvre et le canevas de conception Agent s'affiche.

7. Lorsque vous configurez votre agent, vous pouvez choisir entre deux modes de conception : la vue Formulaire traditionnel et la vue Flux (Aperçu). Les deux modes partagent la même définition d'agent sous-jacente et restent entièrement synchronisés. Vous pouvez ainsi basculer de l'un à l'autre à tout moment sans perdre de données.

   Utilisez la vue Form pour une expérience de configuration structurée étape par étape, ou passez à la vue Flow 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.

Configurer l'agent

Lorsque vous configurez votre agent, vous pouvez choisir entre deux modes de conception : la vue Formulaire traditionnel et la vue Flux (Aperçu). Les deux modes partagent la même définition d'agent sous-jacente et restent entièrement synchronisés. Vous pouvez ainsi basculer de l'un à l'autre à tout moment sans perdre de données.

Utilisez la vue Form pour une expérience de configuration structurée étape par étape, ou passez à la vue Flow 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. Dans le panneau Project Explorer (Explorateur de projets) situé à gauche, accédez aux sections Definition (Définition), Evaluation sets (Ensembles d'évaluation) et Evaluators (Évaluateurs) de l'agent.
   Figure 1. L'agent dans une solution
   

   

   
   
   1. Le panneau Definition (Définition) est l'endroit où vous concevez et définissez les éléments principaux d'un agent. La définition contient les sections suivantes : General (Général), Tools (Outils), Contexts (Contextes) et Escalations (Escalades).
      • Utilisez la section General (Général) pour définir les requêtes de votre agent.
      • Utilisez la section Outils pour connecter des outils de runtime, tels que les connecteurs Integration Service ou les automatisations publiées.
      • Utilisez la section Contexts (Contextes) pour lier des sources de connaissances à l'aide d'index d'ancrage dans le contexte afin de permettre à votre agent d'accéder aux données pertinentes.
      • Utilisez la section Escalations (Escalades) pour configurer des interventions humaines de secours et activer la mémoire de l'agent afin de conserver les interactions et de vous aider à calibrer les futures escalades d'agents.
   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. Cliquez avec le bouton droit pour sélectionner Renommer et attribuer un nom unique à votre agent. Le nom de l’agent permet d’identifier l’agent dans les différents 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. Configurez les paramètres Température et Max. jetons par champs de 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).
   • Le champ Jetons maximum par réponse se rapporte au nombre maximal de jetons générés avec la réponse de l'agent.
   Image 2. Configurer les paramètres du modèle
   

   

   
   
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 3. Arguments d'entrée dans le panneau Data Manager
   

   

   
   
6. Dans la section Tools , sélectionnez Add tool pour ajouter tous les 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 un humain dans la boucle via une application d’escalade et activer la mémoire de l’agent. L’ajout d’une escalade permet à votre agent de faire intervenir un humain pour examiner, approuver ou mettre à jour la sortie au fur et à mesure de son exécution. Pour de plus amples informations, reportez-vous à la section Escalades et mémoire de l’agent.

Créez un agent à l’aide de la vue Flow (Aperçu)

1. Ouvrez votre projet d'agent dans Studio Web.
2. Dans le coin supérieur droit du canevas de conception, sélectionnez l'option Flux (Aperçu) dans le bouton bascule du mode de création.

   • Le canevas Flow 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 sur la 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.
     • Configurez les paramètres Température et Max. jetons par champs de 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).
       • Le champ Jetons maximum par réponse se rapporte au nombre maximal de jetons générés avec la réponse de l'agent.
   • 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 Requête sur la droite pour définir vos requêtes système et utilisateur. Pour les agents conversationnels, cette section est simplifiée et seule la requête système est affichée.
   • Ouvrez la section Schéma sur la gauche pour définir les arguments d'entrée et de sortie dans le panneau Data Manager .
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 :
   • Add Breakpoint : insère un point d'arrêt au niveau du nœud de l'outil. Lorsque l'agent est débogué, l'exécution est suspendue juste avant l'exécution de cet outil, ce qui vous permet d'inspecter ses entrées, ses sorties et ses données de traçage. Les Points d'arrêt sont utiles pour vérifier la logique de l'outil et pour déboguer les erreurs lors des tests de conception.
   • Ajouter un garde-fou : ouvre la fenêtre de configuration du garde-fou , dans laquelle vous pouvez définir des règles qui restreignent ou surveillent l'utilisation de l'outil lors du runtime.
   • Disable : désactive temporairement le nœud d'outil sélectionné de l'exécution de l'agent. Les outils désactivés restent sur le canevas mais sont ignorés lors de l'exécution et du 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 Déboguer pour exécuter votre agent au moment de la 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 débogage qui affiche des surbrillance dans 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 Flux sont stockées automatiquement 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 Debug configuration.
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.
5. Utilisez la sortie du test pour affiner la conception de l'agent.

É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 Evaluation sets , 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.

Pour de plus amples informations, reportez-vous aux sections Évaluations et Configuration des simulations dans les évaluations.

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 (Flux de l'espace de travail personnel Orchestrator) : 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 (Exécuter la tâche). Les workflows existants utilisant l'activité Run Agent (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 (Exécuter la tâche), même si vous recherchez Run Agent (Exécuter l'agent).