Применение ИИ и нейросетей

ИИ-агенты и автоматизация задач: как построить надёжный планировщик

Как обвязать ИИ-агента планировщиком: cron и вебхук, run_id, идемпотентность, lease с TTL, чекпоинты, журнал прогонов и три теста на сбои.

Редакция DeepMe
· Обновлено · 7 мин чтения
Раскрытый блокнот с чистыми страницами, металлическая линейка и песочные часы, соединённые цепочкой.

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

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

Зачем агенту планировщик, а не только промпт

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

Побочные эффекты и создают риск. Модель может быть недетерминированной, сеть — недоступной, а процесс — упасть посередине. Поэтому обвязка строится вокруг гарантии «ровно один раз» для бизнес-действия и «хотя бы один раз» для попытки запуска. Это разные вещи, и путать их — основная причина дублей.

Расписание и вебхук: два источника запуска, один run_id

У агента обычно два входа: cron (например, «каждый будний день в 9:00») и вебхук от внешней системы (новая заявка, обновление статуса). Оба должны приводить к одному и тому же формату задания, иначе логика повторов расползётся по двум разным местам.

Практичный приём — нормализовать оба источника в запись задания с полями:

  • run_id — уникальный идентификатор конкретного запуска;
  • job_key — логическое имя задачи (например, daily_report);
  • scheduled_for — момент, к которому относится работа (дата отчёта, а не время запуска);
  • source — cron или webhook;
  • payload — входные данные.

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

Идемпотентность на уровне бизнес-действия: ключ и локальный пример

Идемпотентность на уровне запуска недостаточна. Даже если запуск один, агент может дважды вызвать отправку письма — например, при повторе шага после таймаута. Ключ идемпотентности должен описывать само действие, а не прогон.

Учебный пример: агент формирует ежедневный отчёт по продажам и отправляет его в чат команды. Ключ действия можно собрать так:

action_key = "send_daily_report" + ":" + report_date + ":" + channel_id

Перед отправкой агент проверяет, не выполнялось ли действие с таким ключом. Если да — шаг считается завершённым и пропускается, даже если прогон перезапущен. Если нет — действие выполняется, а результат фиксируется вместе с ключом.

Важно, чтобы проверка и запись были атомарными: уникальный индекс по action_key в хранилище результатов надёжнее, чем «сначала посмотреть, потом записать». Второй вариант оставляет окно, в которое два параллельных шага успевают увидеть пустоту и оба отправить отчёт.

Правило: ключ идемпотентности строится из смысла действия и его параметров, а не из времени запуска. Время меняется при повторе, смысл — нет.

Lease с TTL: почему вечный флаг ломает повторный запуск

Типичная ошибка — флаг in_progress = true, который ставится в начале и снимается в конце. Если процесс упал, флаг остаётся, и задача больше никогда не запустится. Обратная ошибка — снимать флаг по таймауту слишком рано и получать два параллельных прогона.

Lease решает обе проблемы: исполнитель берёт аренду на ограниченный срок (TTL) и периодически её продлевает, пока работает. Если продления прекратились, аренда истекает, и задачу может взять другой исполнитель. Ключевые детали:

  • TTL должен быть заметно больше типичного шага, но меньше интервала расписания;
  • продление — отдельное действие, а не побочный эффект шага;
  • взятие аренды — атомарная операция с проверкой, что текущая аренда истекла или отсутствует;
  • в записи аренды хранится идентификатор владельца, чтобы старый исполнитель не смог продлить чужую аренду после истечения.

Такой подход не требует «идеального» завершения процесса: система восстанавливается после любого падения, а не после аккуратного выхода.

Чекпоинты и правила повторяемости шагов

Чекпоинт — это сохранённое состояние после завершённого шага: какие шаги выполнены, какие результаты получены, что осталось. При перезапуске агент читает последний чекпоинт и продолжает, а не начинает с нуля.

