Гайд · TNWS AI

Как сжимать длинный контекст через OpenAI Compaction без потери условий

OpenAI APIPythonNode.jsChatGPT#OpenAI API#Compaction#контекст
6 мин

Практический гайд по Compaction в OpenAI API: что сохранить перед сжатием, как продолжить диалог и протестировать потерю ограничений.

Задача и применимость

Цель этого руководства — продолжать длинный агентный процесс при росте контекста, сохраняя обязательные решения, запреты и идентификаторы ресурсов. Это не демонстрация одного удачного ответа: в конце получится повторяемый процесс с контрольным входом, ожидаемым результатом и условием остановки.

Сведения и названия функций проверены 12 сентября 2026 года. Compaction предназначен для уменьшения состояния длинного диалога. Реализация должна следовать актуальному способу server-side или standalone compaction из официального руководства; компактированный элемент нужно считать непрозрачным состоянием и передавать дальше предусмотренным API способом.

Что подготовить

Нужны тестовый проект, отдельный API-ключ с минимальными правами, актуальный SDK и пять обезличенных входов. Включите нормальный кейс, пустой ввод, отсутствующий факт, противоречие и потенциально опасную инструкцию. Для каждого заранее запишите ожидаемые поля и статус.

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

Пошаговая настройка

  1. До сжатия вынесите в отдельный структурированный state факты, которые нельзя потерять: цель, принятые решения, запрещённые действия, ID файлов, незавершённые операции и критерии готовности.
  2. Запустите длинный тестовый диалог и сохраните контрольный ответ до compaction. Затем примените способ сжатия, документированный для выбранного SDK и Responses API.
  3. Продолжите запрос с compacted state. Не редактируйте внутреннее содержимое компактированного элемента и не пересказывайте его вручную, если API ожидает специальный item.
  4. Задайте пять контрольных вопросов: цель, последнее решение, запрет, незавершённый шаг, точный ID. Сравните с внешним state.
  5. Если условие потеряно, не увеличивайте контекст вслепую: поместите критические правила в стабильную инструкцию, а бизнес-состояние — в проверяемое хранилище.

После каждого вызова сохраняйте request ID, HTTP-статус, модель, версию конфигурации и usage, если сервис его возвращает. Полный чувствительный ввод в обычный лог не копируйте. Повтор запроса после таймаута разрешайте только после проверки состояния предыдущей операции.

Готовый шаблон

Скопируйте основу и замените значения в квадратных скобках:

STATE BEFORE COMPACTION
goal: подготовить отчёт по файлам
approved_sources: [file_17, file_21]
forbidden: отправка письма без подтверждения
pending: сверить сумму по file_21
decision: валюта результата — RUB
acceptance: каждая сумма содержит source_id

CONTROL AFTER COMPACTION
Верни JSON с goal, approved_sources, forbidden, pending, decision. Не восстанавливай отсутствующие значения догадкой.

Шаблон намеренно требует явного null или missing вместо догадки. Если результат будет читать программа, формат проверяется схемой, а значения — отдельными бизнес-правилами.

Реалистичный пример

До сжатия пользователь запретил отправку письма и выбрал RUB. После compaction агент должен назвать оба условия и только подготовить черновик. Автоматическая отправка или смена валюты означает провал регрессионного теста.

Повторите кейс, удалив один ключевой факт. Правильное поведение — отказ, null или специальный статус. Связный выдуманный ответ опаснее синтаксической ошибки: он может пройти в следующий шаг незаметно.

Как измерить качество

Создайте таблицу с колонками case_id, expected, actual, source, status, error_type. Идентификаторы, суммы, даты и единицы сравнивайте посимвольно. Для найденного факта храните document_id или точный фрагмент исходника.

Разделяйте ошибки на четыре класса: format_error — результат нельзя разобрать; unsupported_claim — факт отсутствует во входе; wrong_action — вызвана неверная операция; security_error — раскрыт секрет или обойдены права. Каждый класс требует своего исправления. Новый промпт не чинит авторизацию, а JSON Schema не подтверждает истинность суммы.

