Журнал запусков

Журнал запусков — это лог, который платформа ведёт для каждого выполнения (запуска) воркфлоу. Он отвечает на вопрос «что происходило в этом запуске?», и для этого не нужно ничего рисовать на схеме: что запустило сценарий, о чём спросили ИИ и что он ответил, что написал бот, что нажал пользователь и что пошло не так.

Что записывается

Большинство записей появляется автоматически — иконки для них добавлять не нужно, а отключить их нельзя:

Триггер — событие, запустившее сценарий (например, входящее сообщение Telegram или данные вебхука).
ИИ — каждое обращение к модели: промпт, ответ (или вариант, выбранный узлом выбора), использованная модель и расход токенов.
Сообщение — всё, что сценарий отправил: сообщения и файлы в Telegram, а также заданные вопросы вместе с кнопками.
Ввод пользователя — принятый ответ (нажата кнопка, решена задача) или тайм-аут, если никто не ответил вовремя.
Предупреждения и ошибки — проигнорированный ввод (например, нажатие на старую кнопку, на которую уже отвечали), упавший шаг (в журнале видна каждая неудачная попытка, в том числе те, что потом удалось повторить), запуск, завершившийся ошибкой, и ввод, который вообще не удалось доставить в запуск.
Лог — то, что вы пишете сами иконкой лог. Её текст попадает в журнал обычной записью уровня Инфо с привязкой к этой иконке (уровней у иконки нет).

Так описаны только встроенные интеграции. Действия из каталога ActivePieces во время работы в журнал не пишутся, но если такое действие завершилось ошибкой, неудачная попытка попадёт в журнал как запись об ошибке — так же, как и сбой любого другого шага.

Где смотреть

Проект → Запуски, затем откройте нужный запуск: панель с подробностями открывается на вкладке Журнал (она выбрана по умолчанию). На остальных вкладках — Вход и результат и собственные События Temporal движка.
В строке видно время, тип, уровень и иконку, из-за которой появилась запись; кликните по её названию — откроется документ, а иконка подсветится на холсте. Раскройте строку, чтобы увидеть подробности: промпт и ответ — текстом, остальное — в виде JSON.
Фильтруйте по Типам и Уровню или включите Только ошибки, чтобы увидеть лишь то, что пошло не так.
Для чат-бота Вся переписка показывает журнал всех запусков этого чата вместе (каждый чат в Telegram — одна беседа, которую со временем продолжают новые запуски); Только этот запуск возвращает обратно.
Если нажать Запустить в редакторе, боковая панель выполнения показывает тот же журнал по мере его роста.

Записи пишутся в фоне и никогда не замедляют запуск, поэтому появляются через секунду-две после события. Журнал также живёт дольше, чем собственная история запусков движка: запуск, который движок уже забыл, всё равно можно прочитать по его журналу.

Сколько он хранится

Записи удаляются через 14 дней; срок считается отдельно для запусков на тестовом стенде и для опубликованных (prod). Записи проекта удаляются вместе с самим проектом. Если вы разворачиваете Falang у себя, задайте на бэкенде переменные RUN_JOURNAL_RETENTION_DAYS_DEV и RUN_JOURNAL_RETENTION_DAYS_PROD, чтобы изменить число дней (по умолчанию для обеих — 14).

Не хранить тексты

В журнале может оказаться то, что писали ваши клиенты, и то, что ответил ИИ. Чтобы этого там не было, откройте Проект → Журнал запусков и выключите Хранить тексты (промпты, ответы, сообщения). После этого новые записи содержат только метаданные — тип, иконку, модель, размеры, тип ошибки — и помечаются «тексты не сохранены». Тексты ошибок сохраняются в сокращённом виде. Уже сохранённые записи не переписываются — они просто удалятся по истечении срока хранения.

Слишком длинные тексты в любом случае обрезаются до разумного размера (с пометкой «обрезано»), а файлы записываются как ссылки, а не как содержимое.