Créer un agent dans Studio Web

Cette section explique comment créer un agent dans Studio Web. Une fois que vous avez acquis les notions de base, consultez la section 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.

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.

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.

Graphique 1. L'espace de travail des Agents

Créer l'agent

1. Accédez à studio.uipath.com.
2. Sélectionnez le bouton Create New (Créer nouveau), puis Agent.
3. La nouvelle solution s'ouvre et le canevas de conception Agent s'affiche.

   [Aperçu] La zone de message Agent Autopilot s’affiche, dans laquelle vous pouvez décrire en langage naturel l’agent que vous souhaitez créer. Soyez aussi spécifique que possible, afin qu’Autopilot puisse générer efficacement un agent.

Configurer l'agent

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 2. L'agent à l'intérieur d'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 Tools pour connecter des outils d'exécution, tels que des connecteurs Integration Service ou des 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. Sélectionnez Utiliser un modèle personnalisé pour apporter votre propre modèle ou votre propre abonnement. Pour de plus amples informations, consultez la section Configurer des LLM.
   2. Configurer les champs Temperature (Température) et Max. tokens per response (Nombre maximum de jetons par réponse) :
   • 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.
   Figure 3. Configuration des 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 4. Arguments d'entrée dans le panneau Gestionnaire de données
   

   

   
   
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.

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 le à côté de l'environnement de débogage.
3. Sélectionnez Configuration de débogage.
4. Dans la fenêtre Configuration du débogage , confirmez les ressources utilisées dans la solution et l'exemple d'entrée.
5. Sélectionnez Enregistrer et Exécuter.

Vous pouvez ensuite utiliser 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 (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.

Pour de plus amples informations, reportez-vous à la section É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).

Utiliser des modèles d'agents

Vous pouvez commencer votre parcours agentique avec un ensemble de modèles d'agents, disponibles sur la page Agents d'Automation Cloud^TM et dans UiPath® Marketplace.

Un modèle d'agent est préconfiguré pour des tâches spécifiques. Il nécessite une configuration minimale pour s'exécuter dans Studio, et vous pouvez le modifier et l'adapter à vos besoins spécifiques. Un modèle d'agent comporte les éléments suivants :

• Composants prédéfinis : requêtes système, outils d'activité avec descriptions, ensembles d'évaluation de démarrage.
  • Les composants sont génériques et non spécifiques à une entreprise ou à une organisation.
  • Les composants sont facilement disponibles dans la définition de l'agent. Il est possible que certains composants (tels que les activités utilisées comme outils) nécessitent une configuration supplémentaire, comme la création des connexions nécessaires dans Integration Service.
• Composants qui nécessitent une configuration supplémentaire : des index d'ancrage dans le contexte, des automatisations et des processus en tant qu'outils, des escalades personnalisées et toutes les descriptions connexes (instructions destinées à l'agent).
  • Ces composants sont spécifiques à l'organisation et au locataire.

Pour commencer à utiliser les modèles d'agent de UiPath Marketplace, procédez comme suit :

1. Sur la page Agents d'Automation Cloud, accédez à l'onglet Templates (Modèles) et sélectionnez un modèle.

   Vous êtes redirigé vers le modèle depuis Marketplace.

2. Sélectionnez Télécharger.
3. Dans la fenêtre Downloading an agent template (Télécharger un modèle d'agent), sélectionnez Download Solution (Télécharger une solution).
   Un fichier .uis contenant la définition de l'agent est téléchargé sur votre machine.
4. Les modèles d'agents incluent également des extras, un package distinct contenant des ressources pour votre agent (automatisations, escalades personnalisées). Sélectionnez Download Extras (Télécharger les extras).
   Un fichier .zip est téléchargé sur votre machine.
5. Dans Studio Web, importez le fichier de définition de l'agent .uis comme décrit dans la section Importer un projet téléchargé depuis Studio Web.
6. Ensuite, accédez à la section Solutions. Pour de plus amples informations, consultez la section Accéder à l'interface utilisateur Solutions.
7. Téléchargez le fichier .zip, comme expliqué dans la section Transporter un package de solution, puis déployez la solution. Pour de plus amples informations, consultez la section Déployer la solution.
8. Vous pouvez désormais accéder à votre modèle d'agent depuis Studio Web et ajouter tous les outils déployés à votre locataire.