Gérer les agents UiPath

La page Agents dans Automation Cloud sert de registre centralisé et de hub d'observabilité pour tous les agents UiPath. Utilisez-le pour surveiller les performances, tester le comportement conversationnel, gérer les ressources partagées et conserver une visibilité sur l'ensemble de votre écosystème déployé.

Depuis un seul endroit, vous pouvez :

• Surveiller les agents déployés et examiner les mesures de performance en temps réel.
• Testez les agents conversationnels avant et après le déploiement.
• Enquêter sur les incidents d'agent ou résoudre les problèmes de fonctionnement dégradé.
• Accéder aux modèles d'agent et les déployer depuis UiPath Marketplace.
• Gérer les index d'ancrage dans le contexte.

Ce hub centralisé permet de surveiller en temps réel tous les runtimes de l'agent, avec des alertes en cas d'erreurs, de dégradation des notes de santé et de mauvaises notes d'évaluation des runtimes.

Terminologie

• Une instance d'agent est un agent unique déployé au sein d'un processus métier en cours d'exécution, représenté sous forme de tâche dans BPMN. Il s'agit de l'exécution en cours d'un runtime d'agent qui répond à des déclencheurs, des files d'attente ou d'autres conditions de workflow spécifiques.​
• La gestion des instances d'agent représente l'ensemble des tâches liées à la surveillance, la maintenance, l'amélioration et l'arrêt des agents et des tâches d'agent.

Fonctionnalités clés

Voici les principales fonctionnalités de la page Agents redessinée dans Automation CloudTM :

• Surveillance des agents en temps réel à l'aide de workflows BPMN.
• Gestion et récupération des erreurs par le biais d'événements définis par BPMN.
• Coordination entre agents et opérateurs humains en cours d'exécution.
• Gestion de la fusion et des consensus par le biais de passerelles de prise de décision.
• Analyse et optimisation des performances basées sur plusieurs mesures.
• Des contrôles de gouvernance et de conformité garantissent le respect des règles d'entreprise.

Vue d'ensemble (Overview)

L'onglet Présentation fournit un résumé de haut niveau de votre écosystème d'agents, consolidant les Insights opérationnels, les indicateurs de performance et les analyses de consommation dans une vue centralisée. Il sert de centre de commande pour comprendre les performances des agents au sein de votre organisation et évaluer leur efficacité dans l'utilisation des ressources.

Insights sur les performances

L'onglet agrège les données de runtime sur tous les agents déployés pour vous aider à surveiller les tendances des performances et à identifier les opportunités d'optimisation. Les mesures clés incluent :

• Total des tâches : suit le nombre total d'exécutions d'agent terminées, fournissant une mesure de l'activité et de l'adoption.
• Taux de réussite : mesure le pourcentage d'exécutions réussies de l'agent pour vous aider à évaluer la fiabilité et à détecter les erreurs récurrentes ou l'instabilité dans les configurations de l'agent.
• Temps de réponse moyen : indique la rapidité avec laquelle vos Agents sont capables d’effectuer des tâches, ce qui vous permet de surveiller la latence et l’efficacité à grande échelle.
• Consommation d'Agent Unit : quantifie l'utilisation totale d'Agent Unit de tous les agents, ce qui permet d'améliorer les prévisions, la budgétisation et l'allocation des ressources.

Analyses de surveillance et de commentaires

L'onglet fait également apparaître les tendances de consommation et de commentaires dans votre environnement :

• Les rapports de consommation d'Agent Unit identifient les agents les plus actifs ou les plus coûteux, ce qui aide à hiérarchiser le réglage ou l'allocation des ressources.
• Les résumés des commentaires mettent en évidence les agents qui reçoivent le plus d'interactions utilisateur ou d'évaluations de performance, ce qui aide les équipes à se concentrer sur l'amélioration de l'expérience utilisateur et de l'impact.

Filtre et analyse basée sur le temps

