Clase 5 · 15 min
"Agéndame una revisión en el sitio" parece un pedido. Para un agente de navegador, falta todo: en qué página, qué puede tocar, cómo probar que terminó y cuándo parar. En esta clase escribes el contrato de una tarea en cuatro partes y compruebas con un script que el contrato está completo antes de entregárselo a cualquier agente.
Comenzar la lección
Objetivo: escribir el contrato de una tarea de navegador con objetivo, límites, prueba y parada, y comprobar que está completo.
Haz clic en cada bloque. Léelos de abajo hacia arriba cuando revises.
Sin prueba, el resultado es una promesa. Sin límites, todo el sitio está en juego. Sin parada, el agente insiste hasta inventar.
Lo que exige conferir-contrato.mjs y por qué.
20 letras o más y un lugar: dirección o nombre de la página. "En el sitio del taller" no sirve; "en la página agendar.html" sí sirve.
Una tarea, un resultado. Dos cosas se vuelven dos contratos.
El script exige al menos un "no": el agente necesita saber qué no hacer. En una prueba de sitio, casi siempre: no confirmar, no pagar, no salir de la dirección.
El límite de datos también cuenta: "no escribas contraseñas", "no uses datos de otra persona".
Un texto literal, entre comillas, que puedas buscar en la página. Es el mismo texto que el robot de ensayo de la clase 6 va a esperar.
Pide también la evidencia copiada de la página: "devuelve los horarios copiados de la lista, no de memoria".
Las señales (login, verificación, confirmación) y un número: 10 acciones, 3 intentos. El script exige un número.
Pide el bloqueo bien reportado: dónde se detuvo, qué falta y la acción que la persona necesita.
"Me detuve en la pantalla de login de conta.html: pide correo y contraseña. Falta: el login del dueño de la cuenta. No se envió nada." Mejor que "no pude".
El mismo script revisa los dos. Los títulos de las partes también valen en inglés y en español (Goal, Limits, Proof, Stop; Objetivo, Límites, Prueba, Parada).
# 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.
cd ~/projetos/formacao-webmcp-navegador-v72/kit node conferir-contrato.mjs contratos/exemplo.md; echo "saída: $?"
cd ~/projetos/formacao-webmcp-navegador-v72/kit node conferir-contrato.mjs contratos/vago.md; echo "saída: $?"
contrato ok: 4/4 partes (objetivo, limites, prova, parada) · contratos/exemplo.md saída: 0
Las cuatro partes están presentes, cada una con lo que el script exige.
contrato incompleto: 0/4 partes · contratos/vago.md falta: objetivo sem o lugar (endereço ou página) falta: limites (o que pode e o que não pode) falta: prova (o que se vê na página quando acabou) falta: parada (quando parar e chamar a pessoa) saída: 1
"Agende uma revisão pra mim no site da oficina" no dice la página, no tiene límite, no tiene prueba y no tiene parada. Un agente con ese pedido puede hacer clic en Confirmar.
De lo vago a lo completo, y un contrato de tu sitio. Cada ejercicio tiene un "listo cuando".
Copia kit/contratos/vago.md a meu-contrato.md y reescríbelo hasta que el script lo acepte. Usa la página conta.html: la prueba es la lista de citas agendadas y la parada, la pantalla de login.
Listo cuando: node conferir-contrato.mjs meu-contrato.md → contrato ok: 4/4 partes y saída: 0.
Escribe el contrato de una tarea real de tu sitio (local o en homologación), solo de lectura. La prueba tiene que ser un texto que encuentres en la página ahora.
Listo cuando: node conferir-contrato.mjs contrato-site.md → contrato ok: 4/4 partes, y el texto de la prueba aparece con Ctrl+F en la página.
Pregunta 1 de 4
¿Cuál de estas frases sirve como prueba en un contrato de tarea?competencia
Pregunta 2 de 4
El agente llegó a la pantalla de login a mitad de la tarea. ¿Qué manda el contrato?competencia
Pregunta 3 de 4
¿Por qué conferir-contrato.mjs exige un "no" en los límites?
Pregunta 4 de 4
La parada dice "para si se traba". ¿Qué falta?
Elige una alternativa. La explicación aparece después de tu intento.