SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor · Обновлено 2026-11-08

Что такое агентная обвязка (agent harness) в LLM

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

Что такое агентная обвязка (agent harness)

Агентная обвязка — это программа, которая работает поверх языковой модели и превращает её в агента. Она содержит цикл, который постоянно вызывает модель, определения инструментов, доступных модели для вызова, правила разрешений, определяющие, какие из этих вызовов будут выполнены, состояние сессии, сохраняющееся между итерациями, и рабочую директорию, в которой происходят вычисления. Модель внутри этой обвязки можно заменить.

Последнее предложение — ключевое. Сама по себе модель отвечает на вопрос и забывает о вас. Обвязка спрашивает модель, что делать дальше, выполняет запрошенную моделью команду, возвращает результат и спрашивает снова. Именно это повторение люди имеют в виду, когда говорят «агент». Если терминология всё ещё кажется неясной, разница между AI-агентом, LLM и ассистентом поможет разобраться в понятиях, прежде чем вы выберете инструмент.

Инструментарий — это не модель

Эти понятия часто путают, так как поставщики выпускают их под одним брендом.

dsh и DeepSeek — это разные продукты. DeepSeek Harness, опубликованный по адресу github.com/deepseek-ai/deepseek-harness 13 августа 2026 года под лицензией MIT, представляет собой программу на Node, которую вы устанавливаете на машину. Модели DeepSeek — это веса, доступные через API (интерфейс прикладного программирования). Укажите dsh на модель от другого поставщика, и она продолжит работать, так как инструментарию нужно лишь то, что принимает сообщения и возвращает вызовы инструментов. Подробнее о том, чем DeepSeek Harness отличается от API DeepSeek, сколько стоят токены и в какие часы по Москве они обходятся вдвое дешевле, рассказано в отдельном разборе.

Claude Code и Claude — это такая же пара. Claude Code — это инструментарий: терминальная программа с циклом работы, системой разрешений, а также инструментами для работы с файлами и оболочкой. Claude — это семейство моделей, которые программа вызывает по умолчанию. Codex и Gemini CLI разделены таким же образом.

Вот тест, который всегда позволяет это определить. Вы устанавливаете инструментарий. Вы вызываете модель. Если у программы есть версия на вашем диске и конфигурационный файл в домашней директории, это инструментарий. Если это строка внутри такого конфигурационного файла, например deepseek-flash, то это модель.

Что на самом деле делает цикл

Один виток цикла обвязки (harness) выглядит следующим образом. Читайте внимательно, так как почти все различия между инструментами обвязки кроются именно в этих пяти шагах.

  1. Обвязка отправляет модели историю диалога вместе со списком определений инструментов.
  2. Модель отвечает текстом или запросом на вызов одного из этих инструментов.
  3. Обвязка проверяет этот запрос на соответствие правилам доступа и либо выполняет его, либо останавливается, чтобы спросить вас.
  4. Обвязка запускает инструмент, захватывает вывод и код завершения, а если вывод слишком длинный — обрезает его.
  5. Обвязка добавляет полученный результат в диалог и возвращается к шагу 1.

Шаг 3 — это то, чем инструменты обвязки чаще всего различаются в повседневной работе. Обвязка, которая запрашивает подтверждение перед каждой командой, безопасна, но утомительна. Обвязка, которая никогда не спрашивает, в конечном итоге выполнит деструктивную команду по пути, который модель определила неверно. Claude Code поддерживает промежуточный вариант: список разрешённых команд, которые выполняются без запроса, и запрос подтверждения для всех остальных команд.

Шаг 1 — это то, где кроются остальные различия. Обвязка также записывает системный промпт, который сопровождает каждый из этих запросов, и Claude Code предоставляет вам прямой доступ к этой настройке, поскольку стиль вывода изменяет системный промпт, который он отправляет, тем самым влияя на каждый последующий ответ. Диалог растёт с каждым витком, а у модели фиксированное контекстное окно, поэтому обвязка должна решать, что отбросить, что сократить, а что записать в файл и прочитать позже. Это решение — основная причина, по которой две разные обвязки, управляющие одной и той же моделью, выдают разное качество работы. Если эти пять шагов всё ещё кажутся абстрактными, лучше всего один раз написать простейший цикл самостоятельно, что как раз и предлагается сделать в пошаговом руководстве по изучению AI-агентов.

