docs ▸ Enseñar al agente ▸ Referencia de pasos Se ejecuta en Writ Cloud Desktop Autoalojado
En esta página workflows ▸ step reference
Referencia de pasos Un workflow es una lista ordenada de pasos. Cada paso es un pequeño objeto JSON con un type, y cada uno puede leer la salida de los pasos anteriores.
Hay 30+ tipos de paso. Abajo están agrupados por familia; abre cualquier paso para ver sus campos, un ejemplo funcional y su comportamiento.
Todos los pasos, por familia Navegación Paso Type JSON Qué hace Navegar navigate Cargar una URL en la pestaña activa y esperar a que se asiente. Navegación observada navigated_to Marcador grabado: la página navegó por sí sola; la reproducción espera la URL prevista.
Interacción Paso Type JSON Qué hace Clic click Hacer clic en un elemento identificado por un selector estable. Pasar el cursor hover Mover el puntero sobre un elemento para revelar UI visible solo al pasar el cursor. Pulsar tecla press Pulsar una tecla del teclado o un atajo. Enfocar focus Llevar el foco del teclado a un elemento sin hacer clic. Rellenar fill Fijar el valor de un campo en una sola operación. Teclear type Introducir texto tecla a tecla. Seleccionar select Elegir una opción de un desplegable. Marcar check Poner una casilla o un botón de radio en estado marcado. Desmarcar uncheck Poner una casilla en estado desmarcado. Desplazar scroll Desplazar la página, p. ej. para cargar contenido perezoso. Traer a la vista scroll_into_view Traer un elemento concreto al área visible. Subir archivo upload Adjuntar un archivo almacenado a un input de archivo o a un selector de archivos.
Esperas Paso Type JSON Qué hace Esperar wait Pausar durante un tiempo o hasta que se cumpla una condición. Esperar un cambio wait_for_change Esperar hasta que cambie el contenido vigilado de la página. Esperar una descarga wait_for_download Esperar a que termine una descarga y capturar el archivo.
Extracción Paso Type JSON Qué hace Extraer extract Sacar datos estructurados de la página hacia campos con nombre. Evaluar (JS) evaluate Ejecutar JavaScript en la página y capturar su resultado. Codegen codegen Ejecutar un script generado autónomo contra la página. Captura de pantalla screenshot Capturar la página como imagen, guardada con la ejecución. Llamada API api_call Hacer una petición HTTP desde la sesión de la página.
Pestañas Paso Type JSON Qué hace Abrir pestaña open_tab Abrir una pestaña nueva, opcionalmente en una URL. Esperar pestaña wait_for_tab Esperar a que se abra una pestaña nueva y cambiar a ella. Cambiar de pestaña switch_tab Activar otra pestaña abierta. Pestaña cerrada tab_closed Marcador grabado: la pestaña activa se cerró; la reproducción también la cierra.
IA Paso Type JSON Qué hace Relleno con IA ai_fill Dejar que la IA rellene un campo cuando un selector no basta. Formulario con IA ai_fill_form Dejar que la IA complete un formulario entero con los datos disponibles. Continuar con IA ai_continue Dejar que la IA decida y ejecute las siguientes acciones hacia un objetivo. Navegar con IA ai_navigate Dejar que la IA encuentre y alcance un destino descrito.
Autenticación Paso Type JSON Qué hace Inicio de sesión (petición) login_post Iniciar sesión como petición en lugar de formulario, en tu propia cuenta. Doble factor (2FA) twofa Completar un desafío de doble factor en tu propia cuenta. Paso de verificación captcha Completar una verificación interactiva en una página que estás autorizado a usar.
Flujo Paso Type JSON Qué hace Devolver return Terminar el workflow aquí y devolver lo recogido. Punto final end_point Marcar la línea de meta del workflow, opcionalmente tras una condición. Comprobar assert Exigir que la página esté en el estado esperado, o hacer fallar la ejecución.
Cómo se escriben los pasos Rara vez los escribes a mano. El grabador los emite mientras haces clic por el sitio, y Scribe los emite a partir de una descripción en palabras sencillas. Esta página sirve para leer un workflow que construyó otra persona, y para editar uno a mano cuando necesitas control exacto.