Agentes de navegador: testar o site como o agente vê|INEMA.CLUB-PRO

Aula 5 · 15 min

Contrato de tarefa para agente de navegador (objetivo, limites, prova, parada)

"Agende uma revisão pra mim no site" parece um pedido. Para um agente de navegador, falta tudo: em que página, o que ele pode tocar, como provar que acabou e quando parar. Nesta aula você escreve o contrato de uma tarefa em quatro partes e confere com um script que o contrato está completo antes de entregar a qualquer agente.

Começar a aula
Mesa de trabalho escura com uma folha de checklist ao lado de um teclado e um monitor com um formulário, luz neutra.

Nesta aula você vai

  1. 1Objetivo: onde e o quê
  2. 2Limites: o que pode e o que não pode
  3. 3Prova: o texto que se vê na página
  4. 4Parada: quando parar e chamar a pessoa

Objetivo: escrever o contrato de uma tarefa de navegador com objetivo, limites, prova e parada, e conferir que está completo.

01As quatro partes

Clique em cada bloco. Leia de baixo para cima quando revisar.

Clique em cada bloco do diagrama para ver o que ele faz.

Sem prova, o resultado é promessa. Sem limites, o site inteiro está em jogo. Sem parada, o agente insiste até inventar.

02Escrevendo cada parte

O que o conferir-contrato.mjs cobra e por quê.

1. Objetivo

20 letras ou mais e um lugar: endereço ou nome da página. "No site da oficina" não serve; "na página agendar.html" serve.

Uma tarefa, um resultado. Duas coisas viram dois contratos.

03Um contrato completo e um vago

O mesmo script confere os dois. Os títulos das partes também valem em inglês e espanhol (Goal, Limits, Proof, Stop; Objetivo, Límites, Prueba, Parada).

Arquivo · kit/contratos/exemplo.md
# Contrato: horários de troca de pneu

## Objetivo
Na página http://127.0.0.1:8433/agendar.html, descobrir os horários livres de "Troca de pneu" em 2026-11-03.

## Limites
Pode preencher o formulário e clicar em "Ver horários". Não clique em "Agendar às…" nem em "Confirmar". Não saia de http://127.0.0.1:8433/.

## Prova
A página mostra "4 horários livres para Troca de pneu em 2026-11-03." Devolva os horários copiados da lista, não de memória.

## Parada
Pare e descreva a tela se aparecer login, verificação humana ou pedido de confirmação. Pare depois de 10 ações sem chegar à prova.
Terminal · conferir o contrato completo
cd ~/projetos/formacao-webmcp-navegador-v72/kit
node conferir-contrato.mjs contratos/exemplo.md; echo "saída: $?"
Terminal · conferir o contrato vago
cd ~/projetos/formacao-webmcp-navegador-v72/kit
node conferir-contrato.mjs contratos/vago.md; echo "saída: $?"
Exemplo do repositório
contrato ok: 4/4 partes (objetivo, limites, prova, parada) · contratos/exemplo.md
saída: 0

As quatro partes presentes, cada uma com o que o script cobra.

04Prática

Do vago ao completo, e um contrato do seu site. Cada exercício tem um "pronto quando".

E1 · Consertar o vago

10 min

Copie kit/contratos/vago.md para meu-contrato.md e reescreva até o script aceitar. Use a página conta.html: a prova é a lista de agendamentos e a parada, a tela de login.

Pronto quando: node conferir-contrato.mjs meu-contrato.md → contrato ok: 4/4 partes e saída: 0.

E2 · Uma tarefa do seu site

15 min

Escreva o contrato de uma tarefa real do seu site (local ou em homologação), só de leitura. A prova tem de ser um texto que você acha na página agora.

Pronto quando: node conferir-contrato.mjs contrato-site.md → contrato ok: 4/4 partes, e o texto da prova aparece com Ctrl+F na página.

05Teste da aula

Pergunta 1 de 4

Qual destas frases serve como prova num contrato de tarefa?competência

06Em três frases

Quatro partesObjetivo com lugar, limites com um "não", prova entre aspas, parada com número.
Prova não é fraseÉ um texto que você procura na página e acha.
Parar é resultadoParar com o motivo exato vale mais que insistir e inventar.

Para ir além

Kit do curso: conferir-contrato.mjs e contratos/Formação LOOP-R Engenharia: verificação e evals a fundo
Aula anteriorPróxima aula