Что такое ИИ-агент на практике: 751 раз выполнил просьбу и ни разу подсказку «можешь»

Несколько месяцев команда kaeru строила память для агентов по ощущениям. Потом разработчики прочитали логи и сверили, как агенты пользуются памятью на деле. По словам авторов разбора, почти все выводы касаются агентов вообще, а не только их продукта.

Зачем агенту память и как устроена kaeru?

Если коротко отвечать на вопрос, что такое ИИ агент: это программа на основе языковой модели, которая сама выполняет шаги задачи. Она читает файлы, вызывает инструменты, пишет код и тексты. Слабое место известно всем, кто работает с агентами дольше недели: каждая сессия начинается с чистого листа.

Агент переспрашивает то, что вы объясняли вчера. Когда контекст (объём разговора, который модель держит в голове) переполняется и сжимается в пересказ, половина обсуждённого пропадает. Файл с правилами вроде CLAUDE.md (текстовые инструкции, которые Claude Code читает при старте) помогает, но его пишут руками, он только растёт и хранит «что», а не «почему».

kaeru работает как сервер на вашем компьютере. Агент подключается к нему по MCP, стандартному протоколу, через который Claude Code, Codex, Cursor и другие программы вызывают внешние инструменты. Агент сам пишет туда записи:

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

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

Ещё один инструмент, хуки. Это скрипты, которые Claude Code или Codex сам запускает в нужный момент: при старте сессии, перед передачей хода человеку, перед сжатием контекста.

Что понадобится для проверки?

• Claude Code, Codex или другой агент, к которому вы пишете инструкции.
• Ваш файл CLAUDE.md, системный промпт или собственный MCP-сервер.
• Логи нескольких своих рабочих сессий.
• Время, чтобы перечитать формулировки и найти в них слово «можешь».

Как переписать инструкции агенту по шагам?

1. Найдите подсказки-возможности. Всё, что звучит как «можешь посмотреть», «при желании прочитай», агент, судя по логам kaeru, вежливо пропускает.
2. Переформулируйте их в долг. Строка «2 записи под вопросом, ждут решения» в сводке kaeru 8 раз заставила агентов разобрать спорные записи. Просроченные задачи агенты тоже закрывали исправно.
3. Привязывайте просьбу к текущему действию. «Свяжи эту запись» приходила сразу после записи и продолжала то, что агент уже делал. В версии 0.8 связь указывается прямо в вызове записи, отдельная подсказка не нужна.
4. Поставьте проверку перед вопросом человеку. У одного пользователя 80% вопросов агента шли без обращения к памяти за предыдущие десять минут, медиана составила 74 минуты с последнего чтения. Хук kaeru перед передачей хода ищет в памяти ответ по теме и один раз отправляет агента прочитать.
5. Распознавайте вопрос шире знака «?». Из 2 608 остановок агента 1 164 были обращениями к человеку, а первая версия хука по знаку вопроса видела только 201 из них.

Пример инструкции-долга для CLAUDE.md:

Перед тем как задать мне вопрос, проверь память проекта по теме вопроса.
Записи с пометкой «под вопросом» ждут решения: разбери их до начала новой задачи.

Что делать с этим прямо сейчас, по ролям

Автору Дзена, который ведёт серию материалов с агентом: замените в своих инструкциях «можешь свериться с прошлыми статьями» на «перед новым текстом проверь список уже раскрытых тем». Так агент реже повторяет пройденное.

Маркетологу с длинными брифами для агента: ищите в них пожелания и превращайте их в обязательные шаги, привязанные к моменту работы. Пожелание без привязки, по данным разбора, агент просто пропускает.

Предпринимателю и разработчику MCP-сервера: проверьте, в какой момент ваш инструмент подсказывает агенту действие. Подсказка сразу после записи сработала 751 раз, подсказка на входе ни разу. Из доступных в РФ языковых моделей можно взять YandexGPT и GigaChat, принцип долга вместо возможности стоит проверить и на них.

Агент ведёт себя как занятой сотрудник: делает то, что висит в списке дел, и пропускает «загляни, если будет время». Пишите ему задачи, а не пожелания, и память начнёт работать.