API-туториал · 2026-08-22

Добавление и удаление инструментов посреди разговора
Не роняя prompt cache

Mid-conversation tool changes (beta) от Anthropic позволяет Claude динамически менять набор инструментов в длинных задачах — вышло 07-24 вместе с Opus 5, одновременно поддержаны Opus 4.8 / Fable 5 / Mythos 5.

#mid-conversation-tool-changes#beta header#prompt cache#tool_use

Главное

2026-07-24

Дата релиза

Одна из двух бет, вышедших с Claude Opus 5, — проверяется в официальном анонсе.

4

Поддерживаемые модели

Opus 5, Opus 4.8, Fable 5, Mythos 5. Остальных пока нет.

tool_addition

Ключевой механизм (+ removal)

Блоки tool_addition / tool_removal добавляют и снимают инструменты посреди разговора, без перезапуска сессии.

Не слетает

Влияние на prompt cache

Цель дизайна ровно в том, что добавление/удаление инструментов не сбрасывает закешированный префикс — ключ к стоимости длинных задач.

Какую боль решает фича

Старая боль длинных агентов: в начале задачи вешаешь 50 инструментов и дальше платишь за них токены каждый ход, а они ещё и размывают внимание; или посреди работы нужен новый инструмент — и приходится перезапускать сессию, теряя весь контекст. Mid-conversation tool changes разрешает подгружать и снимать наборы инструментов на лету блоками tool_addition / tool_removal — контекст и prompt cache выживают.

Внедрение в экосистеме

Гид по миграции на Opus 5 от OpenRouter и документация Vercel AI SDK уже описывают бету; агентские фреймворки вроде openclaw подтянулись в конце июля. У сценариев с транзитным шлюзом есть известная яма: часть шлюзов теряет beta header или срезает блоки tool_addition — симптом: «модель делает вид, что не видит новый инструмент». Если столкнулись, сначала проверьте цепочку форвардинга.

Таймлайн

2026-04-07

Похожая, но другая бета: mid-conversation system-сообщения (не путать, header другой).

2026-07-24

Mid-conversation tool changes выходит вместе с Opus 5, header mid-conversation-tool-changes-2026-07-01.

2026-08

Основные SDK и шлюзы завершают адаптацию; проблемы транзитного форвардинга зафиксированы в нескольких GitHub issue.

Подтверждено vs с чем путают

Подтверждено

Имя beta header, четыре поддерживаемые модели, механизм tool_addition/tool_removal, несброс prompt cache — всё проверяется по официальному анонсу и документации основных SDK.

С чем путают

Не смешивайте с бетой mid-conversation system от 04-07 (вставка system-сообщений посреди разговора): это две независимые беты с разными header и разными задачами. В цепочке форвардинга убедитесь, что оба header пропускаются.

Нужна ли вам эта бета

Подходит

Длинные агенты, у которых набор инструментов меняется по фазам, а стоимость чувствительна к prompt cache — типично: многоэтапные миграции, помодульные рефакторинги.

Не нужна

Фиксированный набор инструментов и короткие сессии. Лишний beta header — лишний слой неопределённости в цепочке; не тяните его в простые задачи.

Как использовать

Добавьте заголовок запроса anthropic-beta: mid-conversation-tool-changes-2026-07-01; посреди разговора подгружайте новые инструменты блоками tool_addition и снимайте блоками tool_removal. Модель должна быть одной из Opus 5 / 4.8 / Fable 5 / Mythos 5. При работе через шлюз убедитесь, что header и новые блоки форвардятся.

В QCode

Маршруты Claude в QCode пропускают заголовок anthropic-beta, а все четыре поддерживаемые модели продаются по формуле «официальный прайс × сервисный коэффициент». Подключение идентично прямому: тот же ключ, тот же endpoint, header передаётся как обычно.

Частые вопросы

Что за beta header?

anthropic-beta: mid-conversation-tool-changes-2026-07-01. Добавьте в заголовок запроса — фича включена.

Какие модели поддерживаются?

Opus 5, Opus 4.8, Fable 5, Mythos 5. Остальные пока не поддерживаются.

Это не уронит prompt cache?

Нет — это и есть цель фичи: добавление/удаление инструментов не сбрасывает закешированный префикс. Если hit rate внезапно просел, сначала проверьте, не переписывает ли транзитное звено тело запроса.

Это то же самое, что mid-conversation system?

Нет. Та бета от 04-07 (вставка system-сообщений посреди разговора) имеет header mid-conversation-system-2026-04-07 и решает другую задачу.

За шлюзом модель не видит новые инструменты — что делать?

Типичный симптом известной ямы: часть шлюзов теряет beta header или срезает блоки tool_addition. Сначала воспроизведите прямым curl, потом разбирайте цепочку форвардинга по звеньям.

Можно ли бету в прод?

Официальные беты обычно достаточно стабильны для прода, но сначала проверьте на некритичных путях и следите за changelog на предмет выпуска в GA или изменений.

Источники

Официальный анонс Anthropic (2026-07-24, Claude Opus 5), гид OpenRouter по миграции на Opus 5, документация Vercel AI SDK, GitHub issues openclaw.

Экономия на длинных задачах начинается с кеша

QCode пропускает заголовок anthropic-beta — все четыре поддерживаемые модели доступны с тем же ключом.