agents
latest
false
Important :
La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.
UiPath logo, featuring letters U and I in white

Guide de l'utilisateur des agents

Dernière mise à jour 9 oct. 2025

Traçages d’agent

À propos des traçages

Les traçages enregistrent en détail toutes les actions qu'effectue un agent lors d'une exécution, y compris les étapes parcourues, les données traitées, les décisions prises et les résultats générés. Chaque traçage capture la chronologie complète du comportement de l'agent, y compris les horodatages, les erreurs, les entrées/sorties et les métadonnées contextuelles.

Utilisez des traçages dans les opérations suivantes :

  • Débogage et dépannage : identifier exactement où un agent a échoué ou s'est comporté de manière inattendue.
  • Analyse des performances : évaluer la latence, les erreurs et le flux des exécutions d'agents pour optimiser le comportement.
  • Conformité et audit : maintenir un enregistrement vérifiable de ce que l'agent a fait, quand et comment, essentiel dans le cadre des audits ou des workflows réglementés.
  • Amélioration continue : utiliser les éclairages qu'apportent les traçages pour affiner la logique de l'agent, adapter le comportement ou former de nouveaux modèles.

Le tableau suivant décrit les cas d'utilisation courants dans lesquels la visualisation du traçage peut améliorer votre capacité à déboguer, analyser et optimiser le comportement des agents. Chaque exemple met en évidence comment les données de traçage contribuent à obtenir des éclairages et à prendre de meilleures décisions lors du développement et de la surveillance de l'exécution.

Use caseCe que les traçages vous aident à faire
L'agent échoue lors d'un appel d'outilTrouver et inspecter l'étape exacte, les entrées, les sorties et les erreurs
Les performances sont médiocresUtiliser des horodatages pour localiser les goulots d'étranglement
Enquêter sur un pic d'erreursFiltrer les exécutions par statut et tracer la tendance
Vérifier un correctif de productionRejouer l'exécution initiale et confirmer que le problème ne se produit plus
Préparer un rapport d'auditExporter ou examiner les traçages qui montrent les chemins de décision et les données traitées

Types de traçages

Les traçages se présentent sous deux types distincts, chacun servant à comprendre et analyser le comportement de l'agent :

  • Traçages de fonctionnement de l'agent : ces traçages capturent l'exécution étape par étape d'un agent pendant une exécution active ou programmée. Ils montrent comment l'agent a traité les données, invoqué les outils, géré les conditions et répondu à différents états en temps réel.
  • Traçages de test d'évaluation : des traçages d'évaluation sont générés lorsqu'un agent est testé avec des entrées prédéfinies, généralement pendant l'évaluation de modèles, la validation de scénarios ou les scénarios de test. Ces derniers permettent d'évaluer la précision de l'agent, la qualité des décisions et le comportement dans des conditions contrôlées.

Accéder aux traçages

Vous pouvez accéder aux deux types de traçages à partir de deux emplacements clés :

  • Agent Builder – Lors de la conception ou du test de votre agent, les traçages sont disponibles directement dans le générateur :
    • Le panneau inférieur s'ouvre automatiquement sur l'onglet Chemin d'exécution lorsque vous exécutez votre agent, affichant les traçages en temps réel de l'exécution actuelle. Vous pouvez également basculer vers l'onglet Historique pour afficher les exécutions passées et les ajouter directement aux ensembles d'évaluation.

    • Les onglets Évaluations et Sortie offrent une autre vue sur les exécutions récentes, où vous pouvez examiner le comportement et les résultats en parallèle de la définition de votre agent.

  • Page Instances d'agent - Accédez à la section Agents > Instances. À partir de là, sélectionnez un agent spécifique et toute exécution pour ouvrir l’affichage de son traçage, qui inclut le panneau de traçage visuel et le panneau de journalisation.

Lorsque vous consultez les traçages des exécutions d'agents ou des exécutions d'évaluation, vous obtenez une meilleure visibilité sur l'exécution de l'agent. Vous pouvez :

  • Voir les résultats de l'exécution, comme indiqué avec des nœuds codés par couleur : réussite, échec ou réessai.

  • Placez la souris sur n'importe quel nœud pour afficher un aperçu : horodatages de début et de fin, statut d'exécution, extraits d'entrée et de sortie.
  • Sélectionnez un nœud pour afficher les détails, notamment : les charges utiles JSON complètes, les journaux et les erreurs, les mesures de runtime (consommation de jetons, latence).


Gestion de l’accès aux données de traçage

Cette section explique comment les administrateurs peuvent configurer l’accès aux données de traçage à l’aide du modèle de contrôle d’accès basé sur les rôles.

Pour afficher les journaux de traçage, vous avez besoin des autorisations suivantes :

  • Logs.View
  • Jobs.View

Pour plus d’informations sur les autorisations des rôles par défaut, consultez la section Rôles par défaut.

La matrice suivante explique les résultats de visibilité en fonction des combinaisons d’autorisations. Ces combinaisons définissent les informations de traçage que vous pouvez afficher en fonction de vos autorisations basées sur vos rôles.

Logs.ViewJobs.ViewAccès aux résultats

Activer (Enable)

Activer (Enable)

Tous les attributs

Activer (Enable)

Désactiver (Disable)

Tous les attributs

Désactiver (Disable)

Activer (Enable)

Attributs partiels (par ex., nom, type)

Désactiver (Disable)

Désactiver (Disable)

Aucun accès

Lorsque vous ne disposez pas des autorisations nécessaires pour afficher les données de traçage, un message s’affiche pour indiquer si l’accès est totalement ou partiellement limité et comment demander l’autorisation requise.

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo
Confiance et sécurité
© 2005-2025 UiPath Tous droits réservés.