Как написать сценарий
Шаги, триггеры и то, как ассистент понимает, что шаг завершён.
У сценария есть название (так ассистент называет его вслух), фраза-триггер и шаги по порядку. Вы пишете его на странице Journeys; черновик может составить и подключённый по MCP агент программирования — черновик не запускается, пока вы его не опубликуете.
Фраза-триггер#
Триггер сравнивается с тем, что написал посетитель, поэтому пишите фразу, а не название пункта меню: *«когда посетитель хочет вернуть или отправить обратно купленный товар»*. Короткое «Возвраты» почти ни с чем не совпадёт.
Как завершается шаг#
Для каждого шага указано, как мы узнаём, что он завершён. Это закрытый список — условий в свободной форме нет, потому что условие, которое движок не может проверить, просто молча никогда не срабатывает.
| Завершается, когда | Что нужно |
|---|---|
click_self | Нажата цель самого шага. |
visible / hidden | Целевой элемент появляется или исчезает. |
filled | В целевом поле есть значение. |
url_change | Адрес меняется на указанный вами. |
settled | Цель перестаёт меняться. |
attempts | Число попыток. |
user_continue | Посетитель нажимает Continue. Обязательно для шагов Hold. |
Правило: Шаг, который открывает страницу, должен завершаться тем, что эта страница может показать. При открытии страницы скрипт уничтожается и заново запускается на новой, поэтому ожидаемое событие — например, нажатие — так и не наступит: шаг снова открывал бы страницу при каждой загрузке. Поэтому для шага «открыть страницу» редактор предлагает только url_change, visible и filled, а сервер отклоняет план с другим условием. Кроме того, движок останавливает шаг после двух переходов, так что ошибочный план никогда не заставит ваш сайт бесконечно перезагружаться.
И ещё одно, что движок делает за вас: прежде чем решить, что цель шага отсутствует, он ждёт её появления (несколько секунд, непрерывно проверяя). Страница, которая отрисовывает форму через мгновение после загрузки, — это нормально, и сценарий из-за этого останавливаться не должен.
Публикация#
Публикуется конкретная версия. Редактирование опубликованного сценария снимает его с публикации, так что на вашем сайте никогда не будет работать план, который никто не утвердил. Прочитайте шаги и опубликуйте снова.
Совет: Основная работа над сценарием — правильно указать элементы на странице. Цель шага должна соответствовать ровно одному элементу: и #country-select, и select[aria-label="Passport"] подойдут, если на странице им отвечает только один элемент, а голый button будет отклонён — ссылка, которая может означать сорок разных вещей, ни на что не указывает. Если у вас подключён агент программирования (см. Агенты программирования), он может прочитать ваши страницы и составить шаги, а вы их проверите и опубликуете.