Оркестрация и суб-агенты
Оркестратор — это то, что превращает входящее сообщение в ответ. Он собирает слоистый системный промпт и ведёт цикл вызова функций: модель думает, вызывает инструменты, читает результаты и повторяет, пока не сформирует финальный ответ. Поверх этого цикла агент может порождать суб-агентов и применять опциональные стратегии рассуждения — и всё это настраивается из админ-панели.
Цикл обработки запроса (turn)
Обработка запроса — это ограниченный цикл вызова функций. Модели передаются системный промпт, разговор и доступные инструменты; она может вызвать один или несколько инструментов, оркестратор выполняет их и возвращает результаты, и цикл продолжается, пока модель не вернёт финальное сообщение. Инструменты, память и знания всегда приходят как результаты инструментов, а не как внедрённые инструкции — именно это делает цикл устойчивым к инъекциям в промпт.
промпт + инструменты ─▶ модель ─▶ вызовы ─▶ результаты ─▶ модель ─▶ ... ─▶ финальный ответСуб-агенты
Агент может порождать суб-агентов, чтобы они выполнили подзадачу и вернули результат вызвавшему. Это позволяет координирующему агенту делегировать сфокусированную работу — исследование, черновик, специализированный поиск — не перегружая один контекст.
Рекурсия ограничена: максимальная глубина вложенности задаётся переменной
AIHUMMER_SUBAGENT_MAX_DEPTH. Это предотвращает неконтролируемое порождение и
делает стоимость и задержку обработки предсказуемыми.
[!WARNING] Суб-агенты умножают работу. Держите
AIHUMMER_SUBAGENT_MAX_DEPTHконсервативным на общих хостах — каждый дополнительный уровень глубины может умножать вызовы инструментов и расход модели.
Стратегии рассуждения
Помимо обычного цикла, оркестратор предлагает опциональные стратегии рассуждения. Они выключены, пока не включены, и каждая настраивается из админ-панели в группе настроек «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] Глубина суб-агентов и включение инструментов — среди настроек, которые применяются на лету (без перезапуска). Другие настройки могут требовать перезапуска — см. модель конфигурации в разделе «Начало работы».
Куда дальше
- Что может вызывать цикл — в разделе Инструменты.
- Как сообщение выбирает стартового агента — в разделе Маршрутизация.
- Настройка самих агентов — в разделе Агенты и профили.