Большинство инструментов обвязки сейчас подключают внешние инструменты через MCP (model context protocol) — стандартный способ предоставления инструмента любой обвязке, поддерживающей этот протокол, поэтому одна интеграция работает с несколькими обвязками. В запуске MCP-серверов на VPS рассматривается эта сторона вопроса. Веб-поиск обычно является первым инструментом, который подключают пользователи, а настройка агента на ваш собственный экземпляр SearXNG позволяет избежать сторонних запросов, при этом чётко давая понять, что каждая страница, которую затем читает агент, является недоверенным вводом, поступающим внутрь цикла.

Агентский harness против агентского framework

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

Framework — это библиотека, которую вы импортируете. Вы собираете агента в коде, используя цикл framework или написав свой собственный. LangChain — известный пример: вы получаете строительные блоки и собираете агента программно.

Harness — это программа, которую вы запускаете. Цикл уже написан, инструменты уже существуют, модель разрешений имеет настройки по умолчанию. Вы получаете работающего агента после первой же команды и далее настраиваете его.

Тест на установку обычно расставляет всё по местам. Если вы устанавливаете продукт и затем пишете код — это framework. Если вы устанавливаете продукт и начинаете с ним взаимодействовать — это harness.

Граница между ними действительно спорная, и самое явное доказательство — документация самого LangChain. По состоянию на октябрь 2026 года она называет Deep Agents «агентским harness», а также «автономной библиотекой, построенной поверх основных строительных блоков LangChain для агентов», в то время как репозиторий langchain-ai/deepagents называет себя «агентским harness с набором готовых решений». Оба описания верны. Deep Agents — это Python SDK (software development kit), который вы импортируете, поэтому тест на установку классифицирует его как библиотеку, но он поставляется с достаточным количеством поведения по умолчанию, чтобы люди использовали его как harness. Microsoft объявила об общедоступности Hosted Agents в Foundry Agent Service 9 июля 2026 года, а в публикации от 22 июля 2026 года анонсировала выпуск Microsoft Agent Framework Harness, что показывает: этот термин стал категорией продукта, а не просто профессиональным жаргоном.

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

Чем harness отличается от окна чата

Окно чата и harness отображают результат работы модели. Разница заключается в том, на чьем компьютере выполняются вычисления. В окне чата любой код, запускаемый моделью, выполняется внутри изолированной среды (sandbox) поставщика услуг с использованием загруженных вами файлов. Harness запускает инструменты на той машине, где вы его активировали, от имени пользователя, который его запустил, работая с вашими реальными файлами и используя ваши реальные учетные данные в своей среде.

В этих двух предложениях заключены все преимущества и все риски. Агент наконец-то может выполнять работу. Агент также может эту работу удалить.

Инструменты-обвязки, которые реально используются

Этот список намеренно датирован 19 августа 2026 года. Категория развивается еженедельно, и любой обзор быстро устаревает.

  • Claude Code и Codex — это инструменты-обвязки от поставщиков. Они ориентированы на работу в терминале, по умолчанию привязаны к собственным моделям разработчика и обладают наиболее отлаженной системой управления правами доступа. В сравнении Claude Code, Cursor, Codex и Copilot они разобраны подробно.
  • DeepSeek Harness (dsh) распространяется по лицензии MIT и построен на одной идее: всё является плагином. Таким образом, модели, инструменты, сессии, изолированные среды (sandboxes) и пользовательский интерфейс — это взаимозаменяемые компоненты. Каждый установленный плагин работает с правами самого агента, поэтому проверка доступа плагина dsh перед его добавлением здесь важнее, чем в обвязках с фиксированным набором инструментов.
  • Hermes от Nous Research — это скорее агент общего назначения, чем инструмент для программирования. Он был выпущен под лицензией MIT в феврале 2026 года, а его встроенное хранилище работает локально: память и навыки хранятся в виде файлов в ~/.hermes, а история сессий — в локальной базе данных SQLite. Это перестаёт быть полной картиной, как только вы включаете одного из опциональных внешних провайдеров памяти, таких как Mem0 или Hindsight. По состоянию на октябрь 2026 года документация Hermes гласит, что активный провайдер получает каждый шаг диалога после каждого ответа, а также копию каждой записи во встроенную память, поэтому ваши данные в этом случае также хранятся у провайдера. Сравнение Hindsight и Mem0 стоит прочитать перед включением одного из них, а самостоятельный запуск Hermes на VPS описывает дальнейшие шаги.
  • Omnigent — это мета-обвязка: она управляет другими обвязками, включая Claude Code и Codex, через единый API с общими сессиями, лимитами расходов и изолированной средой на уровне операционной системы. Omnigent как мультиагентная обвязка описывает преимущества такого подхода.
  • OneCLI — это обвязка с изолированной средой, предназначенная для команд. Она построена вокруг шлюза, который внедряет учетные данные в исходящие запросы агента, поэтому сам агент никогда не видит реальные ключи.

