Pulsa / para buscar

Toda la documentación
docs▸Enseñar al agente▸Referencia de pasos

Se ejecuta enWrit CloudDesktopAutoalojado

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

PasoType JSONQué hace
NavegarnavigateCargar una URL en la pestaña activa y esperar a que se asiente.
Navegación observadanavigated_toMarcador grabado: la página navegó por sí sola; la reproducción espera la URL prevista.

Interacción

PasoType JSONQué hace
ClicclickHacer clic en un elemento identificado por un selector estable.
Pasar el cursorhoverMover el puntero sobre un elemento para revelar UI visible solo al pasar el cursor.
Pulsar teclapressPulsar una tecla del teclado o un atajo.
EnfocarfocusLlevar el foco del teclado a un elemento sin hacer clic.
RellenarfillFijar el valor de un campo en una sola operación.
TecleartypeIntroducir texto tecla a tecla.
SeleccionarselectElegir una opción de un desplegable.
MarcarcheckPoner una casilla o un botón de radio en estado marcado.
DesmarcaruncheckPoner una casilla en estado desmarcado.
DesplazarscrollDesplazar la página, p. ej. para cargar contenido perezoso.
Traer a la vistascroll_into_viewTraer un elemento concreto al área visible.
Subir archivouploadAdjuntar un archivo almacenado a un input de archivo o a un selector de archivos.

Esperas

PasoType JSONQué hace
EsperarwaitPausar durante un tiempo o hasta que se cumpla una condición.
Esperar un cambiowait_for_changeEsperar hasta que cambie el contenido vigilado de la página.
Esperar una descargawait_for_downloadEsperar a que termine una descarga y capturar el archivo.

Extracción

PasoType JSONQué hace
ExtraerextractSacar datos estructurados de la página hacia campos con nombre.
Evaluar (JS)evaluateEjecutar JavaScript en la página y capturar su resultado.
CodegencodegenEjecutar un script generado autónomo contra la página.
Captura de pantallascreenshotCapturar la página como imagen, guardada con la ejecución.
Llamada APIapi_callHacer una petición HTTP desde la sesión de la página.

Pestañas

PasoType JSONQué hace
Abrir pestañaopen_tabAbrir una pestaña nueva, opcionalmente en una URL.
Esperar pestañawait_for_tabEsperar a que se abra una pestaña nueva y cambiar a ella.
Cambiar de pestañaswitch_tabActivar otra pestaña abierta.
Pestaña cerradatab_closedMarcador grabado: la pestaña activa se cerró; la reproducción también la cierra.

IA

PasoType JSONQué hace
Relleno con IAai_fillDejar que la IA rellene un campo cuando un selector no basta.
Formulario con IAai_fill_formDejar que la IA complete un formulario entero con los datos disponibles.
Continuar con IAai_continueDejar que la IA decida y ejecute las siguientes acciones hacia un objetivo.
Navegar con IAai_navigateDejar que la IA encuentre y alcance un destino descrito.

Autenticación

PasoType JSONQué hace
Inicio de sesión (petición)login_postIniciar sesión como petición en lugar de formulario, en tu propia cuenta.
Doble factor (2FA)twofaCompletar un desafío de doble factor en tu propia cuenta.
Paso de verificacióncaptchaCompletar una verificación interactiva en una página que estás autorizado a usar.

Flujo

PasoType JSONQué hace
DevolverreturnTerminar el workflow aquí y devolver lo recogido.
Punto finalend_pointMarcar la línea de meta del workflow, opcionalmente tras una condición.
ComprobarassertExigir 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.