🔁 Версии и запуски
Статусы сценария
| Статус | Что означает |
|---|---|
| Черновик | рабочая копия, по событиям не срабатывает |
| Опубликован | активен, реагирует на триггер |
| В архиве | скрыт и не срабатывает |
Что можно сделать со сценарием
В меню строки сценария в списке доступны:
| Действие | Что делает | Минимальная роль |
|---|---|---|
| Открыть редактор | открыть граф на холсте | По умолчанию (без права на правку — только просмотр) |
| Версии | история опубликованных версий | По умолчанию |
| Запуски | история прогонов | По умолчанию |
| Редактировать | изменить название и описание | Редактор |
| Дублировать | создать копию с суффиксом «(копия)» | Редактор |
| Архивировать | убрать сценарий из работы | Администратор |
| Удалить | удалить безвозвратно | Администратор |
Архивирование предупреждает: «Сценарий „X“ будет помещён в архив. Активные запуски будут прерваны».
«Удаление возможно только для черновиков без запусков». Если запуски были, появится ошибка «Нельзя удалить: у сценария есть запуски. Используйте архивирование».
Черновик и автосохранение
Правки на холсте сохраняются сами — в верхней панели видно состояние: «Готово к работе», «Сохранение…», «Сохранено», «Не сохранено». Пока последняя правка не сохранилась, публикация не пройдёт: «Сначала исправьте ошибку сохранения».
У опубликованного сценария без черновика редактор открывается только для чтения и предлагает создать черновик: «У этого сценария нет черновика. Чтобы редактировать сценарий, создайте черновик. Опубликованная история останется на месте — её можно открыть в режиме просмотра во вкладке „Версии“». Кнопка — «Создать черновик» («Скопировать текущую опубликованную версию в новый редактируемый черновик»).
Публикация
Кнопка «Опубликовать» превращает черновик в новую версию: «Опубликовать draft → новая версия». Обратное действие — «Снять с публикации» («Убрать сценарий с прода. Версия останется в истории»); оно, как и архивирование, прерывает активные запуски.
Если граф не проходит проверку, вместо общей ошибки открывается окно «Не удалось опубликовать» со списком конкретных проблем и переходом к нужному блоку на холсте:
| Проблема | Что исправить |
|---|---|
| Висящий edge | связь ведёт в никуда |
| Неизвестный тип блока | блок, которого больше нет в каталоге |
| Недостижимый блок | до блока нельзя дойти от «Старта» |
| Не заполнено обязательное поле | в блоке пустое обязательное поле |
| Невалидное значение поля | значение поля не подходит по типу или формату |
| Не разведён динамический выход | кнопка, кейс или исход агента без связи — см. Блоки |
Сюда же попадают недопустимые дополнительные условия запуска.
Скомпилированный сценарий держится в памяти сервиса до 10 минут, поэтому первые события после публикации могут ещё какое-то время уйти по прежней версии.
Версии
Вкладка «Версии сценария» — история публикаций. Колонки: «Версия», «Статус», «Опубликована», «Опубликовал». Если публикаций ещё не было — «У этого сценария ещё нет версий».
Действия по каждой версии:
- «Просмотр графа» — открывает граф этой версии в режиме только для чтения, заголовок — «Сценарий — версия v2»;
- «Восстановить как draft» — переносит версию в черновик, чтобы продолжить с неё;
- «Скачать JSON» — выгружает граф файлом.
Граф целиком также можно выгрузить и загрузить прямо из редактора кнопками «Экспорт» и «Импорт».
Операции «вернуть версию N» в системе не существует. Черновик всегда создаётся как копия последней опубликованной версии — это и делает кнопка «Создать черновик». Старые версии доступны только на чтение: посмотреть граф и скачать JSON. Если нужно вернуться к версии, которая опубликована не последней, выгрузите её JSON и загрузите кнопкой «Импорт» в черновик.
Запуски
Вкладка «Запуски сценария» — список прогонов. Фильтры: «Все», «Активные», «Завершены», «Ошибка», «Прерваны», плюс поиск по пользователю. Колонки: «ID», «Состояние», «Пользователь», «Начат», «Длительность», «Текущий блок». Список отдаёт 200 последних запусков, максимум — 1000.
У активного запуска в меню строки есть действие «Отменить» (право — Администратор). Если под фильтр ничего не попало — «Нет запусков для выбранных фильтров».
Состояния запуска
| Состояние | Значение |
|---|---|
| Выполняется | сценарий работает |
| Ожидание события | ждёт ответа клиента (блок «Вопрос», ожидание реплики агента) |
| Ожидание задержки | пауза (блок «Задержка») |
| Завершён | успешно закончился |
| Ошибка | прервался из-за ошибки |
| Прерван | отменён или вытеснен другим запуском |
Причины прерывания
У прерванного запуска видно, кто и почему его остановил:
| Причина | Когда показывается |
|---|---|
| Остановлен оператором | оператор нажал «Остановить выполнение», сценарий сняли с публикации или заархивировали; рядом показывается имя оператора |
| Вытеснен новым запуском | по этому же объекту стартовал другой сценарий |
| Отменён клиентом | зарезервировано, сейчас не выставляется |
| Прервано системой | зарезервировано, сейчас не выставляется |
| Причина неизвестна | старые запуски без атрибуции |
Те же формулировки приходят оператору уведомлением в чат.
Деталка запуска
Страница одного запуска показывает, как сценарий шёл по графу. У неё две вкладки — «Обзор» и «Трейс».
Слева — граф той версии, на которой запуск выполнялся: подсвечены пройденные блоки (успешные и упавшие) и текущий блок. Если версия недоступна — «Версия запуска недоступна (возможно, удалена)».
«Обзор» — панели:
| Панель | Что показывает |
|---|---|
| Состояние | статус, «Начат», «Завершён», «Курсор» (текущий блок) |
| Переменные | значения переменных запуска; добавленные, изменённые и удалённые подсвечиваются |
| Данные триггера | что пришло в сценарий на старте |
| Ошибка | текст ошибки, если запуск упал |
| Причина прерывания | почему запуск остановили и кто |
«Трейс» — лента «Ход прогона»: запись на каждый вход в блок, по порядку. У блока «AI-агент» запись раскрывается в группу «Сессия агента» с ходами модели, вызовами навыков, поиском по базе знаний и репликами — подробности в разделе Агентский режим.
У активного запуска рядом со статусом горит метка «Live» и есть кнопка обновления; у завершённого их нет — состояние больше не меняется.
Сколько хранятся запуски
Завершённые запуски вместе с трассой хранятся 30 дней, потом удаляются автоматически. У старого запуска вместо ленты будет надпись «Трейс удалён по сроку хранения». Если запуск нужен для разбора инцидента, выгружайте нужное, пока срок не вышел.
Тестовый прогон
Окно тестового запуска («Тестовый запуск сценария», «Тестовый webhook», «Тестовое срабатывание расписания») в продукте реализовано, но кнопки, которая его открывает, в панели редактора нет — открыть окно нечем. Проверять сценарий приходится настоящим запуском: опубликовать и запустить вручную или дождаться события.
Один активный запуск на объект
Активный запуск один на связку «клиент + тип сценария + объект» (обращение или тикет): новый запуск вытесняет предыдущий, и тот получает причину прерывания «Вытеснен новым запуском». Сценарии типа «Глобальный» друг друга не вытесняют — они выполняются параллельно, как и запуски по расписанию, у которых нет клиента.
Ограничения
| Что | Лимит |
|---|---|
| Размер графа сценария | 1 МиБ |
| Значение одной переменной | 64 КиБ |
| Все переменные одного запуска | 256 КиБ |
| Тело вебхука | 64 КиБ |
| Обращений к ИИ на один запуск | 200 |
| HTTP-запросов на один запуск | 100 |
| Блоков за один проход | 1000 |
| Блоков за весь запуск | 10 000 (дальше запуск обрывается) |
| Хранение завершённых запусков | 30 дней |
| Запусков в минуту на пользователя | 60 |
| Публикаций в минуту на пользователя | 10 |
| AI-правок в минуту на пользователя | 30 |
| Вебхуков в минуту на проект | 600 |
Кто что может
| Действие | Минимальная роль |
|---|---|
| Смотреть версии, запуски и трассу | По умолчанию |
| Править черновик, создавать черновик из опубликованной версии | Редактор |
| Публиковать и снимать с публикации | Администратор |
| Архивировать и удалять сценарий | Администратор |
| Запускать вручную и отменять запуск | Администратор |
Шаблоны
Чтобы не собирать граф с нуля, можно взять один из готовых сценариев — см. Шаблоны сценариев.
→ Блоки · Триггеры · Шаблоны сценариев