Référence des étapes

Un workflow est une liste ordonnée d’étapes. Chaque étape est un petit objet JSON doté d’un type, et chacune peut lire la sortie des étapes précédentes.

Il existe 30+ types d’étapes. Ils sont groupés ci-dessous par famille ; ouvrez une étape pour voir ses champs, un exemple fonctionnel et son comportement.

Toutes les étapes, par famille

Navigation

Étape	Type JSON	Ce que ça fait
Naviguer	`navigate`	Charger une URL dans l’onglet actif et attendre qu’elle se stabilise.
Navigation constatée	`navigated_to`	Marqueur enregistré : la page a navigué d’elle-même ; le replay attend l’URL prévue.

Interaction

Étape	Type JSON	Ce que ça fait
Cliquer	`click`	Cliquer sur un élément identifié par un sélecteur stable.
Survoler	`hover`	Placer le pointeur sur un élément pour révéler une UI visible au survol.
Appuyer sur une touche	`press`	Appuyer sur une touche du clavier ou un raccourci.
Mettre au focus	`focus`	Placer le focus clavier sur un élément sans cliquer dessus.
Remplir	`fill`	Définir la valeur d’un champ en une seule opération.
Saisir	`type`	Saisir du texte touche par touche.
Sélectionner	`select`	Choisir une option dans une liste déroulante.
Cocher	`check`	Mettre une case à cocher ou un bouton radio à l’état coché.
Décocher	`uncheck`	Mettre une case à cocher à l’état décoché.
Faire défiler	`scroll`	Faire défiler la page, p. ex. pour charger du contenu paresseux.
Amener dans la vue	`scroll_into_view`	Amener un élément précis dans la zone visible.
Téléverser un fichier	`upload`	Joindre un fichier stocké à un champ fichier ou à un sélecteur de fichiers.

Attentes

Étape	Type JSON	Ce que ça fait
Attendre	`wait`	Faire une pause d’une durée donnée ou jusqu’à ce qu’une condition soit vraie.
Attendre un changement	`wait_for_change`	Attendre que le contenu surveillé de la page change.
Attendre un téléchargement	`wait_for_download`	Attendre la fin d’un téléchargement et capturer le fichier.

Extraction

Étape	Type JSON	Ce que ça fait
Extraire	`extract`	Extraire des données structurées de la page vers des champs nommés.
Évaluer (JS)	`evaluate`	Exécuter du JavaScript dans la page et capturer son résultat.
Codegen	`codegen`	Exécuter un script généré autonome contre la page.
Capture d’écran	`screenshot`	Capturer la page en image, stockée avec l’exécution.
Appel API	`api_call`	Effectuer une requête HTTP depuis la session de la page.

Onglets

Étape	Type JSON	Ce que ça fait
Ouvrir un onglet	`open_tab`	Ouvrir un nouvel onglet, éventuellement sur une URL.
Attendre un onglet	`wait_for_tab`	Attendre l’ouverture d’un nouvel onglet, puis y basculer.
Changer d’onglet	`switch_tab`	Rendre actif un autre onglet ouvert.
Onglet fermé	`tab_closed`	Marqueur enregistré : l’onglet actif s’est fermé ; le replay le ferme aussi.

IA

Étape	Type JSON	Ce que ça fait
Remplissage IA	`ai_fill`	Laisser l’IA remplir un champ quand un sélecteur ne suffit pas.
Formulaire IA	`ai_fill_form`	Laisser l’IA compléter tout un formulaire à partir des données disponibles.
Poursuite IA	`ai_continue`	Laisser l’IA décider et effectuer les prochaines actions vers un objectif.
Navigation IA	`ai_navigate`	Laisser l’IA trouver et atteindre une destination décrite.

Authentification

Étape	Type JSON	Ce que ça fait
Connexion (requête)	`login_post`	Se connecter par une requête plutôt qu’un formulaire, sur votre propre compte.
Double facteur (2FA)	`twofa`	Compléter un défi de double authentification sur votre propre compte.
Étape de vérification	`captcha`	Compléter une vérification interactive sur une page que vous êtes autorisé à utiliser.

Flux

Étape	Type JSON	Ce que ça fait
Retourner	`return`	Terminer le workflow ici et renvoyer ce qui a été collecté.
Point final	`end_point`	Marquer la ligne d’arrivée du workflow, éventuellement derrière une condition.
Vérifier	`assert`	Exiger que la page soit dans l’état attendu, sinon faire échouer l’exécution.

Comment les étapes sont écrites

Vous les écrivez rarement à la main. L’enregistreur les produit pendant que vous cliquez sur le site, et Scribe les produit à partir d’une description en mots simples. Cette page sert à relire un workflow construit par quelqu’un d’autre, et à en modifier un à la main quand il vous faut un contrôle exact.