Тёмный круг в центре, вокруг кольцо со стрелкой по кругу, от кольца расходятся короткие лучи с квадратами, всё в большой рамкемодельправилаинструментыокружение

104

Что такое агент

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

Из чего состоит агент

Рабочее определение: агент = модель + правила + инструменты + окружение.

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

Модель это LLM, большая языковая модель в центре агента, например Claude Opus или GPT. Модель обучена на огромном объёме текстов и по запросу выдаёт самое вероятное продолжение. Без инструментов она не может создать файл, найти новость или запустить программу.

Модель и инструменты запускает одна программа. Её называют харнесом, от английского harness: это программа вокруг модели, которая даёт ей инструменты, правила и память. Claude Code, Codex, Hermes и даже сайт ChatGPT это разные харнесы. Модель внутри можно менять отдельно от харнеса.

Инструменты это веб-поиск, чтение и запись файлов, запуск команд, генерация картинок, управление компьютером. У одного харнеса их может быть около восьмидесяти, у другого почти ни одного. Когда агент «ищет в интернете», он вызывает инструмент поиска, а модель читает результат.

Правила это текстовые файлы в папке, где вы открыли агента. AGENTS.md харнес читает сам при каждом запуске, скилл агент берёт, когда он нужен задаче. Рядом лежат ваши рабочие файлы.

Окружение это место, где лежит папка и запущен харнес: ваш компьютер или сервер. Чем различается работа на сайте и на компьютере, разобрано в главе «Где работает агент».

Из чего состоит агент: модель и инструменты внутри харнеса, правила и файлы в окружении KB: concepts/agent Агент состоит из четырёх частей. Внешний контур это окружение: компьютер или сервер, где лежит папка агента. Сверху в папке лежат правила: AGENTS.md и скиллы. Харнес подаёт их модели при старте. Внутри окружения стоит харнес, программа вокруг модели: Codex, Claude Code. В харнесе две части: модель, которая только пишет текст, и инструменты: поиск, чтение файлов, команды. Модель вызывает инструмент текстом и получает результат обратно. Снизу лежат файлы папки: me.md, проекты, транскрипты. Инструменты читают их и пишут. ОКРУЖЕНИЕ · компьютер или сервер Правила AGENTS.md, скиллы ХАРНЕС · Codex, Claude Code Модель LLM: пишет только текст Инструменты поиск, чтение файлов, команды при старте вызов результат Файлы папки me.md, проекты, транскрипты читают и пишут
Модель и инструменты живут в харнесе, правила и файлы лежат в папке, где агент работает.

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

Один запрос от сообщения до ответа

Вы пишете агенту в терминале, в приложении или в Telegram. Из Telegram сообщение идёт через шлюз (gateway): эта программа связывает чат с сессией агента и потом отправляет ответ обратно. В терминале и в приложении вы пишете харнесу напрямую.

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

Один запрос к агенту: восемь шагов от сообщения до ответа KB: concepts/harness Восемь шагов сверху вниз. Сообщение из терминала, приложения или Telegram. Шлюз, только если вы пишете из мессенджера. Харнес добавляет правила, контекст и лимиты. Модель предлагает следующий шаг. Инструмент делает одну разрешённую операцию. Результат или отказ идёт модели. Модель продолжает или заканчивает. Если шаг нужен ещё один, стрелка ведёт обратно к модели. Если работа закончена, приходит ответ: текст вам, файл в папке. Сообщение Шлюз Харнес Модель Инструмент Результат Шаг или стоп Ответ терминал, приложение или Telegram только если пишете из мессенджера добавляет правила и лимиты предлагает следующий шаг делает одну разрешённую операцию данные или отказ идут модели модель продолжает или заканчивает текст вам, файл в папке 01 02 03 04 05 06 07 08 ещё шаг
Шаги с четвёртого по седьмой повторяются, пока модель не закончит работу или не сработает лимит. Шлюз нужен только агенту в мессенджере.

Ответ приходит вам текстом, а большой результат остаётся файлом в папке.

Как агент выполняет задачу

Задача «разбери папку загрузок» проходит по кругу. Модель получает задачу и просит инструментом список файлов. Харнес возвращает список, модель решает создать папки и снова вызывает инструмент. Затем проверяет результат и сама решает, когда задача закончена. Вызов инструмента модель пишет обычным текстом, а выполняет его харнес.

Это первый круг. Задачу агент в нём выполнил, а сам остался прежним. Поэтому ошибку, которую агент повторяет от запуска к запуску, первый круг не исправит.

Как агент выполняет задачу: рабочий круг модели и харнеса и второй круг, который обновляет инструкцию KB: concepts/agentic-loop Первый круг. Задача приходит модели. Модель решает, что делать дальше, и вызывает инструмент текстом. Харнес выполняет инструмент и возвращает результат модели. Круг повторяется, пока модель не решит, что задача закончена, и не отдаст результат. Сам агент в этом круге не учится. Второй круг. Харнес пишет журнал работы. Второй агент читает журнал и обновляет инструкцию или скилл. Обновлённый текст харнес подаёт модели при следующем запуске. ПЕРВЫЙ КРУГ Задача «разбери загрузки» Результат задача закончена Модель решает, что делать дальше Харнес выполняет инструмент готово вызов текстом результат ВТОРОЙ КРУГ Журнал работы что делал агент Второй агент читает журнал Инструкция или скилл обновлены при следующем запуске
Первый круг повторяется, пока модель не решит, что задача закончена. Второй круг меняет инструкцию на следующий запуск.

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

От харнеса зависят окружение агента, его инструменты и список моделей, поэтому харнес выбирают под свою повторяющуюся задачу. Следующая глава, «Харнесы», сравнивает харнесы программы: где каждый работает, сколько стоит и когда какой брать.