AI-агенты · инструкция

Как с нуля поставить AI-агента на рельсы

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

Светлана Козырина управляет AI-агентом на системе рельсов и контрольных шлюзов
💡

Коротко: AI-агент начинается с одного повторяющегося процесса. Вокруг модели собирают harness: контракт, контекст, инструменты, состояние, проверки и человеческие шлюзы. Субагентов добавляют только под отдельные роли, а публикация, деньги и production остаются за человеком.

Что бизнес получает от AI-агента?

Коротко: AI-агент берёт повторяющийся процесс, читает нужный контекст, выбирает шаги, работает разрешёнными инструментами, проверяет результат и передаёт его дальше. Ценность для бизнеса появляется там, где работу можно повторить, проверить и остановить.

Обычный чат отвечает на вопрос. Агент ведёт задачу через несколько состояний.

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

Разница не в красоте ответа. Разница в рабочем порядке.

Для собственника это даёт четыре вещи:

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

Время экономит не «самый умный AI». Время экономит процесс, который не приходится каждый раз собирать заново из чатов, файлов и воспоминаний сотрудников.

С чего начать: с модели или с процесса?

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

Плохая постановка звучит так: «Хочу агента по маркетингу».

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

Во второй постановке уже видны:

  1. Сигнал запуска: понедельник и новые вопросы клиентов.
  2. Вход: вопросы, поисковые данные, список опубликованных материалов.
  3. Выход: три темы с обоснованием.
  4. Ограничение: запрет на публикацию.
  5. Владелец решения: человек.

Берите один процесс. Не стройте сразу «директора по всему». Чем шире роль, тем быстрее агент начинает изображать кипучую деятельность там, где бизнесу нужна точность.

Из каких слоёв состоит архитектура агента?

Коротко: рабочая архитектура состоит из бизнес-контракта, контекста, модели, инструментов, состояния, проверок и маршрута передачи. Уберите любой слой, и агент либо станет бесполезным, либо получит свободу без контроля.

СлойЗа что отвечаетЧто ломается без него
Бизнес-контрактцель, вход, выход, запретыагент делает «что-то полезное», но не нужную работу
Контекстфакты, продукты, аудитория, голос, решениякаждый запуск начинается с нуля
Модельанализ, выбор шага, создание результатанет интеллектуального исполнителя
Инструментыфайлы, поиск, таблицы, CRM, APIагент умеет говорить, но не умеет действовать
Состояниегде находится задача и какая версия актуальнашаги повторяются, версии путаются
Проверкифакты, качество, право, безопасностьошибка проходит дальше по цепочке
Человеческий шлюзрешение на риск и внешнее действиеагент сам назначает себе полномочия

Модель можно заменить. Бизнес-контракт и правила процесса должны пережить такую замену. Это один из признаков нормальной архитектуры.

Если нужен отдельный разбор памяти, файлов и резервного маршрута, он уже есть в статье «Как собрать AI-систему для бизнеса, а не зависеть от одного сервиса».

Что такое harness, или «обмотка» вокруг модели?

Коротко: harness - это рабочая обвязка, которая удерживает модель внутри процесса. В неё входят инструкции, схемы входа и выхода, разрешения, инструменты, проверки, журнал состояния, лимиты повторов, правила остановки и маршрут согласования.

Слово можно перевести как «упряжь» или «система крепления». Мне ближе «обмотка». Сама модель умеет рассуждать, но не знает ваших границ. Harness эти границы фиксирует.

У хорошего harness есть минимум восемь элементов:

  1. Intake. Какие данные обязательны на входе. Если данных нет, агент пишет needs_data, а не сочиняет.
  2. Контракт роли. Что агент обязан вернуть и в каком формате.
  3. Набор инструментов. Только те действия, которые нужны роли.
  4. Состояния. Например: идея, черновик, проверка, согласование, одобрено.
  5. Шлюзы. Условия, без которых задача не двигается дальше.
  6. Возвраты. Кому и с каким вердиктом вернуть слабый результат.
  7. Лимиты. Сколько раз агент может автоматически переделывать один этап.
  8. Журнал и доказательства. Какие файлы, источники и версии подтверждают, что шаг выполнен.

Harness режет красивую самодеятельность. Если факт не подтверждён, он не превращается в уверенную цифру. Если пакет не доставлен Светлане, статус не становится «отправлено». Если текст одобрен, это всё равно не даёт права лезть в production.

