Как работает ИИ-агент простыми словами: харнесс, контекст и память

Что такое ИИ-агент простыми словами

Представь, что ты нанял гениального повара. Тысячи рецептов в голове, готовит что угодно, пашет круглые сутки. Один нюанс: стоит он с завязанными глазами посреди пустой комнаты. Ни плиты, ни ножа, ни холодильника. И стоит тебе выйти за дверь - забывает вообще всё.

Этот повар - модель (Claude, GPT и компания). А кухня вокруг: плита, ножи, рецепты на стене, правило «не суй руку в огонь» - это харнесс Харнесс (от англ. harness - «упряжь, обвязка») - это вся обвязка вокруг модели: инструменты, которые ей дают, формат, в котором она видит результат, правила и память. Модель одна и та же, а харнесс у всех разный. . ИИ-агент = повар плюс кухня. Не что-то одно, а оба сразу.

Зачем вайбкодеру понимать, как думает агент

Ты вайбкодер. Руками код писать не обязан. Но как только врубаешься, как ИИ-агент думает, меняется вот что:

• злишься меньше, а чинишь причину, а не симптом;
• экономишь деньги - за «думанье» ты платишь токенами, скоро объясню;
• получаешь результат с первого-второго захода, а не с десятого;
• ставишь задачу так, что агент не «плывёт» на полпути.

«ИИ написал мне кривой сайт» против «ИИ написал мне рабочий сайт» - чаще всего это разница в понимании трёх штук: контекст, токены, память. С них и начнём.

Три кита: контекст, токены и память

Контекст - рабочий стол ИИ-агента

Памяти как у человека у агента нет. Есть контекстное окно Контекст (контекстное окно) - это весь текст, который модель «видит» прямо сейчас: твои сообщения, файлы, результаты команд, инструкции. Всё, что не влезло или вылетело - для модели не существует. - считай, рабочий стол. На стол влезает ограниченное число «бумажек»: задача, куски кода, ответы команд, инструкции.

Лежит нужное на столе - агент умница. Завалил стол хламом (старые сообщения, простыни логов, пять версий одного файла) - и повару буквально некуда положить нож. Тут он и начинает терять нить, путать детали, галлюцинировать.

Токены - валюта, которой ты платишь за стол

Каждая «бумажка» на столе стоит денег. Текст для модели режется на токены Токен - кусочек текста, примерно 3-4 символа или ¾ слова. Модель и читает, и пишет токенами. И за входные (что ты дал), и за выходные (что она сгенерила) токены ты платишь. . Больше текста даёшь, длиннее ответы просишь - больше токенов. А значит, дороже и медленнее.

Поэтому матёрые вайбкодеры весь проект в чат не суют. Дают ссылку на файл, нужный фрагмент - или просят агента самого найти, что надо. И платят за это копейки вместо рубля.

Память: короткая и долгая

Вот тут новичок и попадается. У агента два вида памяти, и их легко перепутать:

• Короткая (рабочая) - это и есть контекст, тот самый стол. Живёт ровно одну сессию. Закрыл чат или словил «компакт» - всё стёрлось.
• Долгая - это файлы на диске. Заметки, MEMORY.md, правила проекта. В голове модель между запусками не держит ничего: она каждый раз перечитывает файлы заново.

Компакт: когда чистить контекст

Стол переполнился - случается компакт Компакт (compact) - сжатие истории разговора: агент сворачивает старое в краткую выжимку, чтобы освободить место. Полезно, но при этом теряются детали. : агент сворачивает старую переписку в короткую выжимку. Место освободилось - но детали ушли. Как смахнуть всё со стола в папку «разное»: место есть, а найти нужное теперь морока.

Весь фокус в том, когда это делать:

Хороший и плохой харнесс

Харнесс - это кухня. Вот как на глаз отличить удобную от кошмарной. Пригодится, когда дойдёшь до подключения инструментов - MCP, скиллов и прочего (это в следующих главах).

Память ИИ: что помогает, а что мешает

Пример из жизни: почему агент сломал рабочий лендинг

Просишь: «сделай мне лендинг кофейни». Агент бодро стартует, генерит 12 файлов. Ты по ходу 40 раз правишь: «кнопку левее», «шрифт другой», «нет, верни как было». А через час он внезапно ломает то, что отлично работало в начале. И ещё спорит, что «так и было».

Что случилось на самом деле:

1. Стол завалили сорока правками и десятком версий файлов.
2. Прилетел компакт - и агент забыл, как выглядел рабочий вариант.
3. Правило «шрифт - Fraunces» жило только в чате и стёрлось вместе с историей.

А вот как тот же запрос дал бы человек, который понимает кухню:

Сделай лендинг кофейни. Прежде чем писать код:

Запиши ключевые требования в файл DECISIONS.md (шрифт Fraunces,
палитра teal, одна страница, кнопка заказа сверху). Сверяйся с ним.
Работай по одному блоку за раз: герой, меню, контакты.
После каждого блока показывай результат и жди моего «ок».
Не переписывай уже одобренные блоки без моего разрешения.
Если история переполняется - делай компакт ТОЛЬКО после
готового блока, не в середине.

Агент затупил? Мини-диагностика

Прежде чем бить тревогу, пробеги по чек-листу (это, по сути, скилл agent-introspection-debugging):

1. Стол не завален? Разговор длинный, агент путается - почисти или начни заново.
2. Контекст не потерян? Возможно, важное стёр компакт - повтори ключевые требования.
3. Правило точно в файле? Сказал один раз в чате - не считается.
4. Инструмент не молчит? Агент ходит по кругу - может, команда падает, а ошибки он не видит.
5. Задача не великовата? Режь её на куски по пятнадцать минут работы.

Частые ошибки новичков в вайбкодинге

• Вываливать весь проект в чат. Дорого и забивает стол. Давай нужный кусок.
• Держать правила только в переписке. После перезапуска их нет. Выноси в файлы.
• Гнать одну гигантскую задачу. Агент захлёбывается. Режь на куски.
• Чистить контекст посреди отладки. Потеряешь ровно то, что искал.
• Не смотреть на токены. «Бесконечный» чат однажды приходит со счётом, от которого ёкает сердце.
• Спорить с агентом вместо перезапуска. Иногда дешевле начать сессию с чистого стола.