Preencher formulários e clicar
Nesta página
Lição atualizada a 3 de novembro de 2026 com base nas diretrizes de confirmação da OpenAI e na documentação do Playwright: o atraso de digitação deixou de ser apresentado como forma de contornar a deteção de bots; a seleção utiliza
ControlOrMeta+a, que também funciona em macOS; umpage.screenshot()não mostra a caixa de diálogo nativa de abertura de ficheiros, ao contrário do que afirmava a versão anterior; as diretrizes são transmitidas através do parâmetroinstructions. Fontes: Confirmação e consentimento · Playwright, Teclado.
A interação mais comum
Se dominar apenas um gesto, que seja este. Submeter um pedido de contacto, preencher um orçamento, registar um cliente num CRM sem API: os formulários são o ponto de passagem obrigatório para a maioria das automações. É também aqui que os agentes mal configurados falham com mais frequência, por razões muito concretas que esta lição aborda uma a uma.
Clicar antes de escrever
A ação type não escreve num campo; escreve no campo atualmente focado. Basta esquecer esta nuance uma vez: sem um clique prévio, o seu texto perde-se no vazio ou, mais insidiosamente, anexa-se ao campo anterior. A sequência é, portanto, invariável: um clique para focar, depois a digitação.
# No seu executor de ações
def execute_type(page, text: str):
"""Escreve texto no campo focado."""
page.keyboard.type(text, delay=50)
O delay=50 merece atenção. O keyboard.type já envia eventos de teclado caractere a caractere, mas sem atraso encadeia-os o mais rápido possível; com cinquenta milissegundos entre teclas, a velocidade desce para vinte caracteres por segundo. Campos que reagem a cada tecla — preenchimento automático, máscaras de entrada de telefone — têm assim tempo para acompanhar. Esta definição não serve para passar por humano: um site que procure bloquear bots expressa uma vontade que deve ser respeitada (Lição 14).
Limpar um campo antes de o preencher
Um formulário pré-preenchido — retoma de sessão, valor padrão, preenchimento automático do navegador — transforma a sua entrada numa concatenação absurda: escrever “Dupont” após “Martin” resulta em “MartinDupont”, e o formulário aceita-o sem erro. Selecione tudo antes de escrever.
def clear_and_type(page, text: str):
"""Seleciona todo o conteúdo do campo e depois escreve."""
page.keyboard.press("ControlOrMeta+a") # Ctrl+A, ou Cmd+A em macOS
page.keyboard.type(text, delay=50)
O modelo decide as suas ações com base no prompt: lembre-lhe a regra, ou ele escreverá diretamente no campo ocupado.
task = """
Preencha o formulário de contacto:
- Campo "Nome": Dupont
- Campo "Email": [email protected]
- Campo "Mensagem": Pedido de orçamento para 50 licenças
IMPORTANTE: Antes de escrever em cada campo,
selecione todo o texto existente (Ctrl+A) para o substituir.
Após preencher todos os campos, clique no botão Enviar.
"""
Menus, caixas de verificação e botões de opção
Um menu suspenso <select> requer três passos: um clique para o abrir, uma espera para que as opções apareçam e um segundo clique na opção desejada. A boa notícia é que os menus JavaScript personalizados — aqueles que não são elementos <select> reais e que dão tanto trabalho aos scripts clássicos — são tratados exatamente da mesma forma, uma vez que o agente vê apenas o renderizado visual: clica, descobre as opções na captura de ecrã seguinte e clica na correta.
As caixas de verificação e os botões de opção parecem mais simples, bastando um único clique para os ativar. A armadilha está noutro lugar: uma caixa de verificação que já está marcada fica desmarcada ao clicar, e o seu agente acaba de revogar o consentimento que deveria dar. Deve, portanto, ler o estado antes de agir, e você deve pedir-lhe explicitamente que o faça. Tenha também em mente que aceitar termos ou criar uma conta compromete a pessoa para quem o agente trabalha: confie-lhe estas ações apenas se essa pessoa as tiver solicitado explicitamente.
task = """
No formulário de registo:
1. Marque a caixa "Aceito os termos" se não estiver marcada
2. Selecione "Empresa" no tipo de conta
3. Clique em "Criar conta"
Verifique o estado de cada elemento ANTES de clicar.
"""
Formulários multi-ecrã
Um túnel de registo de três páginas não é três vezes mais difícil do que um formulário simples, desde que estruture as instruções página a página e marque as transições. O agente sabe então quando uma secção terminou e qual o botão que avança para a seguinte. O exemplo lida com dados pessoais fictícios; com dados reais, lembre-se de que a OpenAI considera a introdução de informações sensíveis num formulário como uma transmissão, exigindo a aprovação da pessoa em causa.
task = """
Preencha o formulário de registo em 3 passos:
PASSO 1 - Informações pessoais:
- Nome: Jean
- Apelido: Dupont
- Data de nascimento: 15/03/1985
→ Clique em "Seguinte"
PASSO 2 - Detalhes de contacto:
- Email: [email protected]
- Telefone: 06 12 34 56 78
- Morada: 12 rue de la Paix, 75002 Paris
→ Clique em "Seguinte"
PASSO 3 - Confirmação:
- Verifique se todas as informações estão corretas
- Marque "Aceito os Termos de Serviço"
→ Clique em "Validar"
"""
Reagir a erros de validação
Um formato de telefone rejeitado, um campo obrigatório em falta, uma palavra-passe considerada demasiado curta: o formulário devolve uma mensagem e aguarda uma correção. É exatamente aqui que o Computer Use supera um script, uma vez que o agente sabe ler o erro apresentado em vez de tropeçar nele. Ainda assim, precisa de lhe pedir para procurar erros e limitar as suas tentativas, para que um campo definitivamente rejeitado não o faça entrar num loop infinito. Estas regras vão para o parâmetro instructions, devolvido com cada pedido (Lição 5).
INSTRUCTIONS = """
Após submeter um formulário:
1. Tire uma captura de ecrã para ver o resultado
2. Se aparecerem mensagens de erro (a vermelho, em caixa),
leia-as e corrija os campos relevantes
3. Submeta novamente o formulário
4. Repita até o formulário ser aceite
ou até ter tentado 3 vezes
"""
Carregamento de ficheiros, um caso especial
Existe um limite que nenhum prompt ultrapassará: a caixa de diálogo de abertura de ficheiros pertence ao sistema operativo, não à página. O agente nem sequer a vê — page.screenshot() captura apenas o conteúdo da página — e as coordenadas que produz aplicam-se à página, não a uma janela nativa. Transfira a operação para o Playwright, que contorna totalmente esta caixa de diálogo.
def handle_file_upload(page, file_path: str, selector: str):
"""Carrega um ficheiro via Playwright (não via Computer Use)."""
page.locator(selector).set_input_files(file_path)
Também pode deixar o agente clicar em “Procurar” como um utilizador e intercetar o seletor de ficheiros no momento em que se abre: o fluxo de trabalho permanece natural de ponta a ponta, com a parte do sistema tratada nos bastidores. Em ambos os casos, é o seu código que escolhe o ficheiro, nunca o modelo; e o envio de ficheiros está entre as ações que a OpenAI permite pré-aprovar no pedido inicial, ou confirmar de outra forma.
# O agente clica em "Procurar", depois você interceta
page.on("filechooser", lambda fc: fc.set_files("/path/to/file.pdf"))
Pontos-chave
- Clique sempre num campo antes de escrever nele
- Utilize
Ctrl+A(ControlOrMeta+ano Playwright) para limpar um campo antes de escrever - Os menus suspensos requerem um clique para abrir e depois um clique para selecionar
- Preveja o tratamento de erros de validação no prompt
- O carregamento de ficheiros deve ser tratado pelo Playwright, não pelo Computer Use