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