Журнал запусков
Журнал запусков — лог, который Шагомат ведёт для каждого запуска сценария. Он отвечает на вопрос «что происходило в этом запуске?», и для этого не нужно ничего рисовать на схеме: что запустило сценарий, о чём спросили ИИ и что он ответил, что написал бот, что нажал пользователь и что пошло не так.
Что записывается
Заголовок раздела «Что записывается»Большинство записей появляется автоматически, отключить их нельзя:
- Триггер — событие, запустившее сценарий (входящее сообщение, данные вебхука).
- ИИ — каждое обращение к модели: промпт, ответ (или выбранный вариант), модель и расход токенов.
- Сообщение — всё, что сценарий отправил: сообщения и файлы в мессенджеры, заданные вопросы с кнопками.
- Ввод пользователя — принятый ответ (нажата кнопка, решена задача) или таймаут, если никто не ответил.
- Предупреждения и ошибки — проигнорированный ввод (например, нажатие на старую кнопку), упавший шаг (каждая неудачная попытка, в том числе те, что потом удались при повторе), запуск, завершившийся ошибкой, и событие, которое не удалось доставить в сценарий.
- Лог — то, что вы пишете сами иконой Лог, с привязкой к ней.
Действия из каталога дополнительных интеграций в журнал не пишутся, но их ошибки попадают в него, как ошибки любого другого шага.
Где смотреть
Заголовок раздела «Где смотреть»- Запуски в верхнем меню или Проект → Запуски, затем нужный запуск: подробности открываются на вкладке Журнал. На соседних вкладках — входные данные и результат и история событий.
- В строке — время, вид записи, уровень и икона, из-за которой она появилась. Клик по названию иконы открывает документ и подсвечивает её. Строку можно раскрыть: промпт и ответ — текстом, остальное — в виде JSON.
- Фильтры по видам и уровню и переключатель «Только ошибки».
- Для чат-бота «Вся переписка» показывает журнал всех запусков этого чата подряд (каждый чат — одна беседа, которую со временем продолжают новые запуски).
- При «Запустить функцию» тот же журнал растёт в панели запуска.
Записи пишутся в фоне и никогда не замедляют сценарий, поэтому появляются через секунду-две после события.
Сколько хранится
Заголовок раздела «Сколько хранится»Записи хранятся 14 дней — отдельно для тестового стенда и прода — и удаляются вместе с проектом. Журнал живёт дольше подробной истории событий: старый запуск, у которого история уже недоступна, всё равно можно прочитать по журналу.
Не хранить тексты
Заголовок раздела «Не хранить тексты»В журнал может попасть то, что писали ваши клиенты, и то, что ответил ИИ. Чтобы этого там не было, откройте Проект → Настройки → Журнал запусков и выключите «Хранить тексты (промпты, ответы, сообщения)». Новые записи будут содержать только служебные данные — вид, икону, модель, размеры, тип ошибки — с пометкой «тексты не сохранены». Уже сохранённые записи не переписываются, они удалятся по истечении срока.
Слишком длинные тексты обрезаются (с пометкой «обрезано»), а файлы записываются ссылками, а не содержимым.