Créer des escalades d'agents avec les applications Action

Terminologie

• Agents: grâce à des fonctionnalités offertes par des technologies telles que les grands modèles de langage (LLM), l'apprentissage automatique et l'automatisation d'entreprise traditionnelle, les agents sont conçus pour fonctionner dans des environnements dynamiques et non déterministes. Ils peuvent planifier, agir, apprendre et s'adapter, ce qui rend leur utilisation idéale dans les processus qui nécessitent du jugement, de la flexibilité et une connaissance du contexte. Contrairement aux systèmes déterministes tels que les robots RPA, qui suivent une logique structurée et des règles fixes, les agents utilisent une approche probabiliste pour prendre des décisions en fonction de schémas et de données en temps réel. Les agents sont donc parfaitement adaptés à l'automatisation de workflows non structurés et générant beaucoup d'exceptions, lorsque les conditions et les résultats varient.

• Applications d'action: type d'application conçue dans UiPath Apps ou directement dans Studio Web, vous permettant de créer des formulaires ou des interactions d'interface utilisateur avec des options spécifiques pour les tâches nécessitant une intervention humaine (Tâches Action Center), telles que les approbations. Vous pouvez définir les propriétés d'entrée et de sortie des applications d'actions en ajoutant des propriétés d'action dans le schéma d'action.

  Remarque :

  Vous ne pouvez utiliser que des applications publiées et déployées pour configurer des escalades d'agents.

Il peut y avoir des situations où les agents sont confrontés à des défis ou nécessitent une intervention humaine pour évaluer, confirmer ou fournir des détails essentiels. Il peut s'agir d'une action délibérée, où certaines étapes sont toujours attribuées à un humain avant de revenir à un agent. Voici quelques exemples où des escalades peuvent être nécessaires : Un appel d'outil peut échouer de manière inattendue ou renvoyer des données d'une structure inattendue. Ils peuvent avoir besoin d'aide pour identifier plusieurs clients portant le même nom dans une application tierce, ou ils peuvent avoir un niveau de confiance faible dans une action. Il peut également y avoir des raisons organisationnelles pour lesquelles elles ne sont pas approuvées pour prendre certains types de décisions ou entreprendre certaines actions.

Dans tous ces cas, les agents doivent pouvoir faire remonter un chemin d'accès à un humain et :

1. Affichez tous les détails pertinents de manière efficace, simple et personnalisable.
2. Autoriser le Human-In-The-Loop (HITL) à fournir la décision ou les informations pertinentes, que ce soit via une simple décision d'approbation/de refus d'un incident ou en fournissant plusieurs détails commerciaux : e-mails, numéros de commande ou références aux comptes dans Plates-formes externes.

Il peut même être nécessaire que l’un de leurs outils soit corrigé avant de pouvoir poursuivre les opérations sur un incident métier. Vous pouvez utiliser l'outil Garde-fous pour gérer automatiquement les appels d'outils inattendus. Pour de plus amples informations, consultez la section Garde-fous. Lors de la création de procédures d'escalade pour les garde-fous, vous pouvez utiliser le modèle UiPath Marketplace suivant : Agent Tool Guardrails Escalation App.

Que sont les escalades ?

Les escalades sont des outils utilisés pour impliquer les utilisateurs dans le processus en cours d'exécution d'un agent. Les escalades sont utilisées pour évaluer ou valider les décisions d'un agent ou fournir des informations que l'agent pourrait ne pas disposer. Par conséquent, les humains ont toujours un rôle essentiel dans le maintien de la santé et de la compétence d'un agent. Vous pouvez définir les conditions des escalades spécifiques via les configurations suivantes :

• Invite système ou utilisateur : définissez l'objectif de l'agent et précisez quand utiliser une escalade spécifique.
• Escalade : sous le composant d'escalade, sélectionnez une application Action conçue pour une situation particulière. En donnant à l'application Action un nom et une description uniques, l'agent peut mieux comprendre quelle escalade il doit utiliser et quand, ainsi que les instructions de la requête système et utilisateur. Vous pouvez ajouter plusieurs procédures d'escalade à un seul agent. Vous pouvez affecter plusieurs escalades à un agent et ajouter une description à chaque entrée, permettant à l'agent d'envoyer les valeurs appropriées à l'application Action. Tous ces paramètres ont un impact considérable sur l'efficacité de l'agent et sur son score de santé global.

Important :

Les escalades ne sont pas déterministes, ce qui signifie que l'agent utilise des instructions fournies pour décider quand et quoi procéder à l'escalade. Si vous avez besoin d'une escalade cohérente et déterministe, il est recommandé d'utiliser une application Action en dehors de l'agent. Vous allez plutôt mettre fin à l'agent et utiliser ses sorties dans une action App. Veillez à prendre en compte ces recommandations en fonction de vos cas d’utilisation.

1. Créer une application Action

