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

Распространённый приём — попросить модель сформировать сводку в файл вроде HANDOFF.md и передать его следующему агенту. На практике это работает нестабильно: качество пересказа зависит от модели, часть деталей теряется, а на генерацию сводки уходят дополнительные токены. В результате новому агенту приходится заново объяснять задачу, что снижает скорость и повышает риск ошибок.

Ниже — практический подход: забрать живую сессию из локальных логов агента, а не пересказывать её, и передать эстафету другому инструменту или перенести работу на другой компьютер вместе с несохранёнными файлами.

Почему пересказ моделью — ненадёжный способ

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

Типичные проблемы при передаче через HANDOFF.md:

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

Надёжнее опираться на первичные данные — логи сессии, которые агент и так сохраняет локально.

Где искать логи сессии

Консольные ИИ-агенты обычно хранят историю взаимодействий в локальных файлах. Точное расположение зависит от инструмента, но общий принцип один: ищите каталог конфигурации или данных в домашней директории пользователя. Часто это скрытые папки вида .agent, .config или аналогичные, внутри — файлы с расширением .json, .jsonl или .log.

Шаги для поиска:

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

Если агент поддерживает экспорт сессии командой, используйте её — это надёжнее ручного поиска. Но и ручной поиск по логам работает, если понимать структуру.

Как извлечь контекст и передать его другому агенту

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

Практический порядок действий:

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

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

Перенос на другой компьютер вместе с файлами

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

Что включить в перенос:

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

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

Критерии проверки перед продолжением

Прежде чем продолжить работу у нового агента, убедитесь, что контекст передан корректно. Проверьте:

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

Если что-то не сходится, вернитесь к исходным логам и уточните передачу. Лучше потратить несколько минут на проверку, чем переделывать работу заново.

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