Execução e monitoramento de ações
Durante a execução de um robô, é fundamental entender como as ações são executadas e como monitorar seu progresso. Este guia explica as opções de execução disponíveis e como acompanhar o status das ações em tempo real.
Opções de execução
As Opções de execução ficam ao final do Painel de Configuração de cada ação e controlam o comportamento do robô caso a ação apresente algum problema.
Parar o robô em caso de erro
Define se o robô deve interromper a execução ao encontrar um erro nesta ação.
- Sim (padrão): O robô para completamente e a execução é encerrada com erro
- Não: O robô pula a ação com erro e continua executando as próximas ações
Quando usar "Não":
- Ações opcionais que não são críticas para o fluxo
- Quando você deseja que o robô tente continuar mesmo com falhas parciais
- Em validações onde você quer registrar o erro mas não parar o processo
Use a opção "Não parar em caso de erro" com cuidado. Se ações subsequentes dependem do resultado da ação que falhou, elas também poderão falhar ou produzir resultados inesperados.
Número de tentativas
Define quantas vezes a ação será repetida antes de ser considerada como falha.
- Mínimo: 1 (padrão)
- Valor recomendado: Entre 1 e 3, dependendo da natureza da ação
Quando usar mais tentativas:
- Ações que dependem de rede (download de arquivos, requisições HTTP)
- Interações com elementos que podem levar tempo para aparecer
- Operações que podem falhar temporariamente por instabilidade
Exemplo: Se você configurar "3 tentativas" e a ação falhar nas duas primeiras vezes mas funcionar na terceira, ela será considerada bem-sucedida.
Estados visuais durante a execução
Ao rodar o robô no modo de teste, os cards das ações atualizam visualmente conforme o progresso. Isso permite acompanhar em tempo real o que o robô está fazendo.
| Estado | Visual | Descrição |
|---|---|---|
| Em andamento | Card com borda azul e animação pulsante | A ação está sendo executada neste momento |
| Concluído com sucesso | Badge verde com ícone de check | A ação foi executada sem erros |
| Erro | Borda vermelha com badge de erro | A ação falhou após todas as tentativas |
| Ignorado | Opacidade reduzida | Ação pulada porque uma ação anterior falhou (modo "não parar") |
Visualizando erros
Quando uma ação falha, você pode clicar no card dela para abrir o Painel de Configuração. No painel, você verá:
- Mensagem de erro: Descrição do que deu errado
- Detalhes técnicos: Informações adicionais para diagnóstico
- Tentativas realizadas: Quantas vezes a ação foi executada antes de falhar
Essas informações facilitam o diagnóstico do problema e a correção do fluxo.
Ciclo completo de execução
Veja o ciclo completo de uso de uma ação, desde a configuração até o monitoramento:
1. Abrir o Catálogo
↓
2. Escolher a ação desejada
↓
3. Configurar no Painel:
├── Definir o ID da ação (ex.: "consultarSaldo")
├── Selecionar modo (se aplicável)
├── Preencher campos de entrada
├── Ativar campos de saída que serão usados
└── Definir opções de execução
↓
4. Salvar
↓
5. Próxima ação: referenciar retornos desta ação
↓
6. Executar o robô
↓
7. Acompanhar status visual nos cards
↓
8. Em caso de erro: analisar mensagem no painel
Boas práticas
Configure tentativas adequadamente
Não use muitas tentativas para ações que provavelmente não vão funcionar mesmo com repetições. Isso só tornará a execução mais lenta.
Use "não parar" com cautela
Sempre avalie se as ações seguintes podem funcionar sem o resultado da ação que pode falhar. Se houver dependência, é melhor deixar o robô parar em caso de erro.
Monitore a primeira execução
Quando estiver testando um novo fluxo, acompanhe a execução visualmente para identificar rapidamente onde estão os problemas.
Documente erros comuns
Se uma ação apresentar erros recorrentes, documente a causa e a solução para facilitar a manutenção futura.
Próximos passos
- Anatomia de uma ação — Revise o painel de opções de execução
- Encadeamento de ações — Entenda como erros afetam ações encadeadas
- Introdução às ações — Volte ao básico sobre ações