Три из перечисленных инструментов часто оказываются в одном шорт-листе, поэтому стоит ознакомиться с сравнением DeepSeek Harness, Claude Code и Omnigent, где рассматриваются привязка к моделям, лицензии, зрелость и требования к запуску на сервере.

Быстрый старт dsh выполняется одной командой, и её однократный запуск — самый быстрый способ понять, что представляет собой обвязка. Для этого на машине должен быть установлен Node.js.

npx @deepseek-ai/dsh web

Эта команда запускает веб-интерфейс (user interface) по адресу http://127.0.0.1:3080. Прочитайте README, прежде чем полагаться на этот инструмент, так как dsh прямо описывает себя как предварительную версию для разработчиков (developer preview) и открыто предупреждает о возможных изменениях, нарушающих обратную совместимость. Если эта первая команда сразу завершается ошибкой или загружает не ту сборку, которую вы ожидали, фиксация точной версии dsh и очистка кэша npx обычно помогают решить проблему. Запуск DeepSeek Harness на VPS описывает установку на сервер, а почему этот адрес начинается с 127.0.0.1 объясняет использование loopback по умолчанию.

Маршрутизаторы располагаются над обвязкой

Модельный маршрутизатор — это локальный прокси между обвязкой и API провайдера. Claude Code Router является типичным примером: он по умолчанию привязывается к 127.0.0.1:3456, принимает запросы, которые Claude Code отправил бы своему поставщику, и перенаправляет их тому провайдеру, которого вы настроили. Обвязка не знает о том, что что-то изменилось.

Маршрутизаторы существуют, так как модель можно заменить, поэтому они служат хорошим доказательством основного тезиса этой статьи. Они также концентрируют риски, поскольку прокси видит каждый запрос и хранит ключи всех провайдеров. Относитесь к ним как к инфраструктуре, а не как к удобному инструменту. Где обвязка хранит свои API-ключи и настройки моделей — это та же проблема, но на уровень ниже.

Что меняется при запуске обвязки на VPS

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

Процесс продолжает работу после закрытия крышки ноутбука. Длительная задача переживет вашу поездку и разрядку аккумулятора. Запустите её внутри tmux и отсоединитесь:

tmux new -s agent
# start the harness, then press Ctrl-b and then d to detach
tmux attach -t agent

Для задач, которые должны возобновляться после перезагрузки, пользовательский сервис (user service) подходит лучше, чем сессия терминала:

loginctl enable-linger $USER
systemctl --user status my-agent.service

loginctl enable-linger — это то, что часто упускают из виду. Без этой настройки systemd по умолчанию завершает работу менеджера пользовательских сервисов через 10 секунд после закрытия последней сессии, поэтому пользовательский сервис не удержит агент запущенным после выхода из системы. В Запуск dsh в фоновом режиме через systemd приведен файл юнита. Как только на сервере активна одна сессия, вы можете запустить вторую, и две сессии Claude Code на одном узле могут обмениваться сообщениями, поэтому сессия, запущенная утром, может передать задачу другой без вашего ручного вмешательства.

Сервер хранит ваши ключи. Ключ провайдера теперь находится в конфигурационном файле на этом сервере. Проверьте права доступа к нему:

ls -l ~/.config

Любой процесс, запущенный от имени вашего пользователя, может прочитать этот файл, включая агент и всё, что агент решит запустить.

Сервер имеет доступ к другим вашим машинам. VPS в той же частной сети, что и другие ваши узлы, предоставляет агенту маршрут к ним. В этом и заключается основная цель, но это также определяет радиус поражения в случае инцидента.

Сервер доступен отовсюду. Большинство обвязок предоставляют веб-интерфейс, и в большинстве случаев он привязывается к loopback не просто так. Проверьте свой:

ss -tlnp | grep 3080

127.0.0.1:3080 означает, что подключиться может только сам сервер. 0.0.0.0:3080 означает, что интерфейс слушает все сетевые адреса, поэтому любой, кто имеет доступ к публичному адресу сервера, сможет подключиться, если порт не закрыт внешним файрволом. По состоянию на октябрь 2026 года dsh отклоняет подобные wildcard-адреса при запуске, но многие другие веб-интерфейсы их принимают. Получайте доступ к loopback-интерфейсу через SSH-туннель вместо изменения адреса привязки:

ssh -N -L 3080:127.0.0.1:3080 you@your-server

Затем откройте http://127.0.0.1:3080 в браузере на своем ноутбуке. Трафик передается внутри SSH-сессии, поэтому в интернет не выставляется ничего лишнего.

Каждый из этих пунктов также является аргументом в пользу безопасности