Чтобы чекпоинты были полезны, шаги нужно разделить на три категории:

  1. Повторяемые безопасно — чтение данных, расчёты, генерация текста. Их можно выполнять заново.
  2. Требующие ключа идемпотентности — отправка сообщений, запись во внешние системы, публикация.
  3. Необратимые — действия, которые нельзя отменить или повторить без последствий. Их лучше выносить в конец и требовать явного подтверждения.

Чекпоинт записывается после завершения шага и до начала следующего. Если записывать «в конце», падение посередине снова приведёт к полному повтору.

Журнал прогонов: какие поля писать

Журнал нужен не для отчётности, а для разбора инцидентов. Минимальный набор полей для каждой записи:

ПолеЗачем
run_idСвязать все события одного запуска
job_key, scheduled_forПонять, какая работа выполнялась
sourceОтличить cron от вебхука
attemptУвидеть повторы
step, statusНайти место остановки
action_keyПроверить, было ли действие выполнено
lease_owner, lease_expires_atРазобрать конфликты исполнителей
errorПонять причину сбоя

Журнал стоит писать до выполнения шага и после него: запись «начал» помогает отличить падение процесса от шага, который не начинался.

Три теста обвязки: перекрытие, падение посередине, повторная доставка вебхука

Обвязку нельзя считать готовой, пока она не прошла три проверки. Их можно провести на учебном стенде, не затрагивая реальные каналы.

1. Перекрытие запусков

Запустите задачу дважды почти одновременно. Ожидаемый результат: второй запуск не получает аренду и завершается без побочных эффектов, а в журнале видно, что он был отклонён. Если оба запуска дошли до отправки — аренда не работает.

2. Падение посередине

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

3. Повторная доставка вебхука

Отправьте одно и то же событие дважды с одинаковым идентификатором. Ожидаемый результат: создаётся одна задача, второй запрос распознаётся как повтор. Если появились две задачи — нормализация вебхука не учитывает идентификатор события.

Эти тесты проверяют именно обвязку, а не качество ответов модели. Их стоит прогонять после каждого изменения в планировщике.

Контекст протокола: что меняется в интеграциях

Обвязка планировщика живёт поверх протоколов, по которым агент общается с инструментами. В спецификации Model Context Protocol от 28 июля 2026 года описаны изменения, которые стоит учитывать при проектировании: переход к stateless-ядру, отказ от сессий и заголовка Mcp-Session-Id, отдельный механизм задач с опросом статуса, кэширование результатов списков. Подробности — в записи блога MCP.

Практический вывод для планировщика: если состояние больше не хранится в сессии на стороне сервера, его нужно явно передавать между вызовами. Это согласуется с идеей чекпоинтов: состояние принадлежит вашей задаче, а не соединению. При этом спецификация не содержит рекомендаций по cron, lease или идемпотентности — это зона ответственности вашей обвязки.

Чек-лист перед включением расписания

  • Cron и вебхук приводят к одной записи задания с общим run_id.
  • Для каждого побочного действия определён action_key и уникальный индекс в хранилище.
  • Вместо флага «в работе» используется аренда с TTL и продлением.
  • Чекпоинт пишется после каждого шага, а не в конце прогона.
  • Журнал фиксирует начало и конец шага, попытки и владельца аренды.
  • Пройдены три теста: перекрытие, падение посередине, повторная доставка вебхука.
  • Необратимые действия вынесены в конец и требуют подтверждения.

Если агент только начинает использоваться, полезно сначала сравнить подходы к построению агентных систем — например, в материале о мультиагентных системах. А если автоматизация касается контента или магазина, пригодятся разборы про ИИ в редакциях и SEO и про ИИ для маркетплейсов: там задачи имеют свои побочные эффекты, которые тоже нужно делать идемпотентными.

Ограничения подхода

Описанная схема не делает работу агента детерминированной и не гарантирует правильность результата. Она гарантирует лишь то, что действие не выполнится дважды и что после сбоя работа продолжится. Если внешняя система не поддерживает ключи идемпотентности, защита остаётся на вашей стороне и требует отдельной проверки. Кроме того, выбор хранилища, TTL и формата чекпоинтов зависит от нагрузки и требований к задержке — универсальных значений здесь нет.