Таймеры и будильники¶
Таймер — это способ вернуться к работе позже, не занимая процесс ожиданием.
Вместо 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-выражение или интервал | Задержка или конкретное время, повторы |
| Куда | Постоянная сессия, очередь, временная сессия или пайплайн | Всегда своя сессия проекта |
| Зачем | Регулярный процесс: отчёты, сборки, проверки | «Вернись к этому позже» |
Расписания теперь тоже принадлежат проекту: инстансных расписаний нет, как и инстансных таймеров.
Подробнее¶
- Расписания (cron) — регулярные задания с собственным текстом.
- События и автоматизация — как события попадают в сессии.
- Фоновая работа — долгие прогоны без ожидания в ходе.
- Сессии и проекты — проект как контейнер автоматизаций.