Роутинг — AiHummer Документация

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

Определение целевого агента

Роутер определяет целевого агента в заданном порядке:

Привязки (bindings) — явное сопоставление, связывающее канал, разговор или контекст с конкретным агентом. Это основной, детерминированный маршрут.
@-упоминания — в групповом разговоре упоминание агента по имени направляет сообщение этому агенту. Так работает групповой роутинг.
Fallback — если ничего другого не подошло, сообщение уходит к настроенному запасному агенту, чтобы разговор никогда не остался без ответа.

входящее ─▶ привязка? ─▶ @-упоминание? ─▶ fallback ─▶ агент

[!NOTE] @-упоминания делают мультиагентные групповые чаты удобными: несколько агентов могут делить разговор, и каждое сообщение доставляется тому, кого назвали.

Привязки

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

[!TIP] Задайте привязку для каждого продакшн-канала, чтобы роутинг никогда не зависел от fallback. Оставьте fallback для действительно несопоставленного трафика.

Роутинг по тиру модели

Независимо от того, какой агент выбран, AiHummer может направить ход на тир модели в зависимости от его сложности:

Тир	Для чего
simple	Короткие, рутинные ходы
standard	Повседневная работа
complex	Сложные многошаговые рассуждения

Роутинг по тиру модели настраивается в настройках роутера «LLM». Он позволяет отдавать дешёвые быстрые модели для простых ходов и резервировать более сильную модель для сложных, контролируя стоимость без ручной настройки каждого агента.

[!NOTE] Роутинг по тиру модели отделён от собственной модели агента. Своя модель — это дефолт агента; роутинг по тиру может выбрать класс модели для конкретного хода. См. Агенты и персоны.

Куда дальше

Что делает выбранный агент дальше — в разделе Оркестрация и суб-агенты.
Настройка агентов, на которых нацелен роутинг — в разделе Агенты и персоны.