Rédiger un parcours
Les étapes, les déclencheurs, et comment l'assistant sait qu'une étape est terminée.
Un parcours a un nom (celui que l'assistant prononce), une phrase de déclenchement et ses étapes dans l'ordre. Vous le rédigez sur la page Journeys ; un agent de code connecté via MCP peut aussi en préparer un brouillon pour vous — un brouillon ne s'exécute jamais tant que vous ne l'avez pas publié.
La phrase de déclenchement#
Le déclencheur est comparé à ce que le visiteur a tapé : écrivez donc une phrase, pas un libellé de menu : *« quand le visiteur veut retourner ou renvoyer quelque chose qu'il a acheté »*. Un simple nom comme « Retours » ne correspond presque à rien.
Comment une étape se termine#
Chaque étape indique comment on sait qu'elle est terminée. C'est une liste fermée — pas de condition en texte libre, car une condition que le moteur ne peut pas vérifier est une condition qui ne se déclenche jamais, sans le moindre signal.
| Se termine quand | Condition |
|---|---|
click_self | La cible de l'étape elle-même a été cliquée. |
visible / hidden | Un élément cible apparaît ou disparaît. |
filled | Un champ cible contient une valeur. |
url_change | L'adresse change pour celle que vous indiquez. |
settled | Une cible cesse de changer. |
attempts | Un nombre d'essais. |
user_continue | Le visiteur appuie sur Continuer. Obligatoire pour les étapes hold. |
Règle: Une étape qui ouvre une page doit se terminer sur quelque chose que la page peut afficher. Ouvrir une page détruit le script et le reconstruit sur la nouvelle page : un événement attendu — un clic — ne peut donc jamais arriver, et l'étape rouvrirait la page à chaque chargement. L'éditeur ne propose donc que url_change, visible et filled pour une étape « ouvrir une page », et le serveur refuse un plan qui dit autre chose. Le moteur arrête aussi une étape après deux navigations : un plan erroné ne peut jamais laisser votre site se recharger en boucle.
Autre chose que le moteur fait pour vous : il attend que la cible d'une étape apparaisse (quelques secondes, en vérifiant en continu) avant de conclure qu'elle est absente. Une page qui affiche son formulaire un instant après le chargement, c'est normal, et cela ne doit pas interrompre un parcours.
Publier#
Ce qui est publié, c'est une version précise. Modifier un parcours publié le remet hors ligne : un plan que personne n'a validé ne peut donc jamais tourner sur votre site. Relisez les étapes, puis publiez à nouveau.
Astuce: L'essentiel du travail sur un parcours consiste à désigner les bons éléments de votre page. La cible d'une étape doit correspondre à un seul et unique élément — #country-select ou select[aria-label="Passport"] conviennent tous deux si un seul élément de la page y répond, alors qu'un simple button est refusé : une référence qui peut désigner quarante éléments n'est pas un pointeur. Si vous avez connecté un agent de code (voir Agents de code), il peut lire vos pages et préparer les étapes — vous relisez et publiez.