Garde-fous personnalisés

Les garde-fous personnalisés fournissent un mécanisme permettant de contrôler de manière déterministe les comportements inattendus lors des appels d'outils. Ils permettent aux développeurs de configurer les conditions d'intervention humaine et de garantir que les escalades se produisent précisément lorsque les conditions définies sont remplies.

En bref, les rôles des garde-fous sont les suivants :

• Gérez les entrées et les sorties imprévisibles des appels d'outils au moment de l'exécution.
• Réduire la nécessité des interventions humaines (human-in-the-loop, HITL) dans les tâches de correction et de validation.
• Permettre aux développeurs de créer des règles personnalisées au niveau de chaque outil.

Mode de fonctionnement

Les garde-fous de chaque agent sont définis comme suit :

• Chaque outil peut posséder un ou plusieurs garde-fous.
• Chaque garde-fou contient une ou plusieurs règles et une action. Les règles sont évaluées par rapport aux entrées et aux sorties de l'outil.
• Une action est déclenchée lorsque toutes les règles sont respectées. L'action peut se produire avant et/ou après l'exécution de l'outil.

Les garde-fous s'affichent dans le panneau Propriétés pour chaque type d'outil (automatisations, activités ou autres agents). Le générateur de garde-fous est l'endroit où vous définissez la liste des règles qui déclenchent le garde-fou et l'action à appliquer lorsque toutes les règles sont respectées.

Au moment de l'exécution, les garde-fous sont vérifiés de haut en bas dans l'ordre dans lequel ils apparaissent dans la liste. Vous pouvez réorganiser les garde-fous selon les besoins en effectuant une action de glisser-déposer à l'aide de l'icône de menu située à gauche.

Utilisez l'option Enable guardrail for evaluations (Activer le garde-fou dans les évaluations) pour appliquer également le garde-fou sélectionné pendant les évaluations.

Configurer des garde-fous

Pour configurer les garde-fous d'un outil, procédez comme suit :

1. Ajoutez un outil à votre agent.
2. Sélectionnez l'outil et ouvrez le panneau Propriétés.
3. Dans le Générateur de garde-fous personnalisé, définissez le nom et la description du garde-fou.
4. Ensuite, configurez les types de règle et d’action.
5. Sélectionnez Save (Enregistrer). Les outils dotés de garde-fous sont accompagnés d'une icône de bouclier.

Figure 1. Un outil d'activité avec des garde-fous appliqués

Types de règles

Les types de règles disponibles sont les suivants :

• Always enforce the guardrail (default) : ce garde-fou déclenche toujours l'action, quelles que soient les entrées ou les sorties. Cela s'applique aux entrées de l'agent (pré-exécution), à ses sorties (post-exécution), ou aux deux (pré et post-exécution).
• String : ce garde-fou s'applique aux champs d'entrée et de sortie disponibles. La règle s'applique aux champs de chaînes de caractères, y compris aux champs JSON imbriqués, et prend en charge différents opérateurs (contient, commence par, se termine par, est égal à, est vide, etc.)
• Number : ce garde-fou s'applique aux champs d'entrée et de sortie disponibles. La règle s'applique aux champs numériques, y compris aux champs JSON imbriqués, et prend en charge différents opérateurs (contient, commence par, se termine par, est égal à, est vide, etc.).
• Boolean : ce garde-fou s'applique aux champs d'entrée et de sortie disponibles. La règle s'applique aux champs booléens, y compris aux champs JSON imbriqués, et prend en charge l'opérateur Equals, avec les valeurs True ou False.

Types d'action

Pour chaque règle, vous appliquez l'action à effectuer lorsque toutes les règles sont respectées.

Les types d'actions disponibles sont les suivants :

• Log : définit un niveau de gravité pour la journalisation. Cette action est utile pour envoyer des événements personnalisés à la surveillance du tableau de bord
• Filter (Filtrer) : supprime les champs sélectionnés de l'entrée et/ou de la sortie d'un outil, comme suit :

  • Entrées : les champs sélectionnés ne sont pas envoyés à la demande d'outil de l'API.

  • Sorties : les champs sélectionnés ne sont pas renvoyés à l'agent.

    Remarque :

    La qualité de l'agent peut être affectée si des informations critiques sont éliminées par le filtre.

• Block : empêche l'exécution de l'outil lorsque des conditions sont remplies. Lorsque vous utilisez cette option, vous devez fournir la raison du blocage. Le blocage d'un outil peut entraîner l'échec de l'agent.
• Escalate (Escalader) : affecte une escalade à un utilisateur à l'aide d'une application d'escalade compatible.

Exécuter des garde-fous

Après avoir exécuté l'agent, le panneau de sortie s'affiche :

• Le statut d'une exécution réussie.
• La présence de garde-fous dans le traçage.
• Les détails des garde-fous appliqués ou ignorés.

Utiliser une application d'escalade pour les garde-fous

L'action Escalate (Escalader) nécessite une application compatible. Un modèle est disponible sur UiPath Marketplace sous le nom suivant : Agent Tool Guardrail Escalation App.

Pour rendre l'application disponible pour les garde-fous, procédez comme suit :

1. Téléchargez le modèle d'application depuis Marketplace et importez le fichier .uip dans un nouveau projet Studio. Pour de plus amples informations, consultez la section Importer des projets d'applications dans le guide de l'utilisateur de Studio Web.
2. Vous pouvez ajouter de nouveaux contrôles et de nouveaux événements à l'application, mais ne modifiez pas le schéma d'action sous-jacent. La modification du schéma rend l'application incompatible avec l'escalade des garde-fous.
3. Publiez l'application, comme décrit dans la section Publier des projets d'applications.
4. Accédez à Orchestrator et déployez l'application dans un dossier partagé, comme décrit dans la section Déployer des projets d'applications. Vérifiez que des robots sans serveur sont disponibles dans le dossier afin d'éviter les erreurs lors de l'exécution de l'escalade.
5. Retournez à votre agent et sélectionnez l'application récemment déployée pour vos garde-fous.