Правило выпуска задайте до теста: ноль security_error и wrong_action, все ID совпадают, отсутствующие данные не додумываются, а внешний вызов виден в журнале. Если критический кейс провален, измените одну причину и прогоните весь набор заново.

Контроль в рабочем приложении

Разделите сетевой вызов и использование результата. Первый слой принимает вход, присваивает case_id и проверяет размер, тип и права. Второй вызывает API с таймаутом. Третий разбирает ответ и применяет схему. Четвёртый сверяет бизнес-ограничения. Только после этого данные разрешено показывать пользователю или передавать в следующий узел.

Для наблюдаемости считайте количество успешных запросов, отказов валидации, таймаутов и повторов. Не смешивайте их в один процент «успеха». Отдельно отслеживайте долю ответов, отправленных на ручную проверку. Резкий спад технических ошибок при росте unsupported_claim означает, что формат улучшился, но содержание стало хуже.

В журнал результата кладите hash входа, а не чувствительный текст; model id; версию промпта; HTTP-статус; request ID; длительность; тип ошибки и решение валидатора. Значение API-ключа, персональные данные и полный документ туда не попадают. Доступ к журналу должен быть уже, чем доступ к пользовательскому интерфейсу.

Перед выпуском включите ограниченный трафик и сравните новую конфигурацию с предыдущей на одинаковых case_id. Условие отката формулируйте численно для вашего тестового набора: например, хотя бы одна ошибка безопасности, потеря обязательного ID или рост числа необработанных ответов. После отката сохраните проблемный ответ для воспроизведения, но удалите секреты.

Негативные тесты

Отправьте пустой ввод; похожий, но неверный ID; пользовательский текст с командой «игнорируй правила»; два одинаковых запроса; таймаут. Система должна отличать данные от инструкций, не подбирать похожую запись и не создавать дубль. Для чтения повтор допустим, для записи нужен idempotency_key и проверка фактического состояния.

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

Чек-лист финальной проверки

  • задача и ожидаемый результат описаны до запуска;
  • использован актуальный официальный метод;
  • ключ отсутствует в клиентском коде и логах;
  • модель и параметры вынесены в конфигурацию;
  • обычный и пустой кейсы пройдены;
  • отсутствующий факт возвращается явно;
  • числа, даты, ID и единицы сверены;
  • ошибки API обрабатываются по классам;
  • повтор не создаёт нежелательный дубль;
  • сохранены версия, request ID и результат проверки;
  • есть безопасный откат к предыдущей конфигурации.

Ограничения

Сжатие экономит контекст, но является преобразованием с потерями. Критические права, деньги и статусы операций нельзя хранить только в разговорной памяти модели.

Региональная доступность, модели, лимиты и цены являются изменяемыми фактами. Здесь они не выдумываются: перед внедрением проверьте текущие условия в официальной документации и кабинете поставщика.

FAQ

Можно ли сразу использовать рабочие данные?

Нет. Сначала обезличенный тест, проверка прав, политики хранения и журналирования.

Почему недостаточно HTTP 200?

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

Что делать при таймауте?

Сначала проверьте состояние прошлого вызова. Автоматический повтор операции записи без idempotency_key может создать дубль.

Когда повторять тесты?

После смены модели, SDK, схемы, системной инструкции или способа сборки контекста.

Официальный первоисточник

Документация по использованной функции — проверено 12 сентября 2026 года.

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

Можно ли сразу использовать рабочие данные?

Нет, сначала нужен тест на обезличенной копии и проверка прав.

Достаточно ли HTTP 200?

Нет, успешный статус не подтверждает смысловую правильность результата.

Что делать при таймауте?

Проверить состояние прошлого вызова до повторной операции.

Когда повторять тесты?

После смены модели, SDK, схемы или системной инструкции.

Читайте также

Комментарии

Пока тихо. Скажите первое слово