Créer un agent dans Agent Builder

Cette section décrit comment concevoir un agent dans Agent Builder.

Important : l'expérience Agent Builder devrait devenir obsolète à partir du 14 juin 2025. Jusque-là, vous pouvez uniquement concevoir ou évaluer des agents existants. Nous vous recommandons de migrer vos agents existants et de commencer à utiliser Agents dans Studio Web. Pour de plus amples informations, consultez la section Migrer des agents vers Studio Web.

Pour créer de nouveaux agents, consultez la section Créer un agent dans Studio Web.

1. Dans UiPath® Automation Cloud^TM, sélectionnez Agents dans la barre de navigation de gauche. L’espace de travail Agents s’affiche.
2. Dans la liste Preview Agents (Agents en aperçu), sélectionnez un agent pour ouvrir Agent Builder.
3. L'espace de travail Agents comprend trois onglets : Conception, Évaluations et Traçages.
   • Utilisez l'onglet Conception pour concevoir et définir les éléments principaux de votre agent. Une fois que vous avez défini les arguments d'entrée/sortie, vous pouvez utiliser cet espace pour prévisualiser les exécutions de votre agent.
   • Utilisez l'onglet Évaluations pour créer des évaluations et stocker les résultats. Les évaluations mesurent objectivement les sorties de votre agent et déterminent si elles sont conformes ou non à vos objectifs.
   • Utilisez l'onglet Traçages pour consigner et représenter toutes les durées de conception et d'évaluation de cet agent. C'est ici que vous pouvez voir toutes les exécutions effectuées par un agent et les détails des exécutions.
4. Sélectionnez le grand modèle de langage que vous souhaitez utiliser avec votre agent. Les modèles sont provisionnés par le biais d'UiPath AI Trust Layer.
   1. Pour configurer les paramètres du modèle, sélectionnez l'icône des paramètres située en regard du champ Modèle. Vous pouvez configurer ici les champs Température et Jetons maximum par réponse.
      • Le champ Température 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 2 (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.
5. Dans l'onglet General (Général), modifiez le nom et la description de l'agent.

   Le nom et la description de l'agent doivent fournir des détails sur l'objectif de l'agent dans un langage simple. La description permet d'identifier l'agent dans Studio.

6. Dans l'onglet Requête, ajoutez une requête système bien structurée et une requête utilisateur pour indiquer à votre agent ce qu'il doit faire et les contraintes qu'il doit respecter.
7. Sélectionnez Arguments pour accéder à la fenêtre Arguments, dans laquelle vous pouvez configurer les arguments d'entrée et de sortie utilisés dans votre requête.
8. Dans l'onglet Tools (Outils), ajoutez tous les outils que votre agent peut utiliser pendant l'exécution. Il peut s'agir d'un ensemble d'activités du service d'intégration, de processus publiés auxquels vous avez accès ou d'autres agents.

   Chaque outil doit être accompagné d'une description détaillée qui aide l'agent à déterminer quand et comment utiliser cet outil.

9. Utilisez l'onglet Contextes pour ajouter tout contexte nécessaire.

   Les index Ancrage dans le contexte permettent à un agent d'accéder aux bases de connaissances autorisées. Cela contribue à ancrer les actions ou les réponses de l'agent dans vos données métier.

10. Utilisez l'onglet Escalades pour ajouter un humain dans la boucle et activer la mémoire de l'agent.

    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.

11. Dans la fenêtre Terrain de jeu, fournissez une entrée pour effectuer un test et sélectionnez Exécuter.

    Vous devez tester votre agent pour vérifier qu'il fonctionne comme prévu.

12. Ensuite, accédez à l'onglet Évaluations pour examiner et évaluer votre agent.

    Une évaluation est une paire entre une entrée et une assertion appliquée à la sortie, pouvant être utilisée pour évaluer votre agent lors d'une exécution de bout en bout.

13. Après avoir effectué les évaluations, utilisez l'onglet Traçages pour consulter tous les journaux de traçage de votre agent.
14. Une fois que vous avez testé, évalué et affiné votre agent, sélectionnez Publier pour le publier dans Orchestrator en tant que processus.
    • Sélectionnez l'emplacement de publication :
      • Flux de l'espace de travail personnel d'Orchestrator : le processus est publié dans votre espace de travail personnel et vous sera disponible en exclusivité. Il s'agit de la sélection par défaut.
      • Flux du processus du locataire Orchestrator : le processus est publié dans le flux global du locataire et est disponible à tous les utilisateurs affectés à des dossiers qui utilisent le flux du locataire.
    • 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.
    Important : cette étape est nécessaire pour que l'agent soit disponible dans l'activité Run Job (Exécuter la tâche).

    Sélectionnez Exporter pour afficher et créer un package de la définition de l'agent au format JSON. Vous pouvez ensuite utiliser cette extraction JSON pour importer l'agent dans une autre organisation.

15. Enfin, insérez votre agent dans une automatisation à l'aide de l'activité Run Job (Exécuter la tâche) de Studio. Pour de plus amples informations, consultez la section Exécuter l'agent.

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