Прочитайте эти четыре свойства еще раз с точки зрения злоумышленника.

Программа работает без присмотра, поэтому никто не заметит момент, когда модель неверно интерпретирует путь. Она хранит ваши ключи, поэтому один доступный для чтения файл конфигурации — это доступ ко всей вашей учетной записи провайдера. Она имеет доступ к другим вашим машинам, поэтому prompt injection (инструкции, скрытые на веб-странице или в файле, который читает агент) теперь открывает путь к хосту вашей базы данных. Она доступна отовсюду, поэтому веб-интерфейс, который слушает публичный адрес без брандмауэра и собственной аутентификации, становится оболочкой для любого, кто его обнаружит. dsh добавляет токен процесса в URL, который выводится при запуске, что помогает, но этот URL теперь является учетными данными, поэтому обращайтесь с ним так же осторожно, как с паролем.

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

sudo adduser --disabled-password --gecos "" agent

Оставьте веб-интерфейс на loopback и подключайтесь к нему через SSH. Предоставьте агенту минимально необходимые права, которые позволяют ему выполнить задачу; подробнее об этом в хранении секретов вне AI-агентов. Для всего, что работает в ваше отсутствие, одноразовая машина лучше, чем тщательно настроенная: запуск агентов для программирования в одноразовой VM и безопасный запуск Claude Code на VPS — оба варианта используют именно этот подход.

Нужна ли вам среда для запуска агентов?

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

Большинство инструментов в этой категории еще молоды. dsh прямо указывает в своем README, что по состоянию на октябрь 2026 года это предварительная версия для разработчиков, а остальные развиваются настолько быстро, что конфигурационный файл, написанный сегодня, может потребовать правок уже в следующем месяце. Это повод сохранять настройки минималистичными и воспроизводимыми, а также записывать все внесенные изменения. Та же сдержанность полезна и внутри цикла, где навык подталкивания агента к минимально возможным рабочим изменениям позволит вам получить diff, который можно прочитать после завершения автоматического запуска. Начните с одной среды на одном сервере, дайте ей одну задачу и один ключ с ограниченными правами, а расширяйте доступ только после того, как эта задача станет для вас рутинной в течение недели. Самостоятельно размещаемые агенты, которые стоит использовать сегодня — подходящее место для выбора первого инструмента.

FAQ

Что такое агентская обвязка (agent harness) простыми словами?

Это программа, работающая вокруг модели. Модель генерирует текст и запросы на использование инструментов. Обвязка поддерживает цикл взаимодействия, выполняет запрошенные моделью инструменты, контролирует правила запуска инструментов без подтверждения, а также сохраняет состояние сессии и файлы между итерациями. Если заменить модель, обвязка продолжит работать — это главный признак того, что они являются независимыми компонентами.

Claude Code — это модель или обвязка?

Claude Code — это обвязка. Это терминальная программа с циклом работы, системой разрешений и встроенными инструментами для работы с файлами и оболочкой. Claude — это семейство моделей, которые программа вызывает по умолчанию. Такое же разделение применимо к DeepSeek Harness (dsh), представляющей собой Node-программу для установки, и моделям DeepSeek, доступным через API. Обвязку вы устанавливаете на машину. Модель вы вызываете по сети.

В чем разница между агентской обвязкой и агентским фреймворком?

Фреймворк — это библиотека, которую вы импортируете и используете в своем коде, задействуя встроенный в нее цикл или создавая свой собственный. Обвязка — это готовая программа, которую вы запускаете; цикл, механизмы повторных попыток и обработка контекста поставляются с настройками по умолчанию, которые вы конфигурируете, а не пишете с нуля. На практике грань размыта: Deep Agents от LangChain — это импортируемый SDK, который в собственном репозитории по состоянию на октябрь 2026 года называют агентской обвязкой «все включено». Задайте себе вопрос: будете ли вы писать цикл самостоятельно? Ответ на него определит, какой термин подходит для вашей ситуации.

Нужен ли мне VPS для запуска агентской обвязки?

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

Могу ли я использовать другую модель внутри той же обвязки?

Обычно да, и это определяющее свойство обвязки. Большинство из них принимают имя модели и базовый URL в конфигурации, поэтому переключение на другого провайдера требует лишь правки настроек, а не переписывания кода. Там, где обвязка препятствует этому, между ней и провайдером устанавливается локальный маршрутизатор, такой как Claude Code Router, который транслирует запросы и по умолчанию привязывается к 127.0.0.1:3456. Будьте осторожны с таким прокси, так как он видит каждый промпт и хранит все ключи.

Была ли эта статья полезной?