> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/scenarii.md).
# Сценарии
Функционал "Сценарии" — это инструмент для автоматизации задач и создания гибкого поведения вашего ИИ-агента. С его помощью агент может реагировать на различные события в диалоге и выполнять заданные действия, такие как отправка сообщений, интеграция с CRM, выполнение Python-скриптов и многое другое.
Как это работает?
Сценарий запускается, когда происходит определённое **событие** (например, клиент отправляет сообщение). После этого выполняется одно или несколько **действий**, которые вы настроили: сразу или с задержкой, если включено [отложенное выполнение](/functional/scenarii/deistviya-v-scenariyakh.md).
Вы можете комбинировать различные события и действия так, как будет нужно именно вам. Не стесняйтесь экспериментировать!
## В этом разделе
Чтобы было проще ориентироваться, мы разделили тему сценариев на отдельные статьи:
* [Виды сценариев (события)](/functional/scenarii/vidy-scenariev.md)
* [Дополнительные условия](/functional/scenarii/dopolnitelnye-usloviya.md)
* [Действия в сценариях](/functional/scenarii/deistviya-v-scenariyakh.md)
* [Примеры сценариев](/functional/scenarii/primery-scenariev.md)
* [Проверка подписки Telegram](/functional/scenarii/proverka-podpiski-telegram.md)
## Группы сценариев
Группы сценариев помогают объединять сценарии по бизнес-логике и управлять приоритетом их выполнения. Это особенно удобно, когда у вас много похожих сценариев в одном агенте.
### Как создать группу
Создание групп доступно на главной странице раздела **«СЦЕНАРИИ»** по кнопке **«НОВАЯ ГРУППА»**.
После нажатия откроется модальное окно, где можно:
1. Указать название группы.
2. Выбрать приоритет группы.
3. Добавить или удалить группу.
### Приоритет группы и приоритет сценария
Если под одно событие подходят несколько сценариев, сначала учитывается **приоритет группы**, в которой находятся эти сценарии. При конфликте одинаковых сценариев фактически выполняются действия сценария из группы с более высоким приоритетом.
Внутри любого сценария также можно дополнительно настраивать поле **Приоритет выполнения** и управлять порядком запуска.
### Как добавить нужный сценарий в группу и сменить его приоритет
Откройте нужный сценарий и:
1. Выберите для него нужную группу в поле **"Группа сценария"**.
2. При необходимости измените поле **Приоритет выполнения** в той же карточке.
Такой сценарий запускается при выполнении события и условий, а затем выполняет свои действия с учётом выставленных приоритетов.
{% hint style="info" %}
Группы сценариев помогают структурировать сценарии и управлять приоритетом их выполнения.
{% endhint %}
Как настроить и включить сценарий
Чтобы настроить и включить сценарий, выполните следующие шаги:
1. Зайдите в левом меню в раздел **"СЦЕНАРИИ"**
2. Нажмите кнопку **"ДОБАВИТЬ СЦЕНАРИЙ"** — сценарий создастся с базовыми настройками. Либо нажмите **"ДОБАВИТЬ СЦЕНАРИЙ ПО ШАБЛОНУ"** и выберите готовый шаблон: сценарий создастся уже с преднастройками, которые при необходимости можно изменить.
3. Выберите **условие** из списка доступных триггеров — сценарий будет создан.
4. Откройте созданный сценарий (нажмите на него), чтобы настроить действия, группу, поле **"Приоритет сценария"** и др.
5. Нажмите кнопку **"ДОБАВИТЬ УСЛОВИЕ"** и выберите одно или несколько дополнительных условий для срабатывания сценария (опционально). Если нужна развилка, настройте блоки **«Настройки действий при выполнении условий»** и **«Настройки действий при невыполнении условий»**.
6. Нажмите кнопку **"ДОБАВИТЬ ДЕЙСТВИЕ"** и выберите одно или несколько действий, которые должны выполняться при срабатывании сценария.
7. Сохраните изменения.
8. Не забудьте проверить сценарий в тестовом чате или через реальный подключенный канал!
Теперь ваш сценарий готов к работе и будет автоматически запускаться при выполнении заданных условий!
{% hint style="warning" %}
Обратите внимание, что при добавлении ключевых слов и проверке семантического совпадения (в действии "Cовпадение запроса по смыслу") происходит векторизация текста в OpenAI. Стоимость векторизации зависит от количества токенов в тексте и рассчитывается по цене 0.13 USD за 1М токенов, учитывайте это при добавлении ключевых слов или проверке семантического совпадения. В случае, если у вас установлен свой ключ OpenAI, то проверка семантического совпадения возможна только с положительным балансом на вашем аккаунте OpenAI.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://doc.nextbot.ru/functional/scenarii.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.