Noções básicas de depuração

Depurar um fluxo de trabalho na tela: inicie uma execução de depuração, leia os resultados, encontre falhas e teste partes de um fluxo de trabalho com simulações.

A depuração acontece na mesma tela em que um fluxo de trabalho é criado. Não há visualização de depuração separada: uma execução de depuração é iniciada a partir da tela, o painel abaixo da tela mostra os resultados e as alterações são feitas na tela quando um problema aparece.

Iniciar uma sessão de debug

Run Debug (▶) in the bottom toolbar of the canvas starts a debug run, in every tool. If the trigger has inputs, a dialog asks for their values. In Studio Web, Debug at the top left of the toolbar does the same. A panel appears below the canvas, and the execution trace fills in as each node runs.

Parar depuração encerra a execução explicitamente e qualquer alteração no fluxo de trabalho também a encerra. A tela de Fluxo descreve os controles de depuração e o painel abaixo da tela por completo.

Leitura dos resultados

A guia Execuções abaixo da tela tem três partes, cada uma respondendo a uma pergunta diferente:

• Execuções de debug: a lista de execuções, com o nome, duração e idade de cada uma.
• Trace de execução: cada nó que foi executado, em ordem, com tempo e um indicador de sucesso ou falha. Selecionar um nó no trace o destaca na tela, e passar o mouse sobre um nó mostra quando ele começou e terminou.
• Detalhes: para uma execução, as guias Variáveis, Incidentes e Metadados . Para um nó, as entradas que ele recebeu e as saídas que produziu.

A aba Incidentes lista os erros da execução, agrupados por nó. Cada incidente nomeia o nó que falhou e inclui a mensagem de erro. É melhor verificar lá primeiro uma parada inesperada.

A aba Variáveis mostra valores de variáveis de runtime em três seções: Entradas (valores passados para o fluxo de trabalho), Saídas (valores produzidos) e Variáveis (variáveis de fluxo de trabalho internas). Selecionar um nó no trace mostra o estado nesse ponto. Um campo Filtrar variáveis pesquisa os valores pelo nome.

Identificação de falhas

Após uma execução de depuração, cada nó na tela mostra um indicador de sucesso ou falha. O nó com falha também é marcado no trace de execução, e a aba Incidentes mostra a mensagem de erro.

O objeto de erro inclui um campo message (descrição legível por humanos) e um campo detail (causa técnica). O campo message contém o resumo de falha voltado para o usuário, portanto, ele é o ponto de partida.

Uso de nós simulados

Uma parte de testes simulados estáticos de um fluxo de trabalho isoladamente. Um nó com uma simulação estática não é executado e passa os dados simulados para os nós depois dele. Isso é útil quando um nó anterior é lento, precisa de credenciais que não estão disponíveis localmente ou depende de sistemas externos. A visualização expandida do nó, que é aberta clicando duas vezes no nó, tem um menu de modo na coluna Saída . A simulação estática substitui a resposta real por dados que os nós após ela esperam, e Gerada faz com que um LLM produza a resposta. A simulação de saída descreve ambos.

Simular vários nós de uma só vez permite que a execução de depuração se concentre em uma seção específica do fluxo de trabalho.

Dicas

• Rastreamento de execução primeiro, incidentes depois: o rastreamento mostra toda a execução, e os incidentes mostram apenas o que falhou.
• Os valores das variáveis revelam incompatibilidades de dados: compare os dados que um nó recebeu com os dados que o próximo nó esperava.
• Simular dependências externas permite uma iteração mais rápida: simular um nó que chama uma API ou dispara um processo de RPA permite que a lógica seja depurada sem esperar em sistemas externos.
• Pequenas iterações são mais rápidas: uma correção por ciclo de depuração é mais eficiente do que tentar corrigir tudo de uma só vez.
• Os nomes de nós descritivos melhoram a legibilidade do trace: o trace e os incidentes fazem referência aos nomes de nós, e nomes que descrevem o que um nó faz facilitam a verificação dos traces.

Próximas Etapas

• A tela de fluxo: os controles de depuração e o painel abaixo da tela.
• Tratamento de erros: configuração de ramificações de erro em nós.
• Variáveis e fluxo de dados: como as variáveis funcionam entre nós.
• Comunidade: faça perguntas e compartilhe fluxos de trabalho com outros construtores no Fórum da UiPath.