Claude Agent SDK — это пакет, позволяющий встроить собственный цикл агента Claude Code прямо в ваше приложение: поиск в Интернете, поиск по файлам, редактирование файлов, подключения к серверам MCP и многое другое — и все это без необходимости самостоятельно определять эти инструменты или управлять циклом агента. По умолчанию SDK также автоматически сохраняет стенограммы сеансов в локальной файловой системе. В Claude это называется Agent SessionStore.

Сегодня мы рады анонсировать адаптер MongoDB Claude SDK Session Adapter, доступный для Python (версия для TypeScript появится в январе 2027 года).

Что такое Claude Agent SessionStore?

Но сначала давайте разберемся, что такое SessionStore на самом деле. Это точка расширения в Claude Agent SDK для сохранения сеанса агента за пределами машины, на которой он выполнялся. Настройте ее, и SDK будет зеркально отображать каждый шаг беседы и действие по мере работы агента, чтобы сеанс можно было возобновить ровно с того места, где он прервался, на любом экземпляре, имеющем доступ к этому хранилищу.

Это имеет наибольшее значение, когда агент перестает работать на отдельной постоянной машине. Допустим, команда развертывает своего агента Claude в виде функции Lambda, которую команды по всей компании могут вызывать как внутреннюю службу. Каждый вызов представляет собой одноразовый экземпляр; здесь нет локального диска для сохранения чего-либо между вызовами. Без SessionStore каждый запрос по умолчанию является безгосударственным (stateless); у агента нет памяти о том, что было раньше. При настроенном SessionStore любой вызов может продолжить полную историю сеанса, независимо от того, какой экземпляр обрабатывал последний шаг.

Эту проблему и решает адаптер MongoDB Session Adapter.

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

Адаптер MongoDB Claude SDK Session Adapter

Адаптер MongoDB Claude SDK Session Adapter предоставляет агентам Claude надежное хранилище сеансов: запись беседы и историю ее действий, что позволяет агенту возобновить работу ровно с того места, где она была прервана, будь то на том же ноутбуке, другом сервере или любом сервере в распределенном развертывании.

Адаптер помогает охватить три ключевые области:

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

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

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

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

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

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

Как это работает

Этот адаптер напрямую реализует интерфейс хранения сеансов Claude Agent SDK, поэтому вы можете зеркально копировать стенограммы сеансов в MongoDB с помощью всего нескольких строк в ClaudeAgentOptions:

Python

Фрагмент кода

Вот и все. Каждый сеанс, запущенный с этими параметрами, сохраняется в MongoDB и может быть возобновлен на разных машинах. Каждый агент выполняет запись локально; MongoDB делает беседу переносимой между экземплярами приложения.

Рисунок 1. Как адаптер позволяет получить доступ к стенограммам сеансов агентов, зеркально отраженным в MongoDB.