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. When configuring your agent, you can choose between two design modes: the traditional Form view and the Flow view (Preview). Both modes share the same underlying agent definition and remain fully synchronized, so you can switch between them at any time without losing data.

   Use Form view for a structured, step-by-step configuration experience, or switch to Flow view for a visual, node-based layout that lets you see how your agent’s components connect and interact.

Configurer l'agent

When configuring your agent, you can choose between two design modes: the traditional Form view and the Flow view (Preview). Both modes share the same underlying agent definition and remain fully synchronized, so you can switch between them at any time without losing data.

Use Form view for a structured, step-by-step configuration experience, or switch to Flow view for a visual, node-based layout that lets you see how your agent’s components connect and interact.

Build an agent using Form view (Default)

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. Select a model from the available dropdown list. Models are provisioned through UiPath AI Trust Layer. For details, refer to Configuring LLMs.
   2. Configure the Temperature and Max. tokens per response fields. These settings may be controlled by an Automation Ops governance policy. For details, refer to Settings for Studio Web Policies.
   • 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.

Build an agent using Flow view (Preview)

1. Open your agent project in Studio Web.
2. In the top-right corner of the design-time canvas, select the Flow (Preview) option from the authoring mode toggle.

   • The Flow canvas opens, displaying the agent structure as nodes.

   • You can switch back to Form view at any time. All changes are saved and translated automatically between the two modes.

3. Start with the LLM node.
   • Select it to open the Properties panel on the right, then choose and configure your model.
     • Select a model from the available dropdown list. Models are provisioned through UiPath AI Trust Layer. To learn how to use a custom model, refer to Configuring LLMs.
     • Configure the Temperature and Max. tokens per response fields. These settings may be controlled by an Automation Ops governance policy. For details, refer to Settings for Studio Web Policies.
       • 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.
   • Once a model is selected, the node updates with the corresponding model family icon and the highlight disappears.
4. Configure the Agent node.
   • The Agent node is created by default alongside the LLM node.
   • Open the Prompt section on the right to define your system and user prompts. For conversational agents, this section is simplified and only the system prompt is shown.
   • Open the Schema section on the left to define input and output arguments in the Data Manager panel.
5. Add context, tools, and escalations. After completing the LLM and Agent nodes, three new node types become available:
   • Context: Select a Context Grounding index and adjust its search parameters.
   • Tools: Open the command palette, search for a deployed tool, and add it to your canvas. You can further configure each tool once added.
   • Escalations: Add a human-in-the-loop node that connects to the existing escalation configuration experience.
6. Access additional options by selecting the ⋮ (More actions) menu on a tool node. The following actions are available:
   • Add breakpoint – Inserts a breakpoint at the tool node. When the agent is debugged, execution pauses just before this tool runs, allowing you to inspect its inputs, outputs, and trace data. Breakpoints are useful for verifying tool logic and debugging errors during design-time testing.
   • Add guardrail – Opens the Guardrail configuration window, where you can define rules that restrict or monitor how the tool is used at runtime.
   • Disable – Temporarily disables the selected tool node from agent execution. Disabled tools remain on the canvas but are skipped during runtime and debugging, allowing you to test or refine the agent’s behavior without permanently removing the tool.
     
     

     

     
     
7. Debug your agent.
   • Select Debug to run your agent in design time.
   • As the agent executes, nodes light up in sequence to show the execution flow.
   • If you run simulations, nodes appear in a different color to indicate mocked data or tool calls.
   • For conversational agents, a persistent chat window allows you to test exchanges; each message triggers a debug run that displays highlights across the connected nodes.
   • You can also set breakpoints on specific nodes to pause execution and inspect inputs, outputs, and trace data.
8. Save and publish your changes.
   • All updates in Flow view are stored automatically and remain synchronized with Form view.
   • When ready, publish the agent to make it available for testing and deployment.

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. Use the test output to refine the agent design.

Évaluer l'agent

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

1. In the Evaluation sets panel, rename the default evaluation set and add test cases with expected outcomes.
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.

For details, refer to Evaluations and Configuring simulations in evaluations.

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).