Маршрутизация

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

Когда приходит сообщение, принимаются два решения о маршрутизации: **какой агент** должен его обработать и **какой класс модели** выполнит обработку. Первое решает маршрутизатор (компонент router), второе — маршрутизация по уровню модели. Оба происходят до того, как оркестратор запустит цикл вызова функций. ## Определение целевого агента Маршрутизатор определяет целевого агента в заданном порядке: 1. **Привязки (bindings)** — явное сопоставление, связывающее канал, разговор или контекст с конкретным агентом. Это основной, детерминированный маршрут. 2. **`@`-упоминания** — в групповом разговоре упоминание агента по имени направляет сообщение этому агенту. Так работает групповая маршрутизация. 3. **Резервный агент (fallback)** — если ничего другого не подошло, сообщение уходит к настроенному резервному агенту, чтобы разговор не остался без ответа. ```text входящее ─▶ привязка? ─▶ @-упоминание? ─▶ резервный агент ─▶ агент ``` > [!NOTE] > `@`-упоминания делают мультиагентные групповые чаты удобными: несколько агентов > могут делить разговор, и каждое сообщение доставляется тому, кого назвали. ## Привязки **Привязка** — детерминированный костяк маршрутизации. Связав входящий контекст (например, конкретный канал или разговор) с агентом, вы получаете предсказуемое поведение: один и тот же источник всегда попадает к одному и тому же агенту, если только `@`-упоминание не переопределит это для одного сообщения. Привязки каналов настраиваются в админ-панели: блок **«Привязки»** на странице **«Каналы»** назначает **агента по умолчанию** для каждого канала (в рамках рабочего пространства). Привязка применяется, когда новый разговор приходит из канала без явно указанного агента. **Пример порядка правил.** В Telegram-группе канал привязан к агенту «Поддержка», резервный агент — «Дежурный». 1. Сообщение «не работает вход» без упоминаний → правило 1 (привязка): отвечает «Поддержка». 2. Сообщение «@Бухгалтер, выставь счёт» → правило 2 (упоминание) побеждает привязку: отвечает «Бухгалтер», хотя канал привязан к «Поддержке». 3. Сообщение из нового, ещё не привязанного канала без упоминаний → правило 3: отвечает резервный «Дежурный». > [!TIP] > Задайте привязку для каждого рабочего канала, чтобы маршрутизация не зависела > от резервного агента. Оставьте резервного агента для действительно > несопоставленного трафика. ## Маршрутизация по уровню модели Независимо от того, какой агент выбран, AiHummer может направить обработку на **уровень модели** в зависимости от её сложности: | Уровень | Для чего | |---|---| | **simple** | Короткие, рутинные запросы | | **standard** | Повседневная работа | | **complex** | Сложные многошаговые рассуждения | Маршрутизация по уровню модели настраивается в настройках маршрутизатора **«LLM»**. Она позволяет отдавать дешёвые быстрые модели для простых запросов и резервировать более сильную модель для сложных, контролируя стоимость без ручной настройки каждого агента. > [!NOTE] > Маршрутизация по уровню модели отделена от собственной модели агента. Своя > модель — это значение по умолчанию для агента; маршрутизация по уровню может > выбрать класс модели для конкретного запроса. > См. [Агенты и профили](/v1.0/concepts/agents-personas). ## Куда дальше - Что делает выбранный агент дальше — в разделе [Оркестрация и суб-агенты](/v1.0/concepts/orchestration-subagents). - Настройка агентов, на которых нацелена маршрутизация — в разделе [Агенты и профили](/v1.0/concepts/agents-personas).