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

Terminologie:

• Agents: grâce à des capacités assistées par des technologies telles que les modèles LLM (Large Language Model), l'apprentissage automatique et l'automatisation traditionnelle de l'entreprise, les agents sont conçus pour fonctionner dans des environnements dynamiques et non déterministe. Ils peuvent planifier, agir, apprendre et s’adapter, ce qui les rend idéaux pour les processus qui nécessitent duRoU, de la flexibilité et une sensibilité contextuelle.

  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: un type d’application conçu dans les applications UiPath 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'action en ajoutant des propriétés d'action dans le schéma d'action.
  Remarque : vous ne pouvez utiliser que les applications publiées et déployées pour configurer les escalades d'agent.

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.

Les agents peuvent même avoir besoin que l'un de leurs outils soit corrigé avant de pouvoir poursuivre leurs opérations sur un incident métier. Vous pouvez utiliser l’outil Gardes (Capture) pour gérer automatiquement les appels d’outils inattendus. Pour plus d'informations, consultez Gardes-corps. Lors de la création d'escalades pour les gardes-corps, vous pouvez utiliser le modèle UiPath Marketplace suivant : Outil d'agent (Agent Tool) Garde-corps (Escalade 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 du système et de l'invite utilisateur. Vous pouvez ajouter plusieurs escalades à un seul agent. Vous pouvez attribuer plusieurs escalades à un agent et ajouter une description à chaque entrée, permettant ainsi à l’agent d’envoyer les valeurs appropriées à l’application Action. Tous ces paramètres ont un impact significatif sur l’efficacité et le score de santé global de l’agent. . Pour plus d'informations sur le score d'un agent, consultez Score des agents.

Attention : Les escalades ne sont pas déterministe, ce qui signifie que l’agent utilise les instructions fournies pour décider quand et quoi faire remonter. Si vous avez besoin d'une escalade cohérente et déterministe, il est recommandé d'utiliser une application d'action en dehors de l'agent. Au lieu de cela, vous supprimeriez l’agent et utiliseriez 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 des escalades d'agents uniquement à l'aide d'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 Cloud™ et sélectionnez le service Studio Web.
2. Dans l’onglet Automatisations, sélectionnez Nouveau projet, puis choisissez le type de projet d’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 (App name), puis, sous l'onglet Général (General) , sélectionnez Nom de l'application (App name) 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 de l'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 (Toolbox) en haut à gauche de la page, accédez à l'onglet Affichage (Display ) 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 de l'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 (Action properties) s'affiche.
10. Dans la boîte de dialogue Propriétés de l'action (Action properties) , ajoutez webSearchResults dans les Propriétés d'entrée (Input Properties) et rendez-le Obligatoire (Mandatory) en cochant la case correspondante.

    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 (Input/Output), vous ne pouvez pas modifier ces valeurs pendant la révision. Les propriétés Entrée/Sortie (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 : Approuver et Refuser.
    
    
    
    

    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'expression avec « webSearchResults for Approbation est : "+ActionProperties.webSearchResults. Sélectionnez Enregistrer.
    
    
    
    
13. Changez les noms de vos boutons Soumettre (Submit) et Annuler (Cancel) en Approuver et refuser (Approve and Deny).
14. Sélectionnez le bouton Approuver (Approve) et accédez à l'onglet Événements (Events) sur la droite.
15. Ajoutez une automatisation « Cliquer sur » (Clicked on) en sélectionnant le bouton Modifier l'automatisation (Edit automation) .
16. Ajouter une activité Soumettre une action (Submit Action) .

    En savoir plus sur l'ajout d'activités dans Studio Web.

17. Dans la section Résultat (Outcome) , choisissez la valeur Approuver (Approve ).
18. Sélectionnez le bouton Refuser (Deny) et accédez à l'onglet Événements (Events) sur la droite.
19. Ajoutez une automatisation « Cliquer sur » (Clicked on) en sélectionnant le bouton Modifier l'automatisation (Edit automation) .
20. Ajouter une activité Soumettre une action (Submit Action) .

    En savoir plus sur l'ajout d'activités dans Studio Web.

21. Dans la section Résultat (Outcome) , choisissez la valeur Refuser (Deny ).

Créer une application Action à l’aide de Autopilot^TM

1. Accédez à Automation Cloud™ et sélectionnez le service Studio Web.
2. Dans l’onglet Automatisations, sélectionnez Nouveau projet, puis choisissez le type de projet d’application .
   
   
   
   
3. Sélectionnez le modèle de page vierge (Blank Page) .

   Pour tirer parti des fonctionnalités d’Autopilot dans la création de l’application Action, vous devez disposer d’une application vierge.

4. Dans 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 Actions (Action schema) dans l'application.

5. Dans la section Avec Autopilot , saisissez les instructions d’Autopilot afin de générer le schéma d’action.

   Par exemple, vous pouvez saisir : « Créer un schéma d'action ; si un argument d'entrée était Â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 (Generate 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 ( Publish).
2. Choisissez le nom « EscalationTestApp » et sélectionnez à nouveau Publier (Publish) .
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'il s'exécute sur un runtime sans serveur.

4. Une fois l'application déployée, sélectionnez le bouton Modifier les détails du processus (Edit the process details) .
5. Sélectionnez Suivant.
6. Dans la section Cloud Robot - Serverless , choisissez l'option Moyen (Medium) . Il s’agit de l’option que nous recommandons pour de meilleures performances avec les applications Web.
7. Sélectionnez Mettre à jour (Update).

2. Créer un agent

1. Créez un nouvel agent en suivant cette procédure de création d'agents.
2. Dans le champ Invite du système (System prompt), saisissez les informations suivantes : Utiliser l'outil de recherche Web (Use the web search tool) pour effectuer une recherche sur l'élément de recherche fourni. Vous devez alors générer une escalade pour confirmer que le résultat de la recherche est satisfaisant avant de renvoyer votre sortie finale, une simple ligne de la recherche web.
3. Dans le champ Invite de l'utilisateur (User prompt) , saisissez les informations suivantes : Faire une recherche par terme :.
4. Dans la partie gauche de votre projet, sélectionnez Ouvrir le gestionnaire de données (Open Data Manager) et, dans l'onglet Entrée (Input) , sélectionnez Ajouter une propriété (Add property).
5. Sélectionnez Modifier le nom (Edit Name) et saisissez terme de recherche (searchTerm). Sélectionnez Appliquer (Apply) pour enregistrer les modifications.
6. Dans le champ Description , saisissez le terme de recherche fourni par l’utilisateur.
7. Dans l'onglet Sortie (Output) , sélectionnez Ajouter une propriété (Add property) et définissez le nom sur Output et la description comme résumé en langage naturel des résultats de recherche approuvés.
8. Sélectionnez Obligatoire (Required) pour rendre cette propriété obligatoire.
   Figure 1. L'invite utilisateur et système de l'agent
   

   

   
   
9. Revenez à l' invite utilisateur et ajoutez la propriété précédemment créée en utilisant les doubles crochets {{ }}.
   Dans cet exemple, entrez les crochets à double ouverture {{, puis sélectionnez searchTerm.
10. Dans la section Outils (Tools) , sélectionnez Ajouter un outil (Add tool) et accédez à l'onglet Activités (Activities ).
11. Recherchez et sélectionnez l'activité Recherche Web (Web Search) .
12. Ouvrez le panneau Propriétés (Properties) de cette activité et dans la liste déroulante Connexion des activités UiPath GenAI (UiPath GenAI Activities Connection) , sélectionnez une connexion existante.

    Vous pouvez également sélectionner Définir nouveau (Define new) pour créer une nouvelle connexion, ou sélectionner Ouvrir les connexions (Open connections) pour accéder à Integration Service.

13. Dans le champ Moteur de recherche (Search moteur) , sélectionnez une activité GoogleCustomSearch.
14. Dans la section Description de la recherche (Search description) , sélectionnez Argument dans le menu de réglage, puis sélectionnez l'argument créé auparavant, 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 le cadre de l'invite utilisateur.

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

    

    
    
15. Dans la section Escalade (Escalade) , sélectionnez Ajouter une escalade (Add escalade) :
    1. Sélectionnez l'application Action précédemment créée et déployée dans la liste déroulante Application .
       Dans cet exemple, sélectionnez EscalationTestApp.
    2. Dans le champ Invite (Prompt) , saisir Utiliser ceci (Use this) pour confirmer que les résultats de la recherche sont satisfaisants pour le bénéficiaire.
    3. Développez la section Entrées (Inputs) pour afficher les champs de l'application Action.
    Figure 3. Configuration de la remontée d’agent
    

    

    
    
16. Exécutez l'agent.
17. Dans l'onglet Traçages (Traces) 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 dans un état 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.