# Как написать сценарий

> Сценарии (Journeys) · Шаги, триггеры и то, как ассистент понимает, что шаг завершён.

У сценария есть **название** (так ассистент называет его вслух), **фраза-триггер** и **шаги** по порядку. Вы пишете его на странице 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` будет отклонён — ссылка, которая может означать сорок разных вещей, ни на что не указывает. Если у вас подключён агент программирования (см. **Агенты программирования**), он может прочитать ваши страницы и составить шаги, а вы их проверите и опубликуете.

---

Читать эту страницу на сайте: [Как написать сценарий](/ru/docs/journeys/writing-a-journey)
