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.
• Délai 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 selon différentes 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 actuellement actifs en production, accompagnée de métriques en temps réel sur les performances, l'état et les retours. 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 dans votre locataire, ce qui permet aux administrateurs et aux développeurs d'évaluer rapidement le statut opérationnel et l'activité récente. Chaque fiche agent résume les principales métriques opérationnelles, notamment :

• 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 d'état de santé : signaux visuels (par exemple, En bon état, Dégradé) reflétant les tendances globales de performance et la stabilité du runtime.

Les agents peuvent être filtrés par état, type, dossier ou plage temporelle, ce qui permet une surveillance précise dans tous les domaines métier ou environnements de déploiement.

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 du traçage combine une représentation graphique de la logique de l'agent avec des données d'exécution alignées chronologiquement, 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.

Agents conversationnels

L'onglet Agents conversationnels fournit un environnement complet pour gérer, tester et analyser les agents qui interagissent avec les utilisateurs via le dialogue en langage naturel. Il combine des tests de conception, une évaluation par chat en direct, des insights de runtime et des commentaires pour aider les équipes à améliorer continuellement les performances et la fiabilité des conversations.

Les agents conversationnels peuvent être testés directement dans l'interface de discussion. Ce bac à sable intégré vous permet de simuler des échanges en conditions réelles et d'évaluer la façon dont l'agent gère la reconnaissance d'intention, la prise de tour de parole et la continuité du contexte. Vous pouvez :

• Interagir avec l'agent en temps réel, en envoyant des requêtes en langage naturel et en observant ses réponses en direct.
• Tester les requêtes ou personnaliser les messages pour évaluer la couverture de tous les scénarios.
• Évaluer la façon dont l'agent applique les outils, la mémoire et les modèles au cours d'une boucle de conversation.

Cet environnement de test aide à valider la logique conversationnelle avant le déploiement, garantissant ainsi une précision et un ton alignés sur les cas d'utilisation prévus.

La vue Runtime fournit une visibilité de bout en bout sur le fonctionnement des agents conversationnels en production, en capturant les sessions en direct, les taux d'achèvement et les interactions utilisateur. Elle suit les principales mesures opérationnelles, telles que le temps de réponse, la durée et la consommation d'Agent Unit, pour garantir les performances, l'évolutivité et la fiabilité de l'ensemble des charges de travail.

La vue Trace permet de procéder au débogage et à l'optimisation en retraçant l'intégralité du raisonnement et du flux d'exécution d'un agent. Vous pouvez inspecter les décisions, les appels d'outils, les points de contrôle de gouvernance et les cartes thermiques de performance pour comprendre le comportement, valider la logique et améliorer la qualité globale des conversations.

La vue Commentaires agrège les évaluations des utilisateurs et du système dans un tableau de bord central. Elle visualise les tendances de sentiment, met en évidence les problèmes récurrents et relie les commentaires à des exécutions individuelles pour un contexte plus approfondi. Cela permet un réglage itératif et une amélioration continue de la qualité.

Brouillons d’agent

L'onglet Agents en brouillon contient des agents non publiés ou en cours de 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.