Тема агента обычно вскрывает весь маркетинг: где нет владельца процесса, где гуляют версии, где неизвестна цена ошибки. На «Точке прорыва» мы сначала находим эту поломку, а уже потом решаем, нужен там AI-агент или достаточно нормального регламента.

Когда нужны субагенты и как разделить роли?

Коротко: субагент нужен, когда внутри процесса есть отдельная работа с собственным входом, выходом и критерием качества. Делить роли ради красивой команды бессмысленно. Делить стоит там, где одна роль создаёт результат, а другая независимо его проверяет или дополняет.

У Статейника Бюро «УМ» есть отдельные роли: разведчик сигналов, семантический картограф, защита от дублей, редактор SEO-брифа, автор, контролёр качества и упаковщик согласования.

Почему не один «суперписатель»? Потому что автор плохо ловит собственные ошибки. Он уже знает, что хотел сказать, и легко принимает намерение за доказательство.

Практичная схема разделения:

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

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

Что агент делает, а куда его не пускают?

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

Пример границы для контентного агента.

Он делает:

  • собирает тему и источники;
  • проверяет поисковое намерение;
  • пишет и редактирует текст;
  • формирует метаданные и внутренние ссылки;
  • готовит Telegram- и Дзен-версии;
  • собирает пакет на согласование.

Он принципиально не делает:

  • не публикует статью сам;
  • не меняет сайт и production;
  • не запускает cron, ботов и watchdog;
  • не подменяет неизвестную частотность красивой цифрой;
  • не меняет цену и оффер;
  • не считает доставкой локальный путь на сервере.

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

Как устроены зависимости и созависимости?

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

Здоровая цепочка выглядит так:

тема -> семантика -> бриф -> текст -> проверка -> визуальный пакет -> согласование

У каждого перехода есть артефакт. Семантика возвращает кластер и решение CREATE или UPDATE. Автор получает утверждённый бриф. Humanizer получает текст вместе с неизменяемыми фактами. Фемида подключается только по юридическим триггерам. Visual Intelligence получает готовый смысловой бриф, а не вытаскивает тему из воздуха.

Опасные созависимости выглядят иначе:

  • автор ждёт от визуализатора смысл статьи;
  • визуализатор меняет оффер, потому что «так красивее»;
  • Humanizer вычищает важную юридическую оговорку;
  • проверяющий сам переписывает исходник и скрывает, что нашёл;
  • два агента редактируют один файл одновременно;
  • автоматический возврат ходит по кругу без владельца решения.

В harness Бюро «УМ» максимум два автоматических круга на один шлюз. После второго спор забирает человек. Машины не должны выяснять отношения до пенсии.

Где в системе остаётся человек?

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

Человеческий контроль нужен не в каждом абзаце. Если Светлана должна вручную одобрять каждое исправление запятой, автоматизация умерла ещё до запуска.

Человек включается в четырёх точках:

  1. Выбор цели и границ процесса.
  2. Разрешение спорного исключения.
  3. Принятие полного пакета результата.
  4. Отдельное разрешение необратимого или внешнего действия.

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

Какие агенты уже работают в Бюро «УМ»?

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

На 14 июля 2026 года в действующем реестре Бюро зафиксированы:

  • Стратег Lite «Козырь». Собирает компактную стратегию и план 30-60-90.
  • Стратег Deep «Архитектор». Ведёт глубокую стратегию, продуктовую архитектуру, выход на рынок и дорожную карту.
  • «Замес». Оспаривает продуктовую логику. Возвращает противоречия и недостающие доказательства, но сам не переписывает источник.
  • Статейник + SEO/AEO. Готовит семантическое решение, статью, метаданные, адаптации и пакет согласования.
  • Visual Intelligence. Отвечает за арт-дирекцию, доказательные референсы, производство визуалов, критику и адаптации.
  • «Гейша». Исследует тему и собирает сценарий ролика через отдельный сценарный штаб.
  • «Бритва». Пишет посты прямого отклика и дерзкие ответы, затем проходит самопроверку и Humanizer.
  • «Фемида». Проверяет договоры, рекламу, лицензии и персональные данные. Для актуального права требует свежих источников.
  • Humanizer. Убирает AI-штампы и применяет голос нужного бренда, не меняя факты и юридические ограничения.
  • «Сэнсэй». Личный наставник по управленческой борьбе.
  • «Совет». Даёт несколько независимых оптик и председательский вердикт, не меняя исходник.

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

