Контрольные точки

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

Как работают контрольные точки

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

• Создаются автоматически — никаких ручных действий не требуется.
• Не вмешиваются в историю Git. Хранение снимков осуществляется отдельным слоем сессии.
• Отслеживают, какие файлы были созданы или изменены, чтобы при восстановлении затронуть только нужные файлы.

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

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

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

Это та же панель, что описана в разделе Просмотр Изменений.

Восстановление к контрольной точке

Чтобы восстановить более раннее состояние разговора:

1. Найдите сообщение пользователя, к которому хотите вернуться.
2. Нажмите действие восстановления на этом сообщении.
3. Kodik перематывает историю разговора до этого сообщения, восстанавливает содержимое файлов из сохранённого снимка и очищает весь последующий контекст API.

После восстановления агент готов принять новое сообщение с этой точки. Можно отредактировать исходное сообщение перед повторной отправкой — см. Редактирование Сообщений.

Если данные снимка для конкретной контрольной точки недоступны (например, после сжатия контекста — см. Авто-Сжатие), история разговора всё равно перематывается, но файлы не восстанавливаются. В таком случае в журнал выводится предупреждение.

Связь с авто-подтверждением

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

Случаи использования

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