Перейти к содержимому
ШагоматШагоматШагоматДокументация
shagomat.ruВойтиПопробовать бесплатно

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

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

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

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

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

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

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

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

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

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