Escribir un recorrido
Pasos, frases de activación y cómo sabe el asistente que un paso ha terminado.
Un recorrido tiene un nombre (cómo lo llama el asistente en voz alta), una frase de activación y sus pasos en orden. Lo escribes en la página Journeys; un agente de programación conectado por MCP también puede redactarte un borrador, y un borrador nunca se ejecuta hasta que lo publicas.
La frase de activación#
La frase de activación se compara con lo que escribió el visitante, así que escribe una frase, no una etiqueta de menú: *"cuando el visitante quiere devolver algo que ha comprado"*. Un sustantivo suelto como "Devoluciones" no coincide con casi nada.
Cómo termina un paso#
Cada paso indica cómo sabemos que ha terminado. Es una lista cerrada, sin condiciones de texto libre, porque una condición que el motor no puede comprobar es una condición que nunca se cumple, sin avisar.
| Termina cuando | Necesita |
|---|---|
click_self | Se hizo clic en el propio objetivo del paso. |
visible / hidden | Un elemento objetivo aparece o desaparece. |
filled | Un campo objetivo tiene un valor. |
url_change | La dirección cambia a una que tú indicas. |
settled | Un objetivo deja de cambiar. |
attempts | Un número de intentos. |
user_continue | El visitante pulsa Continue. Obligatorio en los pasos hold. |
Regla: Un paso que abre una página debe terminar con algo que la página pueda mostrar. Abrir una página destruye el script y lo reconstruye en la nueva página, así que un evento que iba a ocurrir —un clic— nunca puede llegar: el paso volvería a abrir la página en cada carga. Por eso el editor solo ofrece url_change, visible y filled para un paso de "abrir una página", y el servidor rechaza un plan que diga otra cosa. Además, el motor detiene un paso tras dos navegaciones, así que un plan erróneo nunca puede dejar tu sitio recargándose sin fin.
Hay algo más que el motor hace por ti: espera a que aparezca el objetivo de un paso (unos segundos, comprobando continuamente) antes de decidir que falta. Es normal que una página muestre su formulario un momento después de cargar, y eso no debería detener un recorrido.
Publicar#
Lo que se publica es una versión concreta. Editar un recorrido publicado lo desactiva, así que un plan que nadie ha aprobado nunca puede estar ejecutándose en tu sitio. Revisa los pasos y vuelve a publicarlo.
Consejo: La mayor parte del trabajo de un recorrido es nombrar los elementos correctos de tu página. El objetivo de un paso debe coincidir con exactamente un elemento: #country-select o select[aria-label="Passport"] sirven si solo hay un elemento en la página que les corresponda, mientras que un simple button se rechaza: una referencia que puede significar cuarenta cosas no apunta a nada. Si tienes conectado un agente de programación (consulta Agentes de programación), puede leer tus páginas y redactar los pasos; tú los revisas y los publicas.