A automação do navegador falha quando é tratada como automação de back-end.
As regras são diferentes.
Abaixo estão regras práticas que surgem somente quando a automação opera dentro de páginas da web reais, não em APIs.
Regra 1: as páginas não são alvos estáveis
Uma página hoje não será a mesma página amanhã.
Os elementos são movidos.
Os rótulos mudam.
Aparecem pop-ups.
A automação que assume estabilidade falhará silenciosamente.
A automação deve assumir movimento.
Regra 2: A visibilidade é mais importante que os seletores
O que importa não é onde um elemento está localizado no DOM, mas se ele é visível, clicável e ativo.
Os humanos interagem com o que podem ver.
A automação do navegador deve fazer o mesmo.
Regra 3: Esperar é uma ação
Os estados de carregamento fazem parte da tarefa.
Spinners, atrasos, renderizações parciais: não são erros.
São condições normais.
A automação que não espera intencionalmente irá correr para o fracasso.
Regra 4: a repetição nunca é idêntica
As tarefas se repetem na intenção, não na forma.
A segunda execução sempre contém pequenas diferenças.
A décima execução contém muitas.
A automação deve tolerar a variação, não eliminá-la.
Regra 5: Erros raramente se anunciam
A maioria das falhas parece que nada aconteceu.
Sem confirmação.
Nenhuma mensagem de erro.
Apenas silêncio.
A automação deve detectar a ausência como um sinal, e não assumir o sucesso.
Regra 6: Login é um fluxo de trabalho, não uma etapa
A autenticação não é uma ação única.
As sessões expiram.
As camadas de segurança mudam.
Os fluxos de verificação aparecem de forma imprevisível.
A automação que trata o login como uma etapa única será reiniciada constantemente.
Regra 7: Interfaces contêm trabalho não documentado
Rolar, passar o mouse, fechar sobreposições: essas ações nunca são escritas em requisitos.
No entanto, eles são necessários.
A automação expõe esse trabalho oculto ao ter que executá-lo explicitamente.
Regra 8: A velocidade é secundária à recuperação
Falha rápida é pior que conclusão lenta.
A automação que pode tentar novamente, pausar ou redefinir é mais valiosa do que a automação que termina rapidamente e quebra.
Regra 9: A página define as regras
As APIs obedecem aos contratos.
As páginas não.
A interface define o que é possível a qualquer momento.
A automação deve ler a página antes de agir nela.
Regra 10: O julgamento humano não desaparece
A automação decide como agir, e não o que deve acontecer.
Os humanos ainda definem intenções, limites e exceções.
A automação do navegador funciona quando o julgamento e a execução estão separados.
SaleAI Contexto (observação baseada em regras)
No SaleAI, os agentes do navegador seguem um comportamento orientado por regras em vez de scripts rígidos.
Eles operam sob restrições moldadas pela visibilidade da página, estados de interação e feedback da interface, permitindo que funcionem em sites variados e em constante mudança.
Isso reflete regras operacionais, não declarações de marketing.
Regra de fechamento
Se a automação não respeitar o navegador como ambiente, ele sempre parecerá frágil.
A automação do navegador só se torna confiável quando segue regras moldadas pela própria interface.
