Контекст
Info
Контекст — это все, что агент видит в момент ответа: инструкции репозитория, ваши сообщения, прочитанные файлы, вывод команд и результаты работы инструментов. Он ограничен по размеру, и от того, что в нем лежит, напрямую зависит качество ответа.
Контекстное окно
Объем контекста измеряется в токенах и ограничен возможностями модели. Когда место заканчивается, агент не получает сообщение об ошибке — он просто перестает видеть часть работы и начинает действовать по неполной картине.
Больше всего места занимают, от самого расточительного к самому скромному:
- Вывод команд и результаты работы инструментов — особенно логи сборки и тестов.
- Прочитанные файлы целиком.
- История диалога.
- Постоянные инструкции:
AGENTS.mdи подключенные навыки.
В сессиях текущая заполненность контекста видна прямо в интерфейсе.
Сжатие диалога
Когда контекст близок к пределу, диалог сжимается автоматически: агент составляет краткое изложение предыдущей переписки и продолжает работу с ним вместо полной истории. В ленте появляются служебные события Контекст сжимается для продолжения диалога и Контекст сжат для продолжения диалога.
Сжатие можно запустить и вручную — в сессиях это команда /summarize. Это полезно перед крупным новым этапом работы в том же диалоге.
Что важно понимать: после сжатия агент помнит выводы, но не дословную переписку. Договоренность, упомянутая один раз и мимоходом, может не пережить сжатие. Если решение важно — зафиксируйте его в файле: в AGENTS.md, в описании задачи или в документе плана.
Признаки переполненного контекста
- агент повторно читает файлы, которые уже читал;
- он возвращается к решениям, которые вы уже отклонили;
- ответы становятся общими, теряется специфика проекта;
- он «забывает» ограничение, названное в начале диалога.
Это не повод переформулировать запрос — это повод разгрузить контекст.
Приемы работы
- Новая задача — новый диалог. Не продолжайте в старой сессии работу, не связанную с предыдущей: вся ее история продолжит расходовать контекст.
- Объемный поиск — субагенту. Пусть исследование репозитория идет в отдельном контексте и возвращает вывод, а не содержимое файлов. См. Агенты и субагенты.
- Важное — в файл, а не в переписку. План, критерии приемки и принятые решения переживут сжатие только в виде файла.
- Инструкции — короткие.
AGENTS.mdпопадает в контекст всегда, поэтому в нем должно быть только то, о чем агент ошибется без подсказки. Процедуры выносите в навыки: их текст подключается лишь тогда, когда навык нужен. - Не просите прочитать все. Формулировка «изучи весь репозиторий» тратит контекст и почти никогда не улучшает результат. Назовите область.
- Ограничивайте вывод команд. Просите фильтровать логи и показывать только значимые строки: полный вывод сборки вытесняет из контекста саму задачу.
Что дальше
- Посмотрите, какими инструментами агент пользуется и как это подтверждается, — Инструменты и MCP.
- Вернитесь к циклу работы с агентом: большинство проблем с контекстом снимается тем, что задача правильно ограничена на шаге плана.