Эра Loop Engineering: как устроены циклы Doer-Judge в агентных системах

Эра Loop Engineering: как устроены циклы Doer-Judge в агентных системах

В сфере разработки систем искусственного интеллекта наметился принципиальный сдвиг. На смену ручному составлению промптов (Prompt Engineering) приходит циклическое проектирование — Loop Engineering. Раньше человек управлял процессом вручную: отправлял запрос, видел плохой ответ модели, дописывал промпт и пробовал снова. В новой схеме разработчик проектирует закрытую систему, в которой один агент (исполнитель, или Doer) генерирует результат, а второй агент (оценщик, или Judge) проверяет его на соответствие правилам, возвращая на доработку с конкретными замечаниями до тех пор, пока задача не будет выполнена идеально или не исчерпается лимит итераций.

Ниже представлено практическое руководство по развертыванию такой агентной среды на базе Hermes Agent OS 0.17.0 и Obsidian в качестве системы внешней рабочей памяти, а также примеры интеграции с API Google Search Console и OpenRouter Fusion.

1. Установка и базовая настройка Hermes Agent OS

NousResearch выпустила версию v0.17.0 The Reach Release автономного ассистента Hermes Agent. Агент превратился в полноценную легковесную ОС с фоновыми субагентами, поддержкой Photon для интеграции с iMessage и клиентом для десктопа. В этой версии появился режим Blank Slate (чистый лист), позволяющий запускать систему с пустым набором навыков и вручную подключать только нужные модули (через команду Hermes setup), что резко снижает расход токенов.

Предусловия для установки:

• Сервер VPS (виртуальный выделенный сервер) или локальный компьютер под управлением Linux, macOS или Windows с установленной подсистемой WSL2 (Windows Subsystem for Linux).
• Наличие установленной утилиты curl для скачивания пакетов и терминальный доступ по SSH (протоколу безопасного удаленного подключения к серверу).
• Наличие API-ключа провайдера моделей (например, OpenAI или Anthropic).

Пошаговая инструкция по развертыванию:

1. Подключитесь к вашему терминалу Linux/WSL2 и выполните официальную скрипт-команду установки:

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
   

   Где это происходит: в терминале вашего сервера или локального компьютера. Подробные инструкции и исходный код скрипта доступны в официальном репозитории NousResearch.
2. После завершения скачивания инициализируйте первичный профиль агента:

   hermes setup
   

   В ходе интерактивного опроса введите ваши API-ключи.

   !WARNING Храните API-ключи в переменных окружения ОС или в защищенных конфигурационных файлах Hermes. Никогда не вставляйте секретные ключи в открытый текст ваших будущих заметок или документов.

3. Запустите консольного агента:

   hermes
   

4. Напишите тестовое приветствие в чате, чтобы убедиться, что базовая языковая модель отвечает без сбоев. Не пытайтесь сразу подключать внешние интеграции и расписания (cron), пока не добьетесь стабильного базового диалога.

2. Настройка Obsidian как общей памяти (RAG)

Для предотвращения амнезии у ИИ-агента используется технология RAG (Retrieval-Augmented Generation — генерация с привлечением извлеченных данных) на базе Obsidian. Память агента хранится в обычных markdown-файлах в Obsidian Vault (хранилище). Это создает концепцию living files (живых файлов) — текстовая база проекта одновременно читается и редактируется человеком и используется ИИ для координации действий.

Настройка структуры рабочей памяти:

1. Создайте в Obsidian отдельную чистую папку для агента, например Agent OS.

   !CAUTION Не давайте ИИ доступ ко всему вашему личному архиву Obsidian, если там содержатся личные пароли, секреты или финансовые отчеты. Выделите под ИИ изолированную директорию.

2. Внутри папки Agent OS создайте структуру управляющих файлов:
   • goals.md — глобальные цели проекта.
   • rules.md — жесткие ограничения по стилю написания кода или текста.
   • projects.md — текущий статус активных задач.
   • inbox.md — буфер для входящих запросов от пользователя.
   • review-checklist.md — правила оценки качества для агента-Judge.
3. В настройках Hermes подключите плагин Obsidian Vault. Подробная спецификация операций со структурой заметок приведена на странице документации bundled-skills.
4. Протестируйте работу с файлами: отправьте агенту команду прочитать rules.md, попросите его добавить новую запись в inbox.md и проверить граф wikilinks (ссылок внутри Obsidian).
5. Для синхронизации файлов между удаленным VPS и вашим локальным компьютером настройте Obsidian Sync или разверните Git-репозиторий в рабочей папке агента на сервере для версионирования всех изменений.

3. Реализация SEO-агента через Google Search Console API

Практический пример применения Doer-Judge цикла — автоматический аудит и оптимизация контента сайта на основе реальных данных из поисковой выдачи Google.

Пошаговый процесс настройки интеграции:

1. Убедитесь, что ваш веб-сайт добавлен и верифицирован в панели веб-мастера.
2. Перейдите в Google Cloud Console и создайте проект. Включите API согласно Google Search Console API overview.
3. Создайте сервисный аккаунт (Service Account) или настройте ключи OAuth credentials, скачайте файл авторизации в формате JSON и положите его на сервер в защищенную директорию вне зоны доступа ИИ.
4. Настройте скрипт Doer-агента, который раз в неделю вызывает API для экспорта данных за последние 28 дней, фильтрует ключевые слова с низким CTR (кликабельностью), группирует их по сложности продвижения и формирует контент-план в файле projects.md.
5. Роль Judge-агента в данном контуре — сверять предложенные Doer-ом статьи с техническими требованиями (наличие ключевых слов из Search Console, точное совпадение интента, уникальность заголовков, отсутствие переспама и битых ссылок). Если статья не проходит проверку, Judge возвращает ее Doer с перечнем исправлений.

4. Внедрение multi-model Deliberation через OpenRouter Fusion

Если вам нужно объединить мнения разных языковых моделей для решения сложной логической задачи (например, кодовый аудит или юридическая оценка), используйте плагин Fusion от OpenRouter.

Инструкция по настройке:

1. Создайте аккаунт и получите ключ доступа в панели управления OpenRouter.
2. Экспортируйте ключ на своем VPS:

   export OPENROUTER_API_KEY="your_secret_key"
   

3. Изучите схему плагина в документации OpenRouter Fusion.
4. Настройте запрос так, чтобы группа моделей-экспертов (например, Claude 3.5 Sonnet и GPT-4o) параллельно анализировала одну кодовую базу, а итоговая модель-судья (Judge) синтезировала их выводы в единый структурированный отчет, указывая на слабые места и противоречия в предложениях коллег.

Риски и ограничения Loop Engineering

Главный риск циклического проектирования — уход системы в бесконечный итеративный цикл (infinite loop), который мгновенно сжигает бюджет на токены API. Чтобы этого избежать, архитектор обязан:

• Устанавливать жесткий лимит на количество итераций (например, Doer может переделывать задачу не более 5 раз, после чего система обязана остановиться и запросить вмешательство человека).
• Задавать детерминированные (программные) проверки на стороне Judge: перед тем как отправлять код модели-оценщику, прогоните его через стандартный линтер и автотесты. Это сбережет ресурсы.
• Разделять контекст: не забивайте оперативную память агента терабайтами старых логов. Проводите регулярную очистку папки Agent OS в Obsidian, архивируя выполненные проекты в файл deprecated.md.

Внедрение Loop-архитектуры перемещает человека из роли ручного редактора промптов в роль системного архитектора, который один раз описывает правила качества, настраивает интеграции и лишь утверждает финальный проверенный результат.