Les Administrateurs peuvent analyser les données sur diverses dimensions telles que le type d’agent, l’état de déploiement ou la plage de temps pour identifier les anomalies et évaluer les tendances sur des périodes opérationnelles définies (par exemple, vues quotidiennes, hebdomadaires ou mensuelles).Ces filtres permettent une analyse ciblée et simplifient le reporting.

• Gérez les agents que vous avez déployés et surveillez leurs performances.
• Gérez et surveillez vos agents de premiers utilisateurs.

Agents déployés

L’onglet Agents déployés fournit une vue consolidée de tous les agents déployés, tous types confondus, ainsi que des mesures de performances, de santé et de commentaires en temps réel. Il constitue le principal espace de travail pour surveiller l'efficacité opérationnelle, diagnostiquer les problèmes et garantir que les agents déployés fournissent des résultats cohérents et de haute qualité.

Visibilité de l'agent unifiée

Cette vue agrège tous les agents prêts pour la production de votre locataire, quel que soit leur type, permettant aux administrateurs et aux développeurs d’évaluer rapidement le statut opérationnel et l’activité récente. Chaque carte d’agent affiche le type de l’agent (Conversationnel, Autonome ou Codé) en tant que badge, ainsi que les métriques opérationnelles clés :

• Taux de réussite : le pourcentage d'exécutions réussies, qui vous aide à identifier les agents dégradés ou peu performants.
• Délai de réponse moyen : measure de la vitesse et de l'efficacité des tâches récentes.
• Volume de commentaires : le nombre d'évaluations utilisateur ou système collectées pour l'agent.
• Indicateurs de santé - Signes visuels (par exemple, Sain, Dégradé) reflétant les tendances des performances globales et la stabilité du Runtime.

Les agents peuvent être filtrés par état, dossier ou plage de temps. Utilisez le filtre Type pour affiner la vue à un type d’agent spécifique : Conversationnel, Autonome ou Codé.

Insights opérationnels et suivi des performances

L'onglet fournit des analyses contextuelles qui vont au-delà du simple statut de runtime. Vous pouvez explorer :

• Tâches actives et terminées : des chronologies distinctes suivent les exécutions en direct et les exécutions terminées, ce qui aide à identifier les pics et les goulets d'étranglement de la charge de travail.
• Modèles d'erreur et de latence : des graphiques de performance affichent les erreurs d'exécution, le délai de première réponse et les centiles de latence, permettant aux équipes d'ajuster la réactivité.
• Tendances des commentaires : l'analyse des sentiments agrégés (positifs et négatifs) montre comment la qualité de l'agent évolue au fil du temps et quelles mises à jour affectent la satisfaction des utilisateurs.

Ces insights aident à diagnostiquer les problèmes systémiques, à valider de nouveaux déploiements et à hiérarchiser les efforts d'optimisation.

Remarque :

Les graphiques de gestion des instances ne sont pas disponibles lorsque le chiffrement CMK est activé pour les traces. Étant donné que les attributs de trace sont chiffrés dans Insights et ne peuvent donc pas être interrogés, les analyses requises pour générer ces graphiques ne peuvent pas s'exécuter.

Analyse de l'utilisation et de la consommation

Le tableau de bord met en évidence la façon dont les agents interagissent avec leurs environnements et consomment les ressources :

• Utilisation d'Agent Unit : suit la consommation totale et identifie les cas atypiques en matière de coût ou d'utilisation des ressources.
• Principales capacités invoquées : répertorie les actions les plus fréquemment utilisées (outils, activités ou index) dans l'ensemble des exécutions de l'agent, ce qui aide les équipes à comprendre les modèles de comportement et les dépendances courantes.

Vue détaillée du runtime de l'agent

La sélection d'un agent individuel ouvre un espace de travaille analytique détaillé, combinant :

