Оркестрация и суб-агенты — AiHummer Документация

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

Цикл обработки запроса (turn)

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

промпт + инструменты ─▶ модель ─▶ вызовы ─▶ результаты ─▶ модель ─▶ ... ─▶ финальный ответ

Суб-агенты

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

Рекурсия ограничена: максимальная глубина вложенности задаётся переменной AIHUMMER_SUBAGENT_MAX_DEPTH. Это предотвращает неконтролируемое порождение и делает стоимость и задержку обработки предсказуемыми.

[!WARNING] Суб-агенты умножают работу. Держите AIHUMMER_SUBAGENT_MAX_DEPTH консервативным на общих хостах — каждый дополнительный уровень глубины может умножать вызовы инструментов и расход модели.

Лимиты дочерних агентов на уровне агента

Глобальные AIHUMMER_SUBAGENT_MAX_DEPTH и AIHUMMER_SUBAGENT_TIMEOUT_SEC действуют для всех агентов. С версии 1.3 отдельному агенту можно задать свои границы в блоке children его политики выполнения (runtime_policy в админ-API): глубину вложенности (до 4), число одновременно работающих дочерних агентов на одно дерево запуска (до 8), число активных потомков у одного родителя (до 5), срок дочернего вызова (до 48 часов, но не дольше родителя) и время, через которое завершённые запуски уходят из списка по умолчанию. Дочерний вызов наследует модель, набор инструментов и права инициатора и не может их расширить; по истечении срока процессы инструментов завершаются вместе с потомками. Подробнее — в разделе Агенты и профили.

Стратегии рассуждения

Помимо обычного цикла, оркестратор предлагает опциональные стратегии рассуждения. Они выключены, пока не включены, и каждая настраивается из админ-панели в группе настроек «Agent · Reasoning».

Стратегия	Что делает
Plan-steps	Агент составляет план перед действием, затем прорабатывает шаги.
Reflect	Агент критикует и правит собственный черновик перед ответом.
Debate	`N` агентов спорят несколько раундов, затем судья выбирает победителя.
Best-of-N	Генерирует несколько кандидатов и выбирает лучший.
Self-heal	При сбое агент диагностирует и повторяет попытку, а не сдаётся.

[!TIP] Стратегии рассуждения обменивают задержку и расход токенов на качество. Включайте их выборочно для тех агентов и задач, где это нужно, а не глобально.

Графы агентов

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

Для мультиагентных сценариев, более структурированных, чем разовые вызовы суб-агентов, AiHummer поддерживает графы агентов — явное связывание агентов в рабочий процесс. Графы управляются из админ-панели и через админ-API по пути /v1/admin/graphs/*.

Страница «Графы» в админ-панели — это визуальный flowchart-редактор: узлы графа перетаскиваются по холсту, связи между ними рисуются стрелками, палитра добавляет новые узлы, а боковая панель редактирует параметры выбранного узла. Определение графа (стартовый узел, лимит шагов, узлы и переходы) хранится как JSON — переключатель «Экспорт/Импорт JSON» открывает его для просмотра, переноса между инстансами и правки вручную.

Сводка по настройкам

Параметр	Где
Макс. глубина суб-агентов	`AIHUMMER_SUBAGENT_MAX_DEPTH` (env; применяется на лету)
Стратегии рассуждения	Группа настроек «Agent · Reasoning»
Графы агентов	`/v1/admin/graphs/*`

[!NOTE] Глубина суб-агентов и включение инструментов — среди настроек, которые применяются на лету (без перезапуска). Другие настройки могут требовать перезапуска — см. модель конфигурации в разделе «Начало работы».

Куда дальше

Что может вызывать цикл — в разделе Инструменты.
Как сообщение выбирает стартового агента — в разделе Маршрутизация.
Настройка самих агентов — в разделе Агенты и профили.