Executar e inspecionar os resultados da execução

Após configurar sua solicitação do ScreenPlay, siga as seguintes etapas:

1. Execute a automação no modo Debug.
2. Após a conclusão da execução, você pode revisar como o agente interpretou e executou sua solicitação:
   • Acesse Debug, em seguida selecione Abrir logs no Studio.
   • Abra a pasta ScreenPlay.
   • Inspecione os arquivos .html mais recentes.

Cada arquivo HTML contém um Trace de execução que detalha como o agente do ScreenPlay raciocinou sobre a solicitação, identificou os alvos de interface gráfica e executou cada ação. Esse Trace fornece visibilidade no processo de tomada de decisão e ajuda a validar ou solucionar problemas do comportamento do ScreenPlay.

O arquivo HTML do ScreenPlay Execution Trace.

O Arquivo HTML do ScreenPlay Execution Trace fornece um registro visual e de diagnóstico completo de uma execução de automação do ScreenPlay. Ele captura entrada de solicitações, raciocínio de IA, Actions na tela e métricas de tempo em um Formato estruturado e interativo.

Você pode usar esse arquivo para inspecionar e validar como o ScreenPlay interpretou uma solicitação, quais elementos de interface gráfica foram direcionados, e como cada etapa de automação foi executada na interface.

O arquivo é gerado automaticamente por padrão. Você pode alterar essa configuração em Configurações do Projeto, selecionar UIAutomation Modern e acessar ScreenPlay, onde você também pode definir o número de dias em que os arquivos de Trace estão sendo armazenados.

Visão geral

Quando você executa uma automação ScreenPlay, o Trace de execução é gerado automaticamente como um arquivo .html.Esse arquivo combina:

• Dados de solicitação em linguagem natural.
• Instantâneos de interface gráfica passo a passo com caixas de delimitação.
• Métricas de tempo e token.
• Seções de diagnóstico para raciocínio e erros.

Você pode abrir o arquivo HTML em qualquer navegador da web moderno para revisar ou compartilhar a sequência de execução completa.

Estrutura do arquivo

Cada arquivo de Trace do ScreenPlay segue uma estrutura interna consistente com as seguintes seções de nível superior.

Seção	Description
Cabeçalho	Exibe a solicitação, o ID do trace e o carimbo de data/hora da execução.
Métricas gerais (Totais gerais).	Resume o runtime total, tempos de processamento e uso de token.
Contêiner do jogador	Contém o componente de reprodução visual — capturas de tela, destaques e navegação de etapas.
Blocos de iteração	Cada iteração (etapa) no ciclo de raciocínio ou execução do agente. Inclui capturas de tela, raciocínio e métricas.
Seções de diagnóstico	Painéis opcionais para raciocínio de IA, dados de atividade e mensagens de erro.

Campos de cabeçalho

As tabelas a seguir descrevem os campos de cabeçalho e exemplos:

Campo	Exemplo	Description
Prompt	create a random RPA supplier	A instrução em linguagem natural que iniciou a automação.
Trace ID	3b97584d-7fc0-43f6-830b-fc45c21811b3	Um identificador exclusivo para este trace de execução, usado para referência ou comparação.

Métricas gerais

A seção Totais gerais resume os principais dados de desempenho da execução.

A tabela a seguir descreve as métricas gerais:

Métrica	Description
Duração total	O tempo total necessário para concluir a execução, incluindo as fases de percepção, raciocínio e ação.
Cache / DOM / Servidor / Actions (dica de ferramenta)	Detalhamento do tempo decorrido em cada subsistema (por exemplo, respostas em cache, digitalização do DOM, raciocínio e ações de interface gráfica).
Total de tokens	Rastreia a entrada/saída de tokens se o trace incluir raciocínio do modelo de idioma de IA. Útil para depurar o uso de LLM.

Quadros de etapa

Cada etapa, ou etapa de execução, representa uma iteração de raciocínio e ação pelo agente ScreenPlay.

A tabela a seguir descreve cada elemento e sua finalidade.

Element	Finalidade
Número da etapa (data-step="1")	Identifica a ordem da sequência da etapa.
Captura de tela	Uma imagem capturada da janela do aplicativo ou área de trabalho no momento da execução.
Canvas coordinates (data-coordinates)	Caixas de limite codificadas em JSON para elementos detectados ou interagidos.
Cabeçalho de iteração	Exibe o título da etapa, visualização do raciocínio e resumo da duração.
Conteúdo da iteração	Contém detalhes expandidos, incluindo texto de raciocínio e quaisquer metadados de execução.

Seções de diagnóstico

Cada iteração pode incluir uma ou mais seções expansíveis, conforme descrito na tabela a seguir:

Nome da seção	Finalidade
Pensando	Exibe o raciocínio de IA e a interpretação de intenção (se o raciocínio estiver habilitado).
Info da etapa	Mostra informações de contexto sobre o elemento direcionado, seletor ou controle de interface gráfica detectado.
Erro	Indica uma falha, com dicas visuais em vermelho; inclui mensagens de erro, traces de exceções ou ações de fallback.
Dados de atividade	Exibe dados de execução estruturados, incluindo tipo de atividade, argumentos e aplicativos direcionados.

Controles do visualizador de CapturaDeTela e player

Os traces do ScreenPlay incluem um player integrado para navegar por cada quadro capturado.

A tabela a seguir descreve cada controle.

Controle	Description
Botões Avançar/Anterior	Navegue entre etapas sequenciais.
Controle deslizante de intervalo de etapas	Ir diretamente para uma etapa na sequência.
Alternar destaques	Sobrepor caixas de limite definidas no campo coordenadas de dados para visualizar áreas clicadas ou digitadas.
Contêiner de captura de tela	Exibe a imagem renderizada ou espaço reservado se nenhuma imagem estiver disponível.

Sobreposições visuais

Cada etapa pode incluir sobreposições para indicar tipos de interação de interface gráfica, da seguinte forma:

• Clique – Retângulo desenhado sobre um botão ou área clicável.
• Tipo – Realçar em torno de campos de entrada.
• Focalizar / Arrastar – Contorno exibindo o movimento ou a posição do cursor.
• Marcador de erro – Sobreposição vermelha em uma ação de elemento com falha.