Кейс с отдельной командой агентов можно посмотреть в материале «Как за неделю мы собрали AI-систему бизнеса для SOAR». А технический вход в рабочую среду разобран в статье «Codex в VS Code: пошаговый онбординг».

Какова роль Hermes в структуре Бюро?

Коротко: Hermes не записан в реестре Бюро как двенадцатый профильный агент. Это отдельная универсальная агентная платформа и резервный исполнитель. В контуре Бюро Hermes выступал аудитором harness и предусмотрен как третий fallback после Codex и Claude, но этот автоматический резервный маршрут пока не введён в production.

Здесь легко перепутать платформу и должность.

Hermes Agent разработан Nous Research. Платформа умеет работать с разными моделями, хранить память, использовать навыки, запускать субагентов и выполнять задачи по расписанию. То есть Hermes способен быть средой, в которой живут разные рабочие роли.

В структуре Бюро роль уже конкретнее:

  • Hermes провёл аудит harness и помог найти архитектурные недочёты;
  • Hermes входит в проект резервного маршрута Codex -> Claude -> Hermes;
  • Hermes не подменяет Статейника, Фемиду, Стратега или Светлану;
  • Hermes не получает право публикации только потому, что умеет запускать инструменты;
  • автоматический fallback с Hermes описан локально, но не включён в production без отдельного решения.

Проще: Hermes можно сравнить с универсальной рабочей средой и резервным исполнителем. Профильные агенты Бюро похожи на должности с контрактами. А Светлана остаётся владельцем решений, полномочий и риска.

Как поставить первого агента на рельсы за семь шагов?

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

  1. Выберите одну работу. Например, подготовка еженедельного отчёта, первичный разбор заявки или статья по утверждённой теме.
  2. Опишите вход и выход. Какие поля обязательны? Как выглядит готовый результат? Где он хранится?
  3. Зафиксируйте запреты. Что агент не делает ни при каких условиях без отдельного решения?
  4. Соберите контекст. Положите в понятное место продукты, аудиторию, правила голоса, примеры, историю решений и актуальные данные.
  5. Добавьте проверки. Факты проверяет одна роль, юридические триггеры другая, итог принимает человек.
  6. Опишите состояния и возвраты. Что значит draft, needs_data, review_ready, approved? Кто получает задачу после ошибки?
  7. Сломайте процесс специально. Уберите один источник, дайте неполный вход, подмените версию файла. Агент должен остановиться и показать проблему, а не бодро сымитировать успех.

После трёх-пяти стабильных прогонов можно добавлять расписание, интеграции и субагентов. До этого автоматизация только быстрее размазывает ошибку по системе.

Как проверить, что получился агент, а не дорогой чат?

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

Проверьте десять пунктов:

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

Если половина пунктов отсутствует, не покупайте ещё одну модель. Сначала поставьте на рельсы процесс.

Источники

  • Внутренний реестр агентов Бюро «УМ» - канонический источник ролей.
  • Внутренний реестр маршрутов harness - канонический источник зависимостей.
  • Политика согласования Бюро «УМ» - граница согласования и публикации.
  • Hermes Agent Documentation - официальная документация Nous Research.
  • Hermes: Delegation and Parallel Work - официальная документация субагентов.
  • OpenAI: A practical guide to building agents - роли, guardrails и человеческое вмешательство.

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

Частые вопросы

Чем AI-агент отличается от чат-бота?

Чат-бот в основном отвечает на сообщения. AI-агент ведёт задачу через состояния, использует разрешённые инструменты, сохраняет результат, проходит проверки и передаёт работу следующей роли или человеку.

Нужны ли субагенты первому агенту?

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

Можно ли дать агенту доступ к CRM и сайту?

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

Что важнее: модель или harness?

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

Hermes управляет всеми агентами Бюро «УМ»?

Нет. Hermes не является начальником профильных агентов Бюро и не входит в их реестр как отдельная бизнес-роль. Сейчас это внешний универсальный runtime, аудитор и предусмотренный резервный исполнитель. Решения и полномочия остаются в harness и у Светланы.

Диагностика бизнеса · Точка прорыва

Сначала найдём процесс, потом поставим агента на рельсы

Разберём, где бизнес теряет деньги, что держится на ручном хаосе и какой первый AI-контур действительно имеет смысл собирать.

Посмотреть «Точку прорыва» →