---
title: "Кнопки и действия"
id: "1978"
type: "page"
slug: "actions"
published_at: "2026-09-20T15:43:00+00:00"
modified_at: "2026-09-21T00:00:47+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/validation)
.

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

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

Дальше: что можно подставить в адрес перехода — в разделе [Шаблоны и переменные](/agents/portal/docs/templates)
; как устроены формы с отправкой — в разделе [Формы](/agents/portal/docs/forms)
; как считаются данные для действия — в разделе [Скрипты и зависимости](/agents/portal/docs/scripts)
.

[← Оглавление документации](/agents/portal/docs)