Игорь Градов
Игорь Градов
5 мин
ai

Что такое ИИ-агент, объяснил создатель шутера: модель плюс харнес и 8 шагов настройки

Разработчик, собравший с помощью ИИ онлайн-шутер, разобрал на своём проекте харнес, программную обвязку, которая превращает Claude Code или Codex в рабочего ИИ-агента. Сам термин закрепился лишь в начале 2026 года.

Что такое ИИ-агент, объяснил создатель шутера: модель плюс харнес и 8 шагов настройки
Почему это важно

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

Раньше большая языковая модель (LLM, программа, которая получает текст и выдаёт текст) работала как собеседник в чате. Затем к ней добавили инструменты, память и проверки, и из этой обвязки вырос харнес (harness). Автор технического разбора, который до этого описал онлайн-шутер, созданный с помощью ИИ, объясняет, как настроить такую обвязку под свой проект, если код вы сами не пишете.

Что такое ИИ-агент на практике?

Формула автора короткая: агент равен модели плюс харнес. Модель рассуждает, обвязка делает остальное: крутит рабочий цикл, запускает инструменты, хранит память и проверяет результат. Термин закрепился после текстов Митчелла Хашимото из HashiCorp, отчёта OpenAI о Codex и статей LangChain.

Из чего состоит харнес:

  • Цикл. Вызывает модель, пока задача не решена или не исчерпан лимит.
  • Инструменты. Принимают от модели запрос на действие и запускают нужный код.
  • Контекст. Собирает промпт для модели со всеми инструкциями.
  • Ограничения. Роли и бюджеты токенов (токен, кусочек слова, в которых считают объём текста для модели).
  • Проверки. Оценка ответа другой моделью в роли судьи и защитные фильтры.

Свой харнес есть у крупных игроков: у Anthropic это Claude Code, у OpenAI это Codex. Даже обычная загрузка файла в чат скрывает цепочку шагов. Файл нужно сохранить, распознать в нём текст, положить в хранилище и проверить, помещается ли он в память диалога.

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

Что понадобится?

  • Доступ к Claude Code или Codex.
  • Проект, собранный в одном хранилище кода.
  • Умение создавать текстовые файлы в формате Markdown (простая разметка для текста).
  • По желанию: GitHub, если хотите, чтобы код проверялся автоматически перед выпуском.

Сколько времени уйдёт на настройку, автор не называет.

Как настроить харнес на своём проекте за 8 шагов?

Структура папки с документами у автора в упрощённом виде выглядит так:

docs
|_ general.md
|_ tasks
|_ _ feature_1.md
|_ _ feature_N.md
|_ arhitechture.md
  1. Создайте файл инструкций claude.md или agents.md: так он называется в разных агентах. Агент добавляет его содержимое в промпт при каждом вашем сообщении.
  2. Впишите туда базовые правила, которые агент не должен забывать.
  3. Заведите папку docs и главный файл general.md со ссылками на остальные документы, например «фича 1, не реализовано, лежит тут».
  4. Под каждую задачу создайте отдельный небольшой файл в папке tasks. Мелкие файлы отодвигают момент, когда память диалога переполнится.
  5. В claude.md укажите, что любую задачу агент начинает с чтения general.md.
  6. Ставьте задачу через уточняющую сессию, где агент сам расспрашивает вас о деталях. Автор пользуется для этого плагином Мэтта Покока.
  7. Пропишите конвейер: агент пишет код и тесты, поднимает версию, ведёт журнал изменений, запускает проверки и отправляет результат на согласование.
  8. Последнее решение оставьте себе: у автора выпуск в работу запускает только человек.
Как это применить

Автор показывает механику на простом примере. В claude.md он вписал правило «Всегда начинай ответ с !», написал агенту «Привет» и получил «!Привет, чем могу помочь?». Правило из файла сработало без напоминаний. В его игровом проекте после правок игровых механик агент сам запускает тестовые матчи, куда заходят боты с заданными сценариями, и только после успешных проверок отправляет код на согласование.

Частые ошибки
  • Затянутый диалог. По опыту автора, после заполнения 60% памяти диалога внимание модели теряется: откройте новый чат или сожмите историю.
  • Один огромный файл задачи. Он быстро съедает память, дробите задачи.
  • Нет общего словаря. Термины вроде «агент» трактуют по-разному, поэтому проекту нужен глоссарий.
  • Поиск единственно верного конвейера. Его нет: где-то важнее скорость прототипа, где-то дополнительные проверки.

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

Автору Дзена. Если вы пишете с помощью Claude или Codex, вынесите постоянные требования к стилю и рубрикам в один файл инструкций. Тогда не придётся повторять их в каждом промпте.

Маркетологу. Схема «агент делает, проверки отсеивают, человек утверждает» переносится на любой поток контента. Пропишите проверки до того, как материал попадёт к вам на согласование.

Предпринимателю в РФ и СНГ. Вопрос доступа к Claude Code и Codex из России источник не обсуждает. Из доступных в РФ аналогов есть YandexGPT и GigaChat, но готового разбора харнеса под них автор не даёт.

Совет редакции dzen.guru

На мой взгляд, самое ценное в разборе даже не конвейер, а папка docs с короткими файлами. Этот приём я бы перенёс и на работу с текстами: один файл на рубрику, один на голос канала. Честная оговорка: автор описывает разработку программ, а применение к контенту, это моя экстраполяция, проверяйте на своих задачах.

Начните с одного файла инструкций сегодня, а конвейер достраивайте, когда агент начнёт ошибаться в одном и том же месте.

Соберите свой набор промптов для канала

Инструменты dzen.guru помогут оформить постоянные инструкции для нейросети под ваш канал на Дзене.

Попробовать
Поделиться:TelegramVK
Игорь Градов
Игорь Градов

Основатель dzen.guru. Эксперт по монетизации и продвижению на Дзен. Автор курса «Старт на Дзен 2026».

Комментарии

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

Понятие «технологии искусственного интеллекта» в нормативных актах РФ свели к перечню без сути
ai

Понятие «технологии искусственного интеллекта» в нормативных актах РФ свели к перечню без сути

Юридический разбор показывает, что с февраля 2024 года, на фоне превращения ИИ в регулируемую область, понятие «технологии искусственного интеллекта» в…

5 мин
Автор удвоил словарь ударений через GigaChat: 101 слово для озвучки без ручных догадок
ai

Автор удвоил словарь ударений через GigaChat: 101 слово для озвучки без ручных догадок

Автор озвучки «Канала 15» удвоил словарь русских ударений с помощью двух бесплатных моделей Сбера, потому что три движка синтеза речи упорно ставили ударения…

4 мин
ai

ПСБ проведёт в Ярославле ИТ-конференцию «Нейродень»: как контролировать ИИ-агентов

ПСБ 28 ноября проведёт в Ярославле ИТ-конференцию «Нейродень» о работе с ИИ-агентами, и для местных разработчиков это шанс без поездки в столицу услышать…

4 мин