Последние
Разработка

Контрольная точка ИИ-агента: как сохранить и восстановить задачу

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

В этом материале9 разделов
Четыре этапа контрольной точки ИИ-агента: состояние задачи, checkpoint, проверка и возобновление.
Редакционная схема PENROUZ NEWS. Продолжайте задачу из проверенного состояния, а не из пересказа диалога.PENROUZ NEWS

Сообщить об ошибке или предложить уточнение

Короткий ответ: сохраняйте принятое состояние, а не пересказ диалога

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

Сохранять весь диалог обычно недостаточно. Переписка смешивает инструкции, промежуточные догадки, сообщения инструментов и исправления. При восстановлении пришлось бы заново угадывать, какое утверждение стало рабочим фактом, а какое было отвергнуто. Контрольная точка отделяет подтверждённое состояние от истории рассуждения и прямо помечает открытые вопросы.

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

Что является контрольной точкой, а что — нет

Границы понятия

АртефактГлавный вопросПочему не заменяет 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 вывод только потому, что агент уверенно его сформулировал. Подтверждённым становится результат, прошедший заданную приёмку: инструмент вернул ожидаемую структуру, ссылка открывается, файл существует, действие получило квитанцию или человек явно согласовал решение. Неизвестное лучше оставить отдельным полем, чем превращать в правдоподобное значение.

Копируемый JSON-шаблон checkpoint

Минимальная JSON-запись состояния задачи
{
  "task_id": "doc-card-17",
  "checkpoint_id": "cp-003",
  "parent_checkpoint_id": "cp-002",
  "schema_version": 1,
  "status": "ready_for_next_step",
  "accepted_step": "source_card_loaded",
  "confirmed": {
    "source_ref": "artifact://card-17-v2",
    "title": "Учебная карточка документа"
  },
  "unknowns": [
    "нужно ли сокращать описание"
  ],
  "completed_effects": [
    {
      "operation_id": "read-card-17-v2",
      "kind": "read",
      "result_ref": "artifact://card-17-v2"
    }
  ],
  "next_action": {
    "kind": "draft_summary",
    "requires": [
      "source_ref_is_readable",
      "task_is_not_cancelled"
    ]
  },
  "permissions_snapshot": {
    "required": [
      "read_source",
      "write_draft"
    ]
  },
  "integrity": {
    "algorithm": "sha256",
    "value": "sha256_канонического_содержимого"
  }
}

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

Контрольная точка связана с памятью ИИ-агента, но не совпадает с ней. Память может хранить предпочтения, накопленные знания и рабочий контекст нескольких шагов. Checkpoint отвечает уже: в каком проверенном состоянии находится именно эта задача.

Когда создавать контрольную точку

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

  1. Выполните один ограниченный шаг и получите наблюдаемый результат.
  2. Проверьте результат по критериям шага: структура, целостность, происхождение и ограничения.
  3. Отделите подтверждённые данные от догадок и открытых вопросов.
  4. Зафиксируйте уже совершённые внешние эффекты вместе с идентификаторами операций.
  5. Сформулируйте одно следующее действие и условия, при которых его можно выполнять.
  6. Сериализуйте запись в каноническом порядке и вычислите проверку целостности.
  7. Сохраните новую запись, не переписывая предыдущую.

Не каждое внутреннее микродействие требует отдельного checkpoint. Слишком частые записи создают шум и усложняют восстановление. Выбирайте границы, где повтор шага дорог, заметен пользователю или может изменить внешний объект. Для чистого вычисления без побочного эффекта достаточно сохранить вход и принятый результат на ближайшей значимой границе.

Как продолжить задачу без повторения внешнего действия

Главный риск восстановления — повторить отправку, запись, оплату, публикацию или другое действие, которое могло завершиться до сбоя. Поэтому completed_effects хранит не фразу «готово», а идентификатор операции и ссылку на наблюдаемый результат. После загрузки checkpoint агент сначала проверяет этот результат во внешней системе. Лишь подтверждённое отсутствие эффекта позволяет решать, нужен ли повтор.

Если состояние внешней операции неизвестно, безопасный статус — unknown, а не failed. В таком состоянии агент не угадывает и не запускает действие заново автоматически. Он выполняет доступную проверку по идентификатору операции, запрашивает независимое подтверждение или удерживает задачу. Это сохраняет границу между отсутствием доказательства и доказанным отсутствием результата.

Проверка перед возобновлением

ПроверкаЕсли пройденаЕсли не пройдена
Схема поддерживаетсяПрочитать поляОстановить и выполнить явную миграцию
task_id совпадаетПродолжить эту задачуНе смешивать состояния
Хеш корректенДоверять целостности записиУдержать повреждённую запись
Ссылки доступныЗагрузить артефактыЗапросить восстановление основания
Права актуальныРазрешить следующий шагНе использовать старый снимок прав
Внешний эффект проверенНе повторять завершённоеОставить статус неизвестным до проверки
Возобновление — это последовательность проверок, а не безусловный запуск next_action.

Версии, миграции и неизменяемость

Схема checkpoint меняется отдельно от содержимого задачи. Поле schema_version говорит, как читать запись; parent_checkpoint_id связывает последовательные состояния. Старую контрольную точку не редактируют задним числом. Если обнаружена ошибка, создают новую запись с исправлением и объяснимой связью с родителем. Так можно восстановить, какое состояние действительно было доступно исполнителю.

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

Как проверить механизм восстановления

Тестируйте не только успешное чтение файла. Остановите учебный процесс до внешнего действия, сразу после него и после записи checkpoint. Затем проверьте, что восстановление выбирает разные безопасные ветви. Отдельно повредите хеш, уберите ссылку на артефакт, подайте неподдерживаемую схему и измените доступные права. В каждом случае система должна либо доказуемо продолжить, либо удержать задачу с конкретной причиной.

  • Повторная загрузка одного checkpoint даёт одинаковое принятое состояние.
  • Завершённый внешний эффект не выполняется второй раз.
  • Неизвестный эффект не помечается автоматически как неуспешный.
  • Повреждённая запись не используется для продолжения.
  • Устаревшие права перепроверяются перед следующим действием.
  • Миграция не выдумывает отсутствующие значения.
  • Новая контрольная точка ссылается на родителя и не меняет его.

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

Практический итог

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

Идентификаторы и сценарии вымышлены. Они иллюстрируют структуру контрольной точки; результатов испытаний конкретного агента или механизма восстановления здесь нет.

В этом материале

На этом устройстве

Сохранённые материалы