Claude Agent Memory API получает собственный бета-трек: что означает миграция header 22 июля для операторов

Anthropic Python SDK v0.116.0 вышел 2 июля с одним feature-коммитом, который касается всех операторов, использующих Claude Managed Agents Memory Stores: API Memory Stores переходит на выделенный бета-header agent-memory-2026-07-22, заменяя managed-agents-2026-04-01, который отвечал за все операции с памятью с апреля 2026 года.

Это не предупреждение об устаревании. Это миграция header с конкретным дедлайном, зашитым в строку версии.

Что произошло

Коммит в SDK обновляет заголовок anthropic-beta, который инжектируется каждым методом в client.beta.memory_stores.memories — create, retrieve, update и list — с managed-agents-2026-04-01 на agent-memory-2026-07-22. Затронутая поверхность — CRUD-путь Memory Stores (/v1/memory_stores/{memory_store_id}/memories); создание сессий и операции с сессиями остаются под managed-agents-2026-04-01.

В том же изменении удаляются два параметра запроса для endpoint list: order и order_by. Любая интеграция, передающая эти параметры, получит ошибку 400 после вступления в силу нового header.

Если вы используете официальный Python SDK и обновитесь до v0.116.0 или выше, SDK автоматически инжектирует новый header. Изменения кода не требуются — достаточно обновить пакет и проверить версионные pin.

Если вы обращаетесь к Memory Stores API напрямую через HTTP (curl, кастомные клиенты, SDK не на Python), вам нужно вручную обновить заголовок anthropic-beta до даты активации 22 июля.

Почему это важно для инженерных команд

Функция memory stores была запущена в апреле 2026 года под общим флагом managed-agents-2026-04-01, который всегда был удобным агрегатором для нескольких in-beta API-поверхностей agent-платформы. Перевод Memory Stores на собственный бета-трек сигнализирует, что Anthropic рассматривает её как стабильную, независимо версионированную API-поверхность.

Для команд, работающих с production-агентами, практические последствия таковы:

Кросс-сессионная персистентность становится API первого класса. Перевод Memory Stores на собственный бета-header — это способ Anthropic дать понять, что речь идёт не об эксперименте. Memory stores — это коллекции текстовых документов в рамках workspace, которые монтируются как директория в sandbox сессии агента, позволяя ему переносить между сессиями пользовательские предпочтения, соглашения проекта, допущенные ошибки и контекст предметной области. Операторы могут строить на этом рабочие процессы с большей уверенностью в стабильности API.

Управление header становится более гранулярным. Теперь можно независимо подключаться к операциям с памятью, не затрагивая общую поверхность managed-agents. Это важно для команд, которые хотят ограничить beta-экспозицию: если вы используете только Memory Stores, можно отправлять agent-memory-2026-07-22 без обязательной зависимости от managed-agents-2026-04-01 для вызовов памяти.

Упрощение endpoint list убирает гибкость сортировки. Удаление параметров order и order_by из листинга памяти означает, что memory будут возвращаться в естественном порядке хранилища. Если ваши agent-инструменты или панель управления памятью сортировали записи по кастомному полю — после 22 июля придётся делать сортировку на клиентской стороне.

Угол router/operator

Для команд, маршрутизирующих agent-трафик через gateway или строящих многоагентные системы, миграция Memory Stores демонстрирует паттерн, который будет повторяться: бета-headers Anthropic — это версионирование API под другим названием. Каждый флаг anthropic-beta по сути является версионным контрактом поверхности, и когда поверхность переходит на собственный header, старый общий флаг перестаёт быть авторитетным для этого пути.

Операторам следует строить SDK-обёртки и конфигурации gateway с явной обработкой маршрутизации header, а не полагаться на значения по умолчанию SDK. Корректный паттерн:

• Создание сессий и операции с ними: managed-agents-2026-04-01
• Memory Stores CRUD (после 22 июля): agent-memory-2026-07-22
• Исследовательский preview Dreams: dreaming-2026-04-21 (дополнительно, вместе с managed-agents header)

Если ваш gateway проксирует вызовы Claude API и инжектирует бета-headers на уровне запроса, а не через SDK, — сейчас самое время проверить логику инжекции header. Прокси, который добавляет managed-agents-2026-04-01 на все пути /v1/memory_stores/, скорее всего получит ошибки 4xx после активации нового требования.

Для команд, использующих Python или TypeScript SDK с автоматическим управлением header, единственный операционный риск — устаревший pin версии SDK. Если вы остаётесь на anthropic<0.116.0, а 22 июля наступает, операции с memory store будут отправлять старый header и завершаться ошибкой. Явно пропишите >=0.116.0 в зависимостях.

Что нужно проверить операторам до 22 июля

Три целенаправленных шага до дедлайна:

1. Найдите в кодовой базе все вхождения managed-agents-2026-04-01 — в заголовках запросов, конфигах, middleware gateway и обёртках API. Любая ссылка, управляющая вызовами /v1/memory_stores/, должна быть обновлена до agent-memory-2026-07-22.

2. Проверьте pin-версии SDK. Если используете официальный Python SDK, обновитесь до >=0.116.0 и убедитесь, что ваш параметр anthropic-beta не переопределяет header вручную для вызовов памяти (иначе логика слияния SDK отправит оба флага одновременно).

3. Проверьте потребителей endpoint list. Удалите параметры order и order_by из вызовов GET /v1/memory_stores/{id}/memories — серверная сторона убирает эти параметры, и их передача после дедлайна вызовет ошибки валидации.

Команды, строящие stateful многоагентные рабочие процессы на Memory Stores Anthropic — где каждая сессия агента наследует предзаполненный контекст, пользовательские предпочтения или соглашения проекта — имеют 19 дней для тестирования и валидации. Не откладывайте до 22 июля.

Что стоит проверить пользователям TheRouter

Если вы маршрутизируете Anthropic-совместимые запросы через TheRouter и ваши агенты используют Managed Agents Memory Stores API, проверьте, инжектирует ли уровень маршрутизации или удаляет кастомные заголовки anthropic-beta. TheRouter прозрачно передаёт специфичные для провайдера заголовки на прямые endpoint Anthropic; если ваша интеграция полагается на такое проксирование, после обновления зависимостей убедитесь, что обновлённый header корректно доходит до Anthropic API. Обратитесь к документации TheRouter для настройки Anthropic provider и поведения при передаче header.