Кнопки и действия

Кнопка на странице — это не просто украшение, а действие. У любой кнопки портала заранее известно, что произойдёт по нажатию. Всего есть четыре вида действий, и агент выбирает нужный при сборке страницы.

Четыре вида действий

  • Ссылка — открывает внешний адрес в интернете.
  • Переход по порталу — открывает другую страницу внутри портала, не покидая его.
  • Запрос агенту — отправляет ИИ-агенту готовую просьбу от вашего имени.
  • Скрипт — запускает расчётную программу на сервере, и её ответ управляет экраном.

Ссылка

Самое простое действие: нажатие открывает указанный адрес — на ваш сайт, в другой сервис, к скачиваемому файлу. При желании ссылка открывается в новой вкладке, чтобы посетитель не терял текущую страницу портала. Подпись кнопки задаёт агент.

Переход по порталу

Кнопка ведёт на другую страницу портала — например, с карточки новостей в саму новость. Адрес задаётся путём внутри портала, а значения переменных подставляются в него автоматически. Поэтому одна и та же кнопка на странице-образце ведёт на разные адреса в зависимости от того, какую страницу открыл читатель. Подробнее — в разделе Шаблоны и переменные.

Запрос агенту

Такая кнопка избавляет читателя от набора одинаковых просьб. Агент заранее записывает нужный запрос, и нажатие сразу отправляет его в чат от имени нажавшего — например, «добавь план на квартал» или «пересчитай смету по этим данным». Открывается панель чата, запрос уходит без дополнительных действий.

Иногда удобнее другой вариант: текст запроса только подставляется в поле ввода и ждёт, пока человек его дополнит или поправит. Это тоже задаётся при сборке.

Скрипт

Самое мощное действие: нажатие запускает небольшую программу на сервере. Программа может сходить в вашу систему и вернуть ответ, а ответ управляет экраном. Возможны четыре реакции:

  • сообщение — всплывающая подсказка об успехе, ошибке или важном замечании;
  • обновление блоков — один блок или вся страница пересчитывается с новыми данными;
  • переход — открывается другая страница портала или внешний адрес;
  • скачивание файла — браузер получает файл, который собрал скрипт.

Если скрипт вернул понятную ошибку — например, «укажите корректную почту», — читатель увидит именно её, а не сухое техническое сообщение.

Подтверждение перед действием

Для любого действия, кроме обычной ссылки, можно задать вопрос-подтверждение: сначала покажется вопрос вроде «Отправить заявку?», и действие сработает только после согласия. Полезно там, где нажатие сложно отменить — например, при отправке формы или заявки.

Сколько кнопок помещается

На блоке размещается до трёх кнопок — если агент поставит больше, проверка структуры его об этом предупредит. У карусели могут быть свои кнопки на каждом слайде: например, на первом слайде «Читать», на втором «Записаться». Подробнее о проверке — в разделе Проверки страниц.

Неработающих кнопок не бывает

Кнопка появляется на странице, только если для неё есть обработчик. Если кнопка ведёт на скрипт, которого нет, или действие-запрос настроено без подключённого агента, кнопка просто не показывается. Читатель никогда не натолкнётся на элемент, который ничего не делает.

Дальше: что можно подставить в адрес перехода — в разделе Шаблоны и переменные; как устроены формы с отправкой — в разделе Формы; как считаются данные для действия — в разделе Скрипты и зависимости.

← Оглавление документации