Создание первого сценария
Как создать AI-сценарий, настроить персону, задать system prompt и запустить первый диалог за 5 минут.
- Вы впервые работаете с API-платформой
- Нужно быстро запустить первого бота
- Хотите понять основную структуру сценария
- Готовый работающий сценарий
- Понимание ключевых настроек: язык, fallback, max_turns
- Первый диалог через playground
Из чего состоит сценарий
Сценарий — это конфигурация AI-агента: кто он, как отвечает, какие инструменты использует.
Каждый сценарий содержит имя персоны (как бот представляется пользователю), system prompt (инструкции для AI), настройки языка и поведение при непонятных запросах (fallback_message).
Дополнительно можно задать этапы диалога (stages) — конечный автомат, который управляет тем, в какой момент бот задаёт уточняющие вопросы, собирает лиды или предлагает оператора.
Откройте раздел API-платформа в кабинете
Перейдите в сайдбаре в "API-платформа" → "Сценарии".
Нажмите "Создать сценарий"
Выберите пустой шаблон или один из готовых (поддержка клиентов, лидогенерация, helpdesk).
Заполните основные поля
Имя персоны (например, "Алиса — ассистент по тарифам"), system prompt с инструкциями, язык ответов.
Протестируйте в playground
Откройте вкладку Playground и напишите несколько сообщений — бот ответит по вашему сценарию.
Ключевые настройки сценария
Язык (language) задаёт, на каком языке бот отвечает. Значение "auto" — бот отвечает на языке пользователя. Можно зафиксировать "ru" или "en".
Max turns ограничивает длину диалога — после достижения лимита сессия заканчивается. Session TTL задаёт, сколько часов сессия остаётся активной без новых сообщений.
Fallback message — что бот говорит, когда не понимает запрос. Хорошая практика — предложить позвонить или переключиться на оператора.
- language: "auto" — адаптируется под пользователя, "ru" или "en" — фиксированный язык.
- max_turns: 30 по умолчанию. Уменьшите до 10-15 для простых форм сбора лидов.
- session_ttl_hours: 24 по умолчанию. Для Telegram увеличьте до 72+, чтобы пользователь мог вернуться.
- fallback_message: обязательно заполните — без него бот молчит при непонятных запросах.