Vous devez d'abord créer et configurer une nouvelle application Action. Les étapes de cette procédure montrent comment créer une application qui approuve les résultats de la recherche. Vous pouvez adapter ces étapes à vos cas d'utilisation particuliers.

Remarque :

Vous pouvez configurer les escalades d'agents uniquement à l'aide des applications Action. Nous vous recommandons d’utiliser les applications Action créées dans Studio Web plutôt que les applications Action créées dans UiPath Apps.

Créer une application Action à partir de zéro

1. Accédez à Automation Suite et sélectionnez le service Studio Web.

2. Dans l'onglet Automatisations, sélectionnez Nouveau projet et choisissez le type de projet Application .

   

3. Sélectionnez un modèle, un style et les commandes souhaités. Pour les besoins de ce tutoriel, utilisez le modèle Form D. En savoir plus sur la conception de votre application.

4. Sélectionnez Nom de l'application, puis, sous l'onglet Général , sélectionnez Nom de l'application pour ouvrir l'éditeur d'expression.

5. Donnez un nom à la nouvelle application : « Application d'approbation d'outil » (Tool Approval App) et enregistrez.

6. Dans le panneau de navigation de gauche, sélectionnez FormWrapper et supprimez les contrôles que vous n'allez pas utiliser dans cet exemple : Prénom, Nom, E-mail, Téléphone, Rue, État, Zip, et Pays.

7. Sélectionnez le bouton Explorateur de projets en haut à gauche de la page, puis sélectionnez le bouton + ajouter et choisissez l'option Action .

   

8. À partir du bouton Boîte à outils en haut à gauche de la page, accédez à l'onglet Afficher et ajoutez un libellé à l'application.

   

   Vous devez maintenant transformer cette application en application Action, sinon vous ne seriez pas en mesure de l’utiliser pour configurer une escalade d’agent.

9. Sélectionnez le bouton Explorateur de projets en haut à gauche de la page, puis sélectionnez le bouton + ajouter et choisissez l'option Action . La boîte de dialogue Propriétés de l'action s'affiche.

10. Dans la boîte de dialogue Propriétés de l'action , ajoutez webSearchResults dans les Propriétés d'entrée et rendez-le Obligatoire en cochant la case associée. Les propriétés d'entrée du schéma d'action sont dérivées du contexte de l'agent et présentées à l'utilisateur. Ils sont susceptibles d'être uniques pour chaque exécution d'agent. Notez que, contrairement aux propriétés Entrée/Sortie, vous ne pouvez pas modifier ces valeurs lors de la révision. Les propriétés Input/Output sont dérivées du contexte de l'agent et vous pouvez les modifier. L'agent documente également toutes les modifications qui lui sont renvoyées. Les propriétés de sortie sont des valeurs supplémentaires que les utilisateurs peuvent saisir pour être renvoyées à l'agent.

11. Créez deux résultats: Approve et Deny.

    

    Le résultat est un événement qui, avec les propriétés Entrée/Sortie (Input/Output), est renvoyé à l'agent. Le fait de fournir un résultat significatif guide les prochaines étapes de l’agent, qui peuvent impliquer de mettre fin à son exécution en raison d’un échec. Les tests sont donc crucials.

12. Revenez au formulaire et nommez le libellé que vous avez précédemment créé dans l'éditeur d'expressions avec « webSearchResults » pour approbation : « +ActionProperties.webSearchResults ». Sélectionnez Enregistrer.

    

13. Transformez les noms de vos boutons Soumettre et Annuler en Approuver et Refuser.

14. Sélectionnez le bouton Approuver et accédez à l'onglet Événements sur la droite.

15. Ajoutez une automatisation « Un clic est réalisé sur » en sélectionnant le bouton Modifier l’automatisation .

16. Ajouter une activité Soumettre une action . En savoir plus sur l'ajout d'activités dans Studio Web.

17. Dans la section Résultat , choisissez la valeur Approuver .

18. Sélectionnez le bouton Refuser et accédez à l'onglet Événements sur la droite.

19. Ajoutez une automatisation « Un clic est réalisé sur » en sélectionnant le bouton Modifier l’automatisation .

20. Ajouter une activité Soumettre une action .

21. Dans la section Résultat , choisissez la valeur Refuser .

Créer une application Action à l’aide d’Autopilot

1. Accédez à Automation Suite et sélectionnez le service Studio Web.

2. Dans l'onglet Automatisations, sélectionnez Nouveau projet et choisissez le type de projet Application .

   

3. Sélectionnez le modèle Page vierge . Pour exploiter les fonctionnalités d’Autopilot lors de la création de l’application Action, vous devez disposer d’une application vierge.

4. À partir de l' Explorateur de projets, cliquez avec le bouton droit sur le projet d'application et dans la liste déroulante Ajouter à l'application , sélectionnez Action. Cela ouvre automatiquement le schéma Action à l’intérieur de l’application.

