Gérer les agents UiPath

La page Agents d'Automation Cloud^TM permet de gérer les agents de manière complète et intuitive, avec les fonctionnalités suivantes :

• Migrer les agents adoptés précocement vers des packages de solution
• Surveiller les performances des agents déployés
• Identifier et résoudre les incidents liés aux agents
• Accéder aux modèles d'agents de Marketplace

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 Cloud^TM :

• 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.

Onglet Home (Accueil)

L'onglet Home (Accueil) offre une vue d'ensemble de l'exécution et de la surveillance de l'agent. À partir de là, vous pouvez effectuer les opérations suivantes :

• Gérez les agents que vous avez déployés et surveillez leurs performances.
• Gérez et surveillez vos agents de premiers utilisateurs.
• Gérer et surveiller les incidents et les erreurs des agents.
• Surveillez le statut de vos index et la progression de leur ingestion.
• Examiner les modèles d'agents disponibles sur Marketplace.

Onglet Agent Instances (Instances d'agents)

L'onglet Instances de tous les agents permet offre une grande visibilité sur les agents déployés en production et comprend :

• Les tableaux de bord de surveillance Live Instances Timeline (Chronologie des instances actives) et Completed Instances Timeline (Chronologie des instances terminées).

• La liste Agents actifs : affiche les agents qui ont été exécutés pendant l'intervalle de temps sélectionné. Les principales métadonnées d'exécution de chaque agent sont affichées. La sélection d'un agent ouvre l'aperçu de sa propre instance, qui comprend :
  • Une brève description de l'agent, y compris sa configuration, ses paramètres et ses règles de conservation.
  • Une liste chronologique de toutes les exécutions de tâches pendant l'intervalle de temps sélectionné. La sélection d'une tâche ouvre une vue détaillée du traçage de cette exécution.

    La vue du traçage fournit les informations suivantes sur l'exécution de chaque agent : le flux d'exécution avec les résultats codés par couleur (réussite, échec, réessai), un aperçu des horodatages de début et de fin, le statut d'exécution, les extraits d'entrée et de sortie, et tous les détails des charges de travail JSON, les journaux et les erreurs, les indicateurs d'exécution (utilisation des jetons, latence). Pour obtenir des informations détaillées, consultez la section suivante.

Utilisez le filtre chronologique pour ajuster l'intervalle d'affichage : heure dernière, jour dernier, semaine dernière, mois dernier.

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 rapide des données d'entrée et de sortie
   Cela est utile pour obtenir rapidement une idée 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 lors 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.

Onglet Utilisateur précoce

L'onglet Agents d'utilisateur précoce affiche tous les agents que vous avez créés dans Agent Builder avant le 14 mai 2025.

Sélectionnez le bouton Migrate (Migrer) de chaque agent pour le migrer vers Studio. Pour de plus amples informations, consultez la section Étapes de migration.

Figure 1. Onglet Instances des agents adoptés précocement

Onglet Erreurs

L'onglet Erreurs permet de surveiller les agents qui présentent le plus d'erreurs. L'onglet indique :

• Les agents qui présentent le plus d'erreurs (Agents with most errors), affichés sous forme de tableau. Utilisez le menu déroulant Show (Afficher) pour afficher les cinq principaux (top 5) ou dix principaux (top 10) éléments de la période sélectionnée.

• Tableau Incidents, avec la liste des incidents d'exécution des agents, notamment la colonne Description qui fournit de brèves informations sur la cause de chaque incident. Sélectionnez les entrées de la colonne First seen (Première apparition) ou Last seen (Dernière apparition) d'un incident pour afficher le panneau des détails de la tâche correspondante.

Pour regrouper les incidents par Agent ou processus parent (Parent process), cochez les cases correspondantes.

Onglet Index d'ancrage dans le contexte

L'onglet Index d'ancrage dans le contexte vous permet de surveiller le statut de vos index et de suivre la progression de leur ingestion au niveau de l'entité.

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. Si aucune tâche n'a été exécutée pendant la période sélectionnée, un graphique de substitution 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 :

• Le nombre de requêtes (Queries) effectuées pendant l'intervalle sélectionné.
• L'historique des tâches de synchronisation de l'index pendant l'intervalle sélectionné. Sélectionnez une entrée dans le tableau de synchronisation pour obtenir une vue détaillée des documents ingérés.

Figure 2. Onglet Gérer les index d'ancrage dans le contexte

Onglet Templates (Modèles)

L'onglet Templates (Modèles) permet d'accéder directement aux modèles d'agent disponibles sur UiPath Marketplace.

Pour savoir comment utiliser les modèles, consultez la section Utiliser des modèles d'agents.

Figure 3. Modèles d'agents dans Marketplace