• Un diagramme de runtime qui cartographie la logique, les outils et les sources de mémoire de l'agent.
• Des visualisations du score de santé qui évaluent la conception des requêtes, l'intégration des outils et la couverture de l'évaluation.
• Des traces d'exécution avec une visibilité granulaire sur chaque exécution (entrées, sorties, erreurs et détails de synchronisation), permettant aux développeurs de reconstruire et de déboguer le processus de raisonnement de l'agent.

L'affichage d'une instance d'agent offre une visibilité complète sur chaque exécution, avec une traçabilité intégrale des décisions, actions et indicateurs de performance au cours d'une exécution unique.

Comprendre la vue du traçage

La vue Trace combine une représentation graphique de la logique de l’agent avec des données d’exécution alignées dans le temps, ce qui vous permet d’inspecter le flux et les résultats de chaque étape.Le canevas montre les nœuds représentant les principaux composants de l'agent, tels que les modèles et les outils, connectés en séquence.

Une fois que vous êtes dans la vue Traçage de l'exécution d'un agent, procédez comme suit pour interagir avec les données de suivi et les examiner :

1. Prévisualiser les informations sur les nœuds. Passez la souris sur n'importe quel nœud du canevas pour afficher une infobulle qui comprend :
   • Le statut de l'exécution (réussite, réessai ou échec)
   • Horodatages de début et de fin
   • Un aperçu des données d'entrée et de sortie Ceci est utile pour avoir une idée rapide de ce qui s'est passé à chaque étape sans avoir à ouvrir tous les détails.
2. Afficher les détails complets des nœuds. Sélectionnez un nœud pour ouvrir un panneau détaillé qui comprend :
   • Charges utiles d'entrée et de sortie complètes (JSON)
   • Journaux d'exécution ou messages d'erreur (le cas échéant)
   • Mesures de performance, telles que la latence et l'utilisation de jetons
   • Paramètres de configuration, si disponibles
3. Passer d'une étape à l'autre pour explorer comment les informations ont été transmises par l'agent :
   • Sélectionner les nœuds connectés pour monter ou descendre dans la séquence.
   • Cela vous aide à suivre comment les décisions, les entrées ou les sorties d'une étape ont influencé l'étape suivante.
4. Utilisez le panneau Traçage d’exécution. Ce panneau affiche la liste chronologique de toutes les actions enregistrées au cours de l'exécution de l'agent.
   • Sélectionnez une ligne dans le journal des traçages pour mettre en évidence le nœud correspondant sur le canevas.
   • De même, sélectionnez un nœud sur le canevas pour mettre automatiquement en surbrillance la ligne pertinente dans le journal des traçages.

Brouillons d’agent

L’onglet Brouillons d’Agents contient des Agents non publiés ou en cours qui sont en développement.

Chaque brouillon s'affiche sous forme de fiche qui comprend :

• Le nom de l'agent (ou « Sans titre », s'il n'a pas encore été renommé).
• Le dernier horodatage mis à jour.
• Un lien rapide pour rouvrir le brouillon dans Studio Web afin de poursuivre la modification.

Les agents brouillons peuvent être repris, modifiés ou publiés une fois finalisés.

Index d'ancrage dans le contexte

L'onglet Ancrage dans le contexte d'index vous permet de surveiller le statut et l'état de santé de vos index, et de suivre la progression de leur ingestion au niveau du locataire.

La section Surveillance des index fournit des informations graphiques sur les mesures suivantes :

• Requêtes : suit le nombre de requêtes effectuées sur vos index pendant l'intervalle de temps sélectionné.
• Tâches d'indexation : affiche le nombre de tâches d'ingestion terminées. Si aucune tâche n'a été exécutée pendant la période sélectionnée, un graphique d'espace réservé s'affiche.

Le tableau Index répertorie tous les index disponibles dans votre locataire. Pour obtenir des informations plus détaillées sur les index, sélectionnez un index dans le tableau. La vue d'un agent individuel fournit les informations suivantes :