5. Dans la section Avec Autopilot , saisissez les instructions pour Autopilot afin de générer le schéma d’action. Par exemple, vous pouvez saisir : « Créer un schéma d’action, où était un argument d’entrée est Âge, un argument d’entrée/de sortie est le salaire et un argument de sortie est le taux d’intérêt. »

6. Sélectionnez Générer une action pour générer le schéma d’action.

7. Sélectionnez Générer une page à partir d'un schéma pour générer une configuration d'application basée sur le schéma d'action précédemment généré.

8. Actualisez le projet Studio Web. Votre application Action est maintenant prête à être publiée et déployée.

Publier et déployer l'application Action

Pour que cette application d'action soit disponible dans l'organisation, vous devez la publier et la déployer :

1. Sélectionnez Publier.
2. Choisissez le nom « EscalationTestApp » et sélectionnez à nouveau Publier .
3. En fonction de l'emplacement où vous créez l'application Action, déployez l'application comme suit :
   • Si vous avez créé l'application dans un projet d'application, accédez à Orchestrator et déployez l'application.
   • Si vous avez créé l'application dans le cadre d'une solution dans Studio Web, accédez à l'onglet Solutions dans Orchestrator et déployez l'application. Assurez-vous qu'elle s'exécute sur un runtime sans serveur.
4. Après avoir déployé l’application, sélectionnez le bouton Modifier les détails du processus .
5. Sélectionnez Suivant.
6. Dans la section Cloud Robot - Serverless , choisissez l’option Moyenne . C'est l'option que nous recommandons pour de meilleures performances avec les Web Apps.
7. Sélectionnez Update (Mettre à jour).

2. Créer un agent

1. Créez un nouvel agent en suivant cette procédure de création d’agent.

2. Dans le champ Invite système, saisissez les informations suivantes : « Utilisez l'outil de recherche Web pour effectuer une recherche sur l'élément de recherche fourni. Vous devez alors procéder à une escalade afin de confirmer que le résultat de la recherche est satisfaisant avant de renvoyer votre résultat final, c’est-à-dire une simple ligne de la recherche sur le Web. »

3. Dans le champ Invite utilisateur , saisissez les éléments suivants : Do a search on term:.

4. Dans la partie gauche de votre projet, sélectionnez Ouvrir le gestionnaire de données et, dans l'onglet Entrée , sélectionnez Ajouter une propriété.

5. Sélectionnez Modifier le nom et saisissez searchTerm. Sélectionnez Appliquer pour enregistrer les modifications.

6. Dans le champ Description , saisissez the search term provided from the user.

7. Dans l'onglet Sortie , sélectionnez Ajouter une propriété et définissez le nom sur Output et la description sur natural language summary of the approved search results.

8. Sélectionnez Requis pour rendre cette propriété obligatoire.

   Figure 1. La requête utilisateur et système de l'agent

   

9. Revenez à l' invite utilisateur et ajoutez la propriété précédemment créée à l'aide d'accolades doubles {{ }}.

   Dans cet exemple, entrez les crochets à double ouverture {{, puis sélectionnez searchTerm.

10. Dans la section Outils , sélectionnez Ajouter un outil, puis accédez à l'onglet Activités .

11. Recherchez et sélectionnez l'activité Web Search .

12. Ouvrez le panneau Propriétés de cette activité et, dans la liste déroulante Connexion des activités UiPath GenAI , sélectionnez une connexion existante. Vous pouvez également sélectionner Définir nouveau pour créer une nouvelle connexion, ou sélectionner Ouvrir les connexions pour accéder à Integration Service.

13. Dans le champ Moteur de recherche , sélectionnez une recherche GoogleCustomSearch.

14. Dans la section Description de la recherche , dans le menu de réglage, sélectionnez Argument, puis sélectionnez l'argument précédemment créé, qui doit contenir le sujet que vous souhaitez rechercher sur le Web. L'agent utilise également la description de l'argument, fournie dans le Gestionnaire de données, dans la requête de l'utilisateur.

    Image 2. Le panneau Propriétés de l’activité Web Search

    

15. Dans la section Escalades , sélectionnez Ajouter une escalade:

    1. Sélectionnez l'application Action précédemment créée et déployée dans la liste déroulante App . Dans cet exemple, sélectionnez EscalationTestApp.
    2. Dans le champ Invite , saisissez Use this to confirm the search results is satisfactory with the assignee.
    3. Développez la section Entrées pour afficher les champs de l'application Action.

    Figure 3. Configurer l'escalade de l'agent

    

16. Exécutez l’agent.

17. Dans l'onglet Traçages de l'agent, sélectionnez l'URL de la tâche en attente avec le bénéficiaire précédemment configuré.

    1. Passez en revue la tâche d'escalade en attente et approuvez-la si tout est en ordre.
       
    Remarque :

    L'agent sera suspendu jusqu'à ce que l'escalade soit résolue par l'utilisateur affecté dans Action Center.

18. Revenez à l'espace de travail Agents, où vous devriez voir l'agent exécutant la tâche et fournissant la sortie attendue.