Контрольная точка ИИ-агента: как сохранить и восстановить задачу
Контрольная точка сохраняет проверенное состояние задачи на безопасной границе: что уже подтверждено, какое действие завершено, что неизвестно и с какого шага можно продолжать без повторения внешних эффектов.
Короткий ответ: сохраняйте принятое состояние, а не пересказ диалога
Контрольная точка ИИ-агента — это неизменяемая запись состояния одной задачи на понятной границе выполнения. В ней достаточно данных, чтобы другой процесс или следующий запуск могли проверить уже сделанное и выбрать следующий шаг. Полезная запись отвечает на четыре вопроса: какая цель выполняется, какой результат уже принят, что остаётся неизвестным и какое действие разрешено дальше.
Сохранять весь диалог обычно недостаточно. Переписка смешивает инструкции, промежуточные догадки, сообщения инструментов и исправления. При восстановлении пришлось бы заново угадывать, какое утверждение стало рабочим фактом, а какое было отвергнуто. Контрольная точка отделяет подтверждённое состояние от истории рассуждения и прямо помечает открытые вопросы.
Перед проектированием записи полезно определить, чем ИИ-агент отличается от чат-бота: агент не только формулирует ответ, но и меняет состояние задачи через шаги и инструменты. Поэтому восстанавливать нужно не стиль разговора, а границу между завершённым и следующим действием.
Что является контрольной точкой, а что — нет
Границы понятия
Артефакт
Главный вопрос
Почему не заменяет checkpoint
План
Что делать дальше?
План может устареть и не доказывает, что предыдущий шаг принят.
Память
Что стоит помнить между задачами?
Память хранит полезный контекст, но не обязана фиксировать границу конкретного выполнения.
Журнал событий
Что происходило по порядку?
История помогает аудиту, но для продолжения её ещё нужно свернуть в актуальное состояние.
Передача задачи
Кто продолжит работу?
Смена владельца использует checkpoint, но не определяет его содержимое.
Контрольная точка
Из какого проверенного состояния можно продолжить?
Это и есть минимальная запись для возобновления.
Артефакты могут ссылаться друг на друга, но решают разные задачи.
Сначала агенту всё равно нужен цикл планирования шагов: он определяет, какой результат считать завершённым и где проходит безопасная граница. Контрольная точка появляется после приёмки шага, а не вместо планирования.
Минимальные поля состояния
Запись должна быть сериализуемой: её можно сохранить и однозначно прочитать без скрытого состояния процесса. Формат не принципиален — JSON, YAML или запись в хранилище подходят одинаково, если схема явная. Важно хранить данные, а не готовый промпт: цель, идентификаторы, результаты инструментов и ограничения проще проверить и использовать в другой реализации.
task_id и checkpoint_id — стабильные идентификаторы задачи и конкретной записи;
schema_version — версия структуры, по которой читатель понимает поля;
status и accepted_step — текущее состояние и последний принятый шаг;
confirmed — только подтверждённые факты, результаты и ссылки на артефакты;
unknowns — вопросы, для которых ещё нет основания;
completed_effects — внешние действия с их идентификаторами и результатами;
next_action — одно разрешённое продолжение с условиями запуска;
permissions_snapshot — какие права требовались и что нужно перепроверить;
integrity — хеш или другая проверка целостности содержимого;
parent_checkpoint_id — связь с предыдущей неизменяемой записью.
Не переносите в confirmed вывод только потому, что агент уверенно его сформулировал. Подтверждённым становится результат, прошедший заданную приёмку: инструмент вернул ожидаемую структуру, ссылка открывается, файл существует, действие получило квитанцию или человек явно согласовал решение. Неизвестное лучше оставить отдельным полем, чем превращать в правдоподобное значение.
Шаблон намеренно не хранит длинную цепочку рассуждений. Для продолжения достаточно принятого результата, происхождения данных, открытого вопроса и следующего действия. Если исполнителю нужен исходный документ, checkpoint содержит ссылку и ожидаемую версию, а не копию всей переписки вокруг документа.
Контрольная точка связана с памятью ИИ-агента, но не совпадает с ней. Память может хранить предпочтения, накопленные знания и рабочий контекст нескольких шагов. Checkpoint отвечает уже: в каком проверенном состоянии находится именно эта задача.
Когда создавать контрольную точку
Лучшее место — граница, после которой результат предыдущего шага уже принят, а следующий ещё не начат. Такой границей может быть успешное чтение версии документа, получение и проверка ответа инструмента, сохранение черновика с хешем или перевод задачи в ожидание внешнего решения. Запись до приёмки отмечают как промежуточную и не используют как основание для необратимого продолжения.
Выполните один ограниченный шаг и получите наблюдаемый результат.
Проверьте результат по критериям шага: структура, целостность, происхождение и ограничения.
Отделите подтверждённые данные от догадок и открытых вопросов.
Зафиксируйте уже совершённые внешние эффекты вместе с идентификаторами операций.
Сформулируйте одно следующее действие и условия, при которых его можно выполнять.
Сериализуйте запись в каноническом порядке и вычислите проверку целостности.
Сохраните новую запись, не переписывая предыдущую.
Не каждое внутреннее микродействие требует отдельного checkpoint. Слишком частые записи создают шум и усложняют восстановление. Выбирайте границы, где повтор шага дорог, заметен пользователю или может изменить внешний объект. Для чистого вычисления без побочного эффекта достаточно сохранить вход и принятый результат на ближайшей значимой границе.
Как продолжить задачу без повторения внешнего действия
Главный риск восстановления — повторить отправку, запись, оплату, публикацию или другое действие, которое могло завершиться до сбоя. Поэтому completed_effects хранит не фразу «готово», а идентификатор операции и ссылку на наблюдаемый результат. После загрузки checkpoint агент сначала проверяет этот результат во внешней системе. Лишь подтверждённое отсутствие эффекта позволяет решать, нужен ли повтор.
Если состояние внешней операции неизвестно, безопасный статус — unknown, а не failed. В таком состоянии агент не угадывает и не запускает действие заново автоматически. Он выполняет доступную проверку по идентификатору операции, запрашивает независимое подтверждение или удерживает задачу. Это сохраняет границу между отсутствием доказательства и доказанным отсутствием результата.
Проверка перед возобновлением
Проверка
Если пройдена
Если не пройдена
Схема поддерживается
Прочитать поля
Остановить и выполнить явную миграцию
task_id совпадает
Продолжить эту задачу
Не смешивать состояния
Хеш корректен
Доверять целостности записи
Удержать повреждённую запись
Ссылки доступны
Загрузить артефакты
Запросить восстановление основания
Права актуальны
Разрешить следующий шаг
Не использовать старый снимок прав
Внешний эффект проверен
Не повторять завершённое
Оставить статус неизвестным до проверки
Возобновление — это последовательность проверок, а не безусловный запуск next_action.
Версии, миграции и неизменяемость
Схема checkpoint меняется отдельно от содержимого задачи. Поле schema_version говорит, как читать запись; parent_checkpoint_id связывает последовательные состояния. Старую контрольную точку не редактируют задним числом. Если обнаружена ошибка, создают новую запись с исправлением и объяснимой связью с родителем. Так можно восстановить, какое состояние действительно было доступно исполнителю.
Миграция должна быть явным преобразованием из известной схемы в известную. После неё заново проверяют обязательные поля и целостность результата. Если часть значения нельзя восстановить однозначно, поле переносится в unknowns, а требующий его следующий шаг блокируется. Молчаливое заполнение значением по умолчанию опасно: оно маскирует потерю данных как нормальное состояние.
Как проверить механизм восстановления
Тестируйте не только успешное чтение файла. Остановите учебный процесс до внешнего действия, сразу после него и после записи checkpoint. Затем проверьте, что восстановление выбирает разные безопасные ветви. Отдельно повредите хеш, уберите ссылку на артефакт, подайте неподдерживаемую схему и измените доступные права. В каждом случае система должна либо доказуемо продолжить, либо удержать задачу с конкретной причиной.
Повторная загрузка одного checkpoint даёт одинаковое принятое состояние.
Завершённый внешний эффект не выполняется второй раз.
Неизвестный эффект не помечается автоматически как неуспешный.
Повреждённая запись не используется для продолжения.
Устаревшие права перепроверяются перед следующим действием.
Миграция не выдумывает отсутствующие значения.
Новая контрольная точка ссылается на родителя и не меняет его.
Если работу продолжает другой исполнитель, checkpoint становится основанием для передачи задачи другому агенту. Передача добавляет нового владельца, срок и критерии приёмки, но принятые данные и сведения о внешних эффектах остаются теми же.
Практический итог
Хорошая контрольная точка мала, но самодостаточна для проверки. Она хранит идентификаторы задачи и схемы, последний принятый шаг, подтверждённые данные, неизвестное, совершённые внешние эффекты, одно следующее действие, требования к правам и проверку целостности. Этого достаточно, чтобы продолжить задачу без реконструкции состояния из чата и без слепого повторения действий.
Идентификаторы и сценарии вымышлены. Они иллюстрируют структуру контрольной точки; результатов испытаний конкретного агента или механизма восстановления здесь нет.