• Nom de l'index, du dossier et de la source
• Statut de santé, indiquant si un index est en bonne santé ou dégradé
• Taille du stockage, statut de l'ingestion, dernière synchronisation et horodatages de la dernière interrogation

Sélectionnez un index dans la table pour ouvrir sa page de détails. La vue Détails de l'index fournit les éléments suivants :

• Requêtes pendant l'intervalle sélectionné.
• Un graphique de santé montrant le score de santé global et les deux critères composants.
• Historique des ingestions, liste des exécutions de synchronisation terminées, échouées, ignorées ou supprimées.

Utilisez cette vue pour examiner les index dégradés, passer en revue la fiabilité de l'ingestion ou Vérifier quand un index a été interrogé pour la dernière fois.

Score de santé de l'index

L'état de santé de l'index vous aide à surveiller l'état de vos index d'ancrage dans le contexte et à identifier ceux qui peuvent nécessiter une maintenance ou un nettoyage. Il fournit un score objectif automatisé montrant les performances de chaque index et à quelle fréquence il est utilisé.

Chaque index reçoit un score de santé basé sur deux critères :

• Fiabilité de l'ingestion – Comment les documents ont été traités avec succès lors de la dernière ingestion.
• Utilisation - Depuis combien de temps l'index a été récemment interrogé.

Le score combiné vous aide à déterminer si un index est sain et fournit une valeur (score global supérieur à 75 % ) ou dégradé (score global de 75 % ou moins). Le score est mis à jour automatiquement après chaque ingestion ou requête réussie.

L'état de santé des index est recalculé toutes les 15 minutes pour tous les locataires et s'applique uniquement aux index dont les tâches d'ingestion sont terminées. Les nouveaux index bénéficient d'une période de grâce de 24 heures après leur création avant que le score de santé ne commence.

La table suivante décrit la façon dont chaque critère de santé est calculé et pondéré pour déterminer le score de santé global de l'index.

Critère	Mesure	Formule	Remarques
Fiabilité de l’ingestion	Success de la dernière ingestion	100 × (1 - failed_docs/total_docs)	Les documents ignorés et supprimés sont exclus. Si aucune ingestion n'est effectuée dans les 24 heures, le score est égal à 0.
Utilisation	Jours depuis la dernière requête (90 jours max.)	100 × (1 - days_since_last_query/90)	Après 24 heures sans aucune requête, le score est égal à 0.
Santé globale	Moyenne des deux mesures	(Fiabilité de l'ingestion + Utilisation)	Calculé uniquement si les scores des deux composants existent.

Vous pouvez passer en revue le statut de santé à deux endroits :

• La liste Index d'ancrage dans le contexte – La colonne Santé affiche un indicateur coloré (vert pour Sain, rouge pour Dégradé). En passant dessus avec le curseur de la souris, les détails de chaque dimension (Fiabilité de l'ingestion et Utilisation) s'affichent.
• Vue Détails de l'index – Le graphique Santé dédié affiche le score global et les mesures des composants. Vous pouvez également suivre l'historique des ingestions et enquêter sur les problèmes lorsque la fiabilité est faible.

Onglet Commentaires (Aperçu)

L'onglet Commentaires fournit une vue centralisée pour passer en revue des traces d'agent et pour capturer des commentaires qui aident à améliorer la fiabilité de l'agent au fil du temps. Il connecte l'analyse du Runtime à la mémoire épisodique basée sur les commentaires, ce qui permet aux Agents d'affiner progressivement leur prise de décision sans réécritures d'invite constantes.

Les commentaires remplissent deux rôles complémentaires :

• Analyse et diagnostic du Runtime : passez en revue les exécutions d'agent terminées pour comprendre le comportement, identifier les problèmes et Annoter des décisions ou des sorties spécifiques.
• Entrée dans la mémoire épisodique : les commentaires de haute qualité peuvent être promus dans la mémoire épisodique, ce qui permet à l’agent de répéter les comportements réussis et d’éviter les comportements incorrects dans les exécutions futures.

Présentation des commentaires

La section supérieure de la page fournit des Insights agrégés :

• Agents ayant reçu le plus de commentaires indique les agents qui reçoivent le volume le plus important de commentaires positifs et négatifs.
• Commentaires au fil du temps visualise les tendances des commentaires, ce qui vous aide à corréler les modifications de comportement avec des améliorations ou des régressions.
• Les filtres Plage de temps vous permettent de restreindre l'analyse aux exécutions récentes ou historiques.

Figure 3. L’onglet Commentaires dans la gestion des instances d’Agents

Ajout de commentaires aux exécutions d'agent

Pour fournir des commentaires :

1. Sélectionnez Ajouter des commentaires dans la page Commentaires.
2. Choisissez une tâche de Runtime d'agent dans la liste des tâches exécutées.
3. Passez en revue la Trace et ajoutez des commentaires à la plage pertinente.

Garde-fous

L’onglet Garde-fous fournit une vue centralisée de l’activité des garde-fous dans vos agents déployés, aidant les opérateurs à garantir que les agents se comportent de manière fiable, sécurisée et en alignement avec les politiques organisationnelles. Il fait apparaître les données des garde-fous de runtime en un seul endroit, de la couverture de la configuration aux résultats de l’application.

L’onglet est organisé autour de trois étapes :

• Configurer les garde-fous : ajoutez des garde-fous au niveau de l’agent, au niveau LLM ou au niveau de l’outil à vos agents.
• Surveiller : examinez l’activité des garde-fous lors du runtime, en suivant la fréquence à laquelle les déclencheurs des garde-fous se déclenchent et les actions qu’ils appliquent.
• Ajuster les garde-fous : utilisez les données d’évaluation pour tester, ajuster et optimiser le comportement des garde-fous au fil du temps.

Utilisation de garde-fous d’agents

Le graphique circulaire affiche la proportion d’agents dans votre locataire qui ont des garde-fous configurés par rapport à ceux qui ne le sont pas, en fonction des données d’exécution. Seuls les agents qui ont été exécutés au moins une fois sont reflétés dans ce graphique. Utilisez cette vue pour évaluer la couverture de la gouvernance dans votre écosystème d’agents déployés et identifier les agents qui peuvent nécessiter une configuration de garde-fous.

Principales actions invoquées

Le graphique à barres empilé affiche le volume et la répartition des actions de garde-fous appliquées à vos agents. Chaque barre représente un agent déployé, divisé par type d’action : Bloquer, Escalader et Filtrer. Un filtre vous permet d’afficher les 5 premiers ou les 10 premiers agents par le total des invocations de garde-fous, cohérent avec d’autres graphiques de surveillance sur la page Agents.

Détails des garde-fous

La table répertorie tous les agents déployés avec leur activité de garde-fous. Vous pouvez filtrer la table pour afficher les agents avec des garde-fous, les agents sans garde-fous ou tous les agents. Un filtre de plage de temps vous permet de limiter les données à une période sélectionnée.

Colonne	Description
Nb de garde-fous	Le nombre de garde-fous configurés pour l’agent.
Garde-fou le plus récent	Le nom du garde-fou le plus récemment déclenché pendant l’exécution de l’agent.
Type de garde-fou	La classification de type du garde-fou.
Portée	Le niveau auquel le garde-fou s’applique : agent, LLM ou outil.
Étape de l’exécution	Que le garde-fou s’exécute avant ou après l’exécution de l’agent, de l’outil ou du LLM : Pré-exécution ou Post-exécution.
Action la plus récente	L’action appliquée par le garde-fou déclenché le plus récemment : Escalader, Journaliser, Filtrer ou Bloquer.
Résultat de l'action	Le résultat de l’action la plus récemment appliquée : Continuer, Rejeter, Journaliser, Filtrer ou Bloquer.