Перейти к содержанию

Таймеры и будильники

Таймер — это способ вернуться к работе позже, не занимая процесс ожиданием. Вместо sleep в команде агент ставит таймер: когда время придёт, сессия получит сообщение с комментарием и продолжит с того места, где остановилась.

Коротко

Срабатывание таймера — это сообщение в сессию, а не отдельное задание. Своего текста у таймера нет: есть только комментарий, по которому агент понимает, зачем его разбудили.

Зачем это нужно

  • Дождаться события: «через час посмотри, закончился ли деплой».
  • Вернуться к длинной сборке или тестам, не держа ход открытым.
  • Получать регулярное напоминание: «каждый день в 9:00 — сводка по задачам».

sleep в команде — плохая замена: синхронный запуск ограничен минутами, а фоновый держит процесс и не возвращает управление диалогу. Таймер не занимает ни ход, ни процесс: он просто ждёт.

Как создать

В диалоге. Попросите агента словами: «напомни через два часа проверить сборку», «разбуди в 9:30 по Москве». Агент поставит таймер или будильник сам — инструментами timer и alarm.

Во вкладке «Автоматизация». Правая панель → вкладка «Автоматизация»: фильтры по виду («Все», «Расписания», «Таймеры», «Будильники»), счётчики и карточки; кнопки «Добавить таймер» и «Добавить будильник» открывают форму. Скоуп переключается между сессией и проектом.

Только в проекте

Таймер всегда принадлежит проекту и сессии. Инстансных автоматизаций нет: без проекта и сессии таймер не создаётся.

Два вида

Вид Что задаёт Правило срабатывания
Таймер Относительный отсчёт: «через N» Задержка от 10 секунд до 30 суток
Будильник Абсолютное время at — конкретный момент, либо HH:MM + часовой пояс

Повторы одинаковы у обоих видов:

Повтор Смысл
once Один раз (горизонт — до 30 суток)
daily Каждый день в указанное время (HH:MM + часовой пояс)
every Каждые N секунд (от 10 до 2 592 000 — это 30 суток)
  • Время без смещения трактуется в локальной зоне сервера; если нужен другой пояс, укажите его явно.
  • После срабатывания повторяющийся таймер сам пересчитывает ближайшее срабатывание — серии «догоняющих» запусков не будет.

Правила

  • Комментарий обязателен — от 1 до 500 символов. Это единственный смысл срабатывания: агент читает комментарий и историю, а не готовый текст задания.
  • До 50 активных таймеров на сессию.
  • Дубликат отклоняется. Если активный таймер с тем же видом, комментарием и именем уже есть, новый не создаётся; в ответе видно, какой именно таймер совпал. Дубликат можно разрешить явно — тогда создаются оба.
  • Время в прошлом — ошибка. Для будильника допускается небольшое расхождение (до 60 секунд), всё, что раньше, отклоняется.
  • Имя необязательно: оно нужно только для удобства в списке.

Управление

Действие Что происходит
Пауза Таймер остаётся в списке, но не срабатывает
Продолжить Снимает паузу; повторяющийся пересчитывает ближайшее срабатывание от текущего момента
Остановить Статус «отменён», запись остаётся в истории
Удалить Убирает запись; история срабатываний при этом сохраняется
  • Остановка идемпотентна: повторное нажатие не ошибка и возвращает текущее состояние. Остановить уже сработавший таймер тоже можно — без ошибки.
  • Завершённые не редактируются. Сработавший или отменённый таймер нельзя изменить, пауза и возобновление для него недоступны.
  • История срабатываний открывается из карточки: когда сработало, на какое время было запланировано, насколько опоздало и чем закончилось (успех, ошибка, пропуск).
  • Значки в дереве сессий показывают активные таймеры и будильники рядом с другими индикаторами работы: иконка со счётчиком и подсказкой. Список обновляется по событиям, без перезагрузки страницы.

Ограничения

  • Точность — приблизительная. Срабатывание приходит в пределах примерно секунды от запланированного; под нагрузкой возможен дополнительный сдвиг в десятки миллисекунд.
  • Пропущенное срабатывание. Если инстанс был недоступен, просроченный одноразовый таймер сработает один раз при старте; повторяющиеся просто пересчитываются на ближайшее будущее время — серии пропущенных запусков не будет.
  • Ошибка доставки не повторяется автоматически. Если сообщение не удалось доставить, одноразовый таймер переходит в завершённые с причиной ошибки, а повторяющийся ждёт следующего цикла. Причину видно в карточке и истории.
  • В SDK таймеров нет. Операции описаны в публичном API (и доступны service-ключам с нужными правами), но отдельного раздела в типизированном клиенте пока нет — до его появления контур используют напрямую по HTTP.
  • При деградированном хранилище контур таймеров не поднимается: запросы отвечают «не найдено», как и у фоновых прогонов.

Чем отличается от расписания

Похоже только на первый взгляд: у расписания и таймера разные роли.

Расписание (cron) Таймер / будильник
Что запускает Задание со своим текстом, который получает агент Только комментарий — смысл восстанавливает агент
Когда Cron-выражение или интервал Задержка или конкретное время, повторы
Куда Постоянная сессия, очередь, временная сессия или пайплайн Всегда своя сессия проекта
Зачем Регулярный процесс: отчёты, сборки, проверки «Вернись к этому позже»

Расписания теперь тоже принадлежат проекту: инстансных расписаний нет, как и инстансных таймеров.

Подробнее