--- title: "Кнопки и действия" id: "1978" type: "page" slug: "actions" published_at: "2026-09-20T15:43:00+00:00" modified_at: "2026-10-28T18:13:30+00:00" url: "https://pastukhov.com/agents/portal/docs/actions/" markdown_url: "https://pastukhov.com/agents/portal/docs/actions.md" excerpt: "Кнопка на странице — это не просто украшение, а действие. У любой кнопки портала заранее…" --- # Кнопки и действия [https://pastukhov.com/agents/portal/docs/actions/.md](https://pastukhov.com/agents/portal/docs/actions/.md) Кнопка на странице — это не просто украшение, а действие. У любой кнопки портала заранее известно, что произойдёт по нажатию. Всего есть шесть видов действий, и агент выбирает нужный при сборке страницы. ## Шесть видов действий - **Ссылка** — открывает внешний адрес в интернете. - **Переход по порталу** — открывает другую страницу внутри портала, не покидая его. - **Запрос агенту** — открывает чат с готовой просьбой в поле ввода. - **Одним нажатием** — сразу отдаёт готовую просьбу агенту отдельной беседой, без диалога и полей. - **Скрипт** — запускает расчётную программу на сервере, и её ответ управляет экраном. - **Форма** — открывает небольшое окно с полями и отправляет заполненное агенту. ## Ссылка Самое простое действие: нажатие открывает указанный адрес — на ваш сайт, в другой сервис, к скачиваемому файлу. При желании ссылка открывается в новой вкладке, чтобы посетитель не терял текущую страницу портала. Подпись кнопки задаёт агент. ## Переход по порталу Кнопка ведёт на другую страницу портала — например, с карточки новостей в саму новость. Адрес задаётся путём внутри портала, а значения переменных подставляются в него автоматически. Поэтому одна и та же кнопка на странице-образце ведёт на разные адреса в зависимости от того, какую страницу открыл читатель. Если нужно, кнопка открывает страницу в новой вкладке — тогда текущая остаётся на месте: удобно, когда читатель сравнивает две страницы или не хочет терять то, что читал. Подробнее — в разделе [Шаблоны и переменные](/agents/portal/docs/templates) . ## Запрос агенту Такая кнопка избавляет читателя от набора одинаковых просьб. Агент заранее записывает нужный запрос, и по нажатию открывается панель чата с уже готовой просьбой в поле ввода — например, «добавь план на квартал» или «пересчитай смету по этим данным». Отправляет её читатель сам: можно сначала дополнить или поправить текст. Если просьба должна уходить без лишнего нажатия, это задаётся отдельно — тогда панель открывается и отправляет сразу. У такой кнопки можно задать навык и модель — и тогда чат, открытый этой кнопкой, начнётся с нужного руководства и нужной модели. На ваш запомненный выбор в панели чата это не влияет: следующий новый чат откроется так, как вы привыкли. ## Одним нажатием Самый короткий путь: одно нажатие отдаёт готовую просьбу агенту отдельной беседой — без панели чата, без полей и без дополнительных подтверждений. Беседа появляется в списке чатов, её первое сообщение — ваша просьба, и агент берётся за неё сразу: ждать, пока что-нибудь включится, не нужно. Так делают кнопки для привычных повторяющихся дел: «пересчитать смету», «собрать отчёт за месяц», «проверить остатки». Пока просьба уходит, кнопка показывает, что работа идёт, а соседние кнопки ждут своей очереди. Когда агент принял просьбу, появляется сообщение об успехе — его текст тоже задаёт агент, а вместе с ним срабатывают заранее заданные последствия (о них — ниже). Такая кнопка бывает только в приложении и только при подключённом агенте: снаружи, на публичном сайте, она не показывается. ## Форма кнопкой Если просьбу агенту нужно дополнить сведениями от читателя, кнопка может открыть небольшое окно с полями. Например, кнопка «Заказать справку» спрашивает тему и желаемый срок. Читатель заполняет поля и нажимает «Отправить» — собранный текст уходит агенту так же, как форма на странице (см. [Формы](/agents/portal/docs/forms) ): новой беседой в списке чатов, а окно закрывается с сообщением. Такой кнопкой удобно собирать заявки там, где форма на всю страницу была бы лишней. ## Что происходит после принятия задания У кнопки «одним нажатием» и у формы с отправкой агенту можно заранее задать, что случится после того, как агент принял задание: обновить данные на странице и открыть нужную страницу — сразу или в новой вкладке. Например, кнопка «Пересобрать отчёт за квартал» обновляет плитки с цифрами и открывает сам отчёт рядом с текущей страницей. Если задание отклонено — например, истекла лицензия или агент недоступен, — не происходит ничего: ни обновления, ни перехода, только сообщение об ошибке. Обновить можно всю страницу с живыми данными или только выбранные блоки; «открыть» понимает и страницу портала, и обычный адрес в интернете. ## Скрипт Самое мощное действие: нажатие запускает небольшую программу на сервере. Программа может сходить в вашу систему и вернуть ответ, а ответ управляет экраном. Возможны четыре реакции: - **сообщение** — всплывающая подсказка об успехе, ошибке или важном замечании; - **обновление блоков** — один блок или вся страница пересчитывается с новыми данными; - **переход** — открывается другая страница портала или внешний адрес, сразу или в новой вкладке; - **скачивание файла** — браузер получает файл, который собрал скрипт. Если скрипт вернул понятную ошибку — например, «укажите корректную почту», — читатель увидит именно её, а не сухое техническое сообщение. ## Подтверждение перед действием Для любого действия, кроме обычной ссылки, можно задать вопрос-подтверждение: сначала покажется вопрос вроде «Отправить заявку?», и действие сработает только после согласия. Полезно там, где нажатие сложно отменить — например, при отправке формы или заявки. ## Сколько кнопок помещается На блоке размещается до трёх кнопок — если агент поставит больше, проверка структуры его об этом предупредит. У карусели могут быть свои кнопки на каждом слайде: например, на первом слайде «Читать», на втором «Записаться». Те же кнопки можно ставить и в ячейки таблицы — тогда в строке появляются компактные кнопки действий с теми же правилами. Подробнее о проверке — в разделе [Проверки страниц](/agents/portal/docs/validation) . ## Неработающих кнопок не бывает Кнопка появляется на странице, только если для неё есть обработчик. Если кнопка ведёт на скрипт, которого нет, она просто не показывается. Кнопки-просьбы (запрос агенту, «одним нажатием», форма) не появляются без подключённого агента и на публичном сайте: снаружи им некуда отправлять просьбу. Читатель никогда не натолкнётся на элемент, который ничего не делает. Дальше: что можно подставить в адрес перехода — в разделе [Шаблоны и переменные](/agents/portal/docs/templates) ; как устроены формы с отправкой — в разделе [Формы](/agents/portal/docs/forms) ; как считаются данные для действия — в разделе [Скрипты и зависимости](/agents/portal/docs/scripts) . [← Оглавление документации](/agents/portal/docs)