Ir al contenido principal
Español— Elegir un idioma
Menú

Rellenar formularios y hacer clic

Lección 6 de 14 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. La interacción más común
  2. Hacer clic antes de escribir
  3. Limpiar un campo antes de rellenarlo
  4. Menús, casillas de verificación y botones de opción
  5. Formularios de varias pantallas
  6. Reaccionar ante errores de validación
  7. Carga de archivos, un caso especial
  8. Puntos clave

Lección actualizada el 3 de noviembre de 2026 según las directrices de confirmación de OpenAI y la documentación de Playwright: el retraso de escritura ya no se presenta como un método para evadir la detección de bots; la selección usa ControlOrMeta+a, que también funciona en macOS; un page.screenshot() no muestra el diálogo nativo de apertura de archivos, al contrario de lo que afirmaba la versión anterior; las directrices se pasan mediante el parámetro instructions. Fuentes: Confirmación y consentimiento · Playwright, Teclado.

La interacción más común

Si solo dominas un gesto, que sea este. Enviar una solicitud de contacto, rellenar un presupuesto, introducir un registro de cliente en un CRM sin API: los formularios son el punto de control obligatorio para la mayoría de las automatizaciones. Aquí es también donde fallan con mayor frecuencia los agentes mal configurados, por razones muy concretas que esta lección aborda una a una.

Hacer clic antes de escribir

La acción type no escribe en un campo; escribe en el campo que tiene el foco en ese momento. Solo olvidas este matiz una vez: sin un clic previo, tu texto se pierde en la nada o, de forma más insidiosa, se añade al final del campo anterior. La secuencia es, por tanto, invariable: un clic para enfocar y luego la escritura.

# En tu ejecutor de acciones
def execute_type(page, text: str):
    """Escribe texto en el campo con foco."""
    page.keyboard.type(text, delay=50)

El parámetro delay=50 merece atención. keyboard.type ya envía eventos de teclado carácter por carácter, pero sin un retraso los encadena lo más rápido posible; con cincuenta milisegundos entre pulsaciones, la velocidad baja a veinte caracteres por segundo. Los campos que reaccionan a cada pulsación —autocompletado, máscaras de entrada de teléfono— tienen así tiempo para seguir el ritmo. Este ajuste no trata de hacerse pasar por humano: un sitio que busca bloquear bots expresa una voluntad que debe respetarse (Lección 14).

Limpiar un campo antes de rellenarlo

Un formulario prerelleno —reanudación de sesión, valor por defecto, autocompletado del navegador— convierte tu entrada en una concatenación absurda: escribir “Dupont” después de “Martin” da “MartinDupont”, y el formulario lo acepta sin error. Selecciona todo antes de escribir.

def clear_and_type(page, text: str):
    """Selecciona todo el contenido del campo y luego escribe."""
    page.keyboard.press("ControlOrMeta+a")  # Ctrl+A, o Cmd+A en macOS
    page.keyboard.type(text, delay=50)

El modelo decide sus acciones basándose en el prompt: recuérdale la regla, o escribirá directamente en el campo ocupado.

task = """
Rellena el formulario de contacto:
- Campo "Nombre": Dupont
- Campo "Correo electrónico": [email protected]
- Campo "Mensaje": Solicitud de presupuesto para 50 licencias

IMPORTANTE: Antes de escribir en cada campo, 
selecciona todo el texto existente (Ctrl+A) para reemplazarlo.
Después de rellenar todos los campos, haz clic en el botón Enviar.
"""

Menús, casillas de verificación y botones de opción

Un menú desplegable <select> requiere tres pasos: un clic para abrirlo, una espera a que aparezcan las opciones y un segundo clic en la opción deseada. La buena noticia es que los menús personalizados de JavaScript —aquellos que no son elementos <select> reales y que dan tantos problemas a los scripts clásicos— se gestionan exactamente igual, ya que el agente solo ve el renderizado visual: hace clic, descubre las opciones en la siguiente captura de pantalla y hace clic en la correcta.

Las casillas de verificación y los botones de opción parecen más sencillos, con un solo clic suficiente para activarlos. La trampa está en otro lado: una casilla que ya está marcada se desmarca al hacer clic, y tu agente acaba de revocar el consentimiento que debía dar. Debe, por tanto, leer el estado antes de actuar, y debes pedirle explícitamente que lo haga. Ten también presente que aceptar términos o crear una cuenta compromete a la persona para la que trabaja el agente: confíale estas acciones solo si esa persona las ha solicitado explícitamente.

task = """
En el formulario de registro:
1. Marca la casilla "Acepto los términos" si no está marcada
2. Selecciona "Empresa" en el tipo de cuenta
3. Haz clic en "Crear cuenta"

Verifica el estado de cada elemento ANTES de hacer clic.
"""

Formularios de varias pantallas

Un túnel de registro de tres páginas no es tres veces más difícil que un formulario sencillo, siempre que estructures las instrucciones página por página y marques las transiciones. El agente sabe así cuándo ha terminado una sección y qué botón lleva a la siguiente. El ejemplo maneja datos personales ficticios; con datos reales, recuerda que OpenAI considera la introducción de información sensible en un formulario como una transmisión, lo que requiere la aprobación de la persona afectada.

task = """
Rellena el formulario de registro en 3 pasos:

PASO 1 - Información personal:
- Nombre: Jean
- Apellidos: Dupont
- Fecha de nacimiento: 15/03/1985
→ Haz clic en "Siguiente"

PASO 2 - Datos de contacto:
- Correo electrónico: [email protected]
- Teléfono: 06 12 34 56 78
- Dirección: 12 rue de la Paix, 75002 París
→ Haz clic en "Siguiente"

PASO 3 - Confirmación:
- Verifica que toda la información es correcta
- Marca "Acepto las Condiciones del servicio"
→ Haz clic en "Validar"
"""

Reaccionar ante errores de validación

Un formato de teléfono rechazado, un campo obligatorio vacío, una contraseña considerada demasiado corta: el formulario devuelve un mensaje y espera una corrección. Aquí es exactamente donde Computer Use supera a un script, ya que el agente sabe leer el error mostrado en lugar de tropezar con él. Aun así, necesitas pedirle que busque errores y limitar sus intentos para que un campo rechazado definitivamente no lo haga entrar en un bucle infinito. Estas reglas van en el parámetro instructions, devuelto con cada solicitud (Lección 5).

INSTRUCTIONS = """
Después de enviar un formulario:
1. Haz una captura de pantalla para ver el resultado
2. Si aparecen mensajes de error (en rojo, enmarcados), 
   léelos y corrige los campos correspondientes
3. Vuelve a enviar el formulario
4. Repite hasta que el formulario sea aceptado 
   o hayas intentado 3 veces
"""

Carga de archivos, un caso especial

Hay un límite que ningún prompt cruzará: el diálogo de apertura de archivos pertenece al sistema operativo, no a la página. El agente ni siquiera lo ve —page.screenshot() captura solo el contenido de la página— y las coordenadas que produce se aplican a la página, no a una ventana nativa. Delega la operación en Playwright, que evita por completo este diálogo.

def handle_file_upload(page, file_path: str, selector: str):
    """Carga un archivo mediante Playwright (no mediante Computer Use)."""
    page.locator(selector).set_input_files(file_path)

También puedes dejar que el agente haga clic en “Examinar” como un usuario e interceptar el selector de archivos en el momento en que se abre: el flujo de trabajo sigue siendo natural de extremo a extremo, con la parte del sistema gestionada entre bastidores. En ambos casos, tu código elige el archivo, nunca el modelo; y el envío de archivos está entre las acciones que OpenAI te permite preaprobar en la solicitud inicial, o confirmar de otro modo.

# El agente hace clic en "Examinar", luego tú interceptas
page.on("filechooser", lambda fc: fc.set_files("/path/to/file.pdf"))

Puntos clave

  • Haz siempre clic en un campo antes de escribir en él
  • Usa Ctrl+A (ControlOrMeta+a en Playwright) para limpiar un campo antes de escribir
  • Los menús desplegables requieren un clic para abrir y luego un clic para seleccionar
  • Planifica el manejo de errores de validación en el prompt
  • La carga de archivos debe gestionarse mediante Playwright, no Computer Use