Обзор сжатия
Узнайте, что делает сжатие, чем сжатие по запросу отличается от сжатия при достижении порога токенов и какая страница описывает вашу задачу.
Сжатие заменяет более старые ходы разговора сводкой, которую Claude пишет на сервере, поэтому вам не нужен собственный код суммаризации. Оно удерживает длинный разговор или задачу агента в пределах «context window» (контекстного окна) и сохраняет активный контекст небольшим, потому что качество ответов ухудшается по мере роста разговора.
Если вы хотите пропустить этот обзор, начните со страницы Сжатие по запросу, чтобы добавить сжатие в ваше приложение. Хотя и оно, и Сжатие контекста при достижении порога токенов находятся в бета-версии, сжатие по запросу охватывает больше распространённых сценариев использования. Чтобы удалять старые результаты инструментов или старые блоки размышлений по правилу, а не суммаризировать их, см. Редактирование контекста.
Выбор способа сжатия
Используйте сжатие по запросу везде, где оно доступно.
| Сжатие по запросу | Сжатие контекста при достижении порога токенов | Ваш собственный суммаризатор | |
|---|---|---|---|
| Кто решает, когда | Вы, отправляя запрос | API, когда входные токены достигают заданного вами порога | Вы |
| Код, который вы пишете | Цикл сжатия, который запрашивает сводку и подставляет её | Один параметр в ваших обычных запросах | Вызов суммаризации, его подсказку и перезапись истории |
| Что вы отправляете обратно после этого | Возвращённый блок первым в messages вместо сообщений, которые он обобщает | Ответ, добавленный как обычно. API отбрасывает всё, что было до блока | Вашу сводку в виде вашего собственного сообщения |
| Последние ходы сохраняются дословно | Да: Сжатие с сохранением последних ходов | Да, с помощью паузы после сжатия и их повторной вставки | Да |
| Выполняется в фоновом режиме | Да: Сжатие в фоновом режиме | Нет: оно выполняется внутри запроса, который достигает порога | Да, в вашем собственном коде |
| Сохранённые ходы сохраняют свои размышления, на моделях с «preserved thinking» (сохранёнными размышлениями) | Да, при условиях, описанных на странице Сжатие и сохранённые размышления | Нет: удалите размышления из ходов, которые вы вставляете повторно, или позвольте API отбросить их с помощью prefix_mismatch_behavior: "drop_block" (см. примеры сжатия по порогу) | Нет: такие размышления не проходят проверку префикса |
| Бета-заголовок, параметр и платформы | compact-2026-09-04 и параметр верхнего уровня compaction. Платформы: см. раздел о поддержке API для сжатия по запросу | См. раздел о поддержке API для сжатия по порогу и Базовое использование | Нет. Выполняется в вашем коде |
| Выбирайте, когда | Вашему приложению нужно управлять моментом сжатия, оно не может приостанавливаться на время написания сводки или должно сохранять последние ходы и их размышления | Вы хотите, чтобы API управлял контекстом внутри обычных запросов | Вы уже используете собственный суммаризатор, и он заменяет всю историю сводкой |
Варианты сжатия по запросу
На странице Сжатие по запросу показан цикл, который суммирует весь разговор, пока ваше приложение ждёт. Первые две страницы в этом списке изменяют то, как выполняется этот цикл, и вы можете их комбинировать. Третья нужна, если вы отправляете блоки размышлений обратно и используете любой из этих вариантов.
- Сжатие с сохранением последних ходов: когда последние несколько ходов должны достигать Claude дословно. Сводка охватывает только более старые ходы.
- Сжатие в фоновом режиме: когда разговор не может приостановиться ради сводки. Запрос выполняется, пока работа продолжается, и вы подставляете блок, когда он приходит.
- Сжатие и сохранённые размышления: если вы отправляете блоки размышлений обратно на модели с сохранёнными размышлениями и сохраняете недавние ходы или выполняете сжатие в фоновом режиме. В противном случае пропустите это.
- Написание собственной подсказки для обобщения: когда сводка по умолчанию отбрасывает что-то, что нужно более позднему ходу. Ваша подсказка заменяет подсказку по умолчанию.
- Повторное сжатие: когда разговор, который уже начинается с блока сжатия, снова становится длинным.
Найдите эти темы на других страницах:
- Запрос сводки описан на странице «Сжатие по запросу».
- Продолжение со сводки описано на странице «Сжатие по запросу». Условия, при которых размышления остаются действительными в сохраняемых вами ходах, описаны на странице Сжатие и сохранённые размышления.
- Когда сводка не возвращается: см. Обработка отсутствующей сводки или ошибки на странице «Сжатие по запросу».
- Как это сочетается с остальным API: см. Ограничения и взаимодействие с другими функциями на странице «Сжатие по запросу».
- Понимание использования: см. Подсчёт использования при сжатии для сжатия по запросу или Понимание использования для сжатия по порогу.
- Совместимость: у каждого вида есть собственный бета-заголовок, поэтому на каждой странице есть собственный раздел: Поддержка API для сжатия по запросу и Поддержка API для сжатия по порогу.
У сжатия по порогу есть своя страница: Сжатие контекста при достижении порога токенов.
Эта страница была полезной?