Exécution et inspection des résultats de l'exécution

Après avoir configuré votre invite ScreenPlay, procédez comme suit:

1. Exécutez l'automatisation en mode Debug.
2. Une fois l'exécution terminée, vous pouvez passer en revue la façon dont l'agent a interprété et exécuté votre requête :
   • Accédez à Debug, puis sélectionnez Ouvrir les journaux dans Studio.
   • Ouvrez le dossier ScreenPlay.
   • Inspectez les fichiers les plus récents.html.

Chaque fichier HTML contient une trace d'exécution qui détaille la façon dont l'agent ScreenPlay a raisonné sur l'invite, a identifié les cibles de l'interface utilisateur et a exécuté chaque action.Cette trace fournit une visibilité sur le processus de prise de décision et aide à valider ou à résoudre les problèmes de comportement de ScreenPlay.

Le fichier HTML de trace d'exécution ScreenPlay

Le fichier HTML de trace d'exécution de ScreenPlay fournit un enregistrement visuel et diagnostique complet d'une exécution d'automatisation ScreenPlay.Il capture l'entrée des invites, le raisonnement de l'IA, les actions à l'écran et les mesures de synchronisation dans un format interactif structuré.

Vous pouvez utiliser ce fichier pour inspecter et valider la façon dont ScreenPlay a interprété une invite, quels éléments de l'interface utilisateur ont été ciblés et comment chaque étape d'automatisation s'exécutait sur l'interface.

Le fichier est automatiquement généré par défaut. Vous pouvez modifier ce paramètre dans Paramètres du projet, puis sélectionner UIAutomation Modern, puis accéder à ScreenPlay où vous pouvez également définir le nombre de jours pendant lesquels les fichiers de trace sont stockés.

Vue d'ensemble (Overview)

Lorsque vous exécutez une automatisation ScreenPlay, la trace d'exécution est automatiquement générée sous forme de fichier .html.Ce fichier combine :

• Données d'invite en langage naturel
• Instantanés de l'interface utilisateur étape par étape avec des cases délimitantes
• Mesures de synchronisation et de jetons.
• Sections de diagnostic pour le raisonnement et les erreurs

Vous pouvez ouvrir le fichier HTML dans n'importe quel navigateur Web moderne pour passer en revue ou partager la séquence d'exécution complète.

Structure de fichiers

Chaque fichier de traçage ScreenPlay suit une structure interne cohérente avec les sections de haut niveau suivantes.

Section	Description
En-tête	Affiche la demande, l'ID de traçage et l'horodatage de l'exécution.
Mesures globales (totaux généraux)	Résume le runtime total, les temps de traitement et l'utilisation des jetons.
Conteneur du lecteur	Contient le composant de rediffusion visuelle - captures d'écran, surlignements et navigation par étape.
Blocs d'itération	Chaque itération (étape) dans le cycle de raisonnement ou d'exécution de l'agent. Comprend des captures d'écran, un raisonnement et des mesures.
Sections de diagnostic	Panneaux facultatifs pour le raisonnement de l'IA, les données d'activité et les messages d'erreur.

Champs d'en-tête

Les tableaux suivants décrivent les champs d'en-tête et les exemples:

Champ	Exemple	Description
Prompt	create a random RPA supplier	L'instruction en langage naturel qui a initié l'automatisation.
Trace ID	3b97584d-7fc0-43f6-830b-fc45c21811b3	Un identifiant unique pour cette trace d'exécution, utilisé à des fins de référence ou de comparaison.

Mesures globales

La section Totaux généraux résume les principales données de performance de l'exécution.

La table suivante décrit les mesures globales :

Mesure	Description
Durée totale	Le temps total nécessaire pour terminer l'exécution, y compris les phases de perception, de raisonnement et d'action.
Cache/DOM/Serveur/Actions (info-bulles)	Ventilation du temps écoulé dans chaque sous-système (par exemple, réponses mises en cache, numérisation DOM, raisonnement et actions de l'interface utilisateur).
Total des jetons	Suit l'entrée/la sortie du jeton si la trace inclut un raisonnement du modèle de langage IA.Utile pour déboguer l'utilisation de LLM.

Cadres de l'étape

Chaque cadre d'étape, ou étape d'exécution, représente une itération de raisonnement et d'action par l'agent ScreenPlay.

La table suivante décrit chaque élément et leur finalité.

Élément	Objectif
Numéro d'étape (data-step="1")	Identifie l'ordre de séquence de l'étape.
Screenshot	Une image capturée de la fenêtre de l'application ou du bureau au moment de l'exécution.
Coordonnées de la zone de dessin (coordonnées des données)	Cases délimitantes encodées en JSON pour les éléments détectés ou interagis.
En-tête de l'itération	Affiche le titre de l'étape, l'aperçu du raisonnement et le résumé de la durée.
Contenu de l'itération	Contient des détails étendus, y compris du texte de raisonnement et toutes les métadonnées d'exécution.

Sections de diagnostic

Chaque itération peut inclure une ou plusieurs sections extensibles, comme décrit dans le tableau suivant:

Nom de la section	Objectif
Réflexion	Affiche le raisonnement de l'IA et l'interprétation de l'intention (si le raisonnement est activé).
Info de l'étape	Affiche les informations contextuelles sur l'élément ciblé, le sélecteur ou le contrôle de l'interface utilisateur détecté.
Erreur	Indique un échec avec des signaux visuels en rouge ; inclut des messages d'erreur, des traces d'exception ou des actions de secours.
Données d'activité	Affiche les données d'exécution structurées, y compris le type d'activité, les arguments et les applications ciblées.

Contrôles de la visionneuse de captures d'écran et du lecteur

Les traces ScreenPlay incluent un lecteur intégré pour naviguer dans chaque image capturée.

La table suivante décrit chaque contrôle.

Contrôle	Description
Boutons Suivant/Précédent	Naviguez entre les étapes séquentielles.
Curseur de plage d'étapes	Passez directement à une étape de la séquence.
Activer/désactiver les surbrillances	Superposez les cases délimitantes définies dans le champ Coordonnées des données pour visualiser les zones cliquées ou saisies.
Conteneur de capture d'écran	Affiche l'image rendue ou l'espace réservé si aucune image n'est disponible.

Superpositions visuelles

Chaque étape peut inclure des superpositions pour indiquer les types d'interaction de l'interface utilisateur, comme suit:

• Cliquer - Rectangle dessiné sur un bouton ou une zone cliquable.
• Saisir - Mettez en surbrillance autour des champs d'entrée.
• Pointer/Glisser - Contour montrant le mouvement ou la position du curseur.
• Marqueur d'erreur - Superposition rouge sur une action d'élément échouée.