Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал

Автомаршрут

Статус: активно Область: текущее состояние Последняя проверка: 2026-10-10 Владелец: среда выполнения ax-code

Автомаршрут управляет двумя независимыми поведениями маршрутизации в ax-code:

1. Маршрутизация по ключевым словам — активна по умолчанию. Переключает агента, когда сообщение совпадает с ключевыми словами или шаблонами специалиста. Срабатывает быстрее чем за 1 мс и не требует вызова LLM. Пропускается, если маршрутизация явно выключена, пользователь явно называет агента или сообщение — синтетическое продолжение, которое сохраняет текущего агента.

2. Маршрутизация по сложности — необязательна, включается переключателем автомаршрута. Лёгкий вызов LLM классифицирует каждое сообщение как сложность low, medium или high. Сообщения сложности low автоматически обслуживает явно настроенный small_model, снижая задержку простых вопросов.

По умолчанию автомаршрут выключен — маршрутизация по сложности отключена. Маршрутизация по ключевым словам отделена от этого переключателя и остаётся активной по умолчанию, пока её не выключит конфигурация или не обойдёт явный выбор агента.

Быстрый старт

Переключите из TUI:

• введите /smart-llm в запросе или
• нажмите Ctrl+P и найдите «auto-route», или
• щёлкните индикатор Автомаршрут вкл/выкл в строке состояния

Строка состояния показывает текущее состояние:

• Автомаршрут вкл (фиолетовый текст) — маршрутизация по сложности активна
• Автомаршрут выкл (белый текст) — маршрутизация по сложности выключена (по умолчанию)

Параметр сохраняется между сессиями в ax-code.json.

Как это работает

Источник истины

Эта страница суммирует поведение для пользователя. Когда поведение меняется, сверьте документацию с:

• packages/ax-code/src/agent/router.ts — правила маршрутизации по ключевым словам и classifyComplexity().
• packages/ax-code/src/session/prompt.ts — когда маршрутизация по ключевым словам пропускается и когда выполняется классификация сложности.
• packages/ax-code/src/server/routes/smart-llm.ts — поведение по умолчанию, окружение, конфигурация и сохранение.
• packages/ax-code/src/config/schema.ts — поля конфигурации маршрутизации и замечания об устаревании.
• packages/ax-code/src/cli/tui/app.tsx — имена команд с косой чертой, псевдонимы, подписи и действия строки состояния.
• packages/ax-code/test/agent/router.test.ts и тесты синхронизации TUI — ожидаемое поведение активации.

Не описывайте маршрутизацию по ключевым словам и маршрутизацию сложности на быстрой модели как одну возможность. Они намеренно разделены.

Маршрутизация по ключевым словам (активна по умолчанию, <1 мс)

Сообщения пользователя сопоставляются с шаблонами ключевых слов и регулярных выражений каждого агента-специалиста (security, architect, debug, perf, devops, test). Если совпадение набирает уверенность ≥ 0.4, агент может переключиться сразу — вызов LLM не делается. Этот путь не зависит от переключателя автомаршрута, но пропускается, если маршрутизация выключена, пользователь явно называет агента или текущий ход сохраняет существующего агента для синтетического продолжения.

Маршрутизация по сложности (только автомаршрут, ~200–500 мс)

Когда автомаршрут включён, каждое сообщение уходит быстрой и дешёвой модели через classifyComplexity(). Этот вызов LLM возвращает оценку сложности (low / medium / high):

• сообщения сложности low автоматически используют явно настроенный small_model
• сообщения medium и high по-прежнему используют модель по умолчанию
• пропускается, если small_model отсутствует или недоступен
• тайм-аут 1,5 секунды — тихий запасной путь, если LLM медленный или недоступен
• все ошибки ловятся молча — пользователя это никогда не блокирует

Маршрутизация по сложности не зависит от маршрутизации агентов. Она не классифицирует, какого специалиста использовать: это целиком делает маршрутизация по ключевым словам.

С чем помогает автомаршрут

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

Недостатки и соображения

Задержка

Маршрутизация по сложности добавляет 200–500 мс к сообщениям, которые вызывают классификацию. Маршрутизация по ключевым словам (всегда активна) не затрагивается: она возвращается быстрее чем за 1 мс в любом случае.

Нужна малая модель

Маршрутизации по сложности нужна явная конфигурация small_model. AX Code не выводит помощника из имён моделей и не переносит недоступное закрепление к другому провайдеру. Без пригодного помощника классификация пропускается, а выбранная основная модель сохраняется. См. Восстановление модели.

Использование токенов

Каждый вызов классификации тратит примерно 100–200 входных токенов и 10–20 выходных токенов — пренебрежимо мало рядом с последующим основным вызовом LLM.

Не замена явному выбору

Автомаршрут улучшает автоматический выбор уровня модели, но не может направить к специалистам по одной только естественной речи. Для критичных задач, где важен верный специалист, надёжнее явно выбрать агента в выборе агента или упоминанием @agent.

Конфигурация

Переключение из TUI

Используйте /smart-llm или палитру команд (Ctrl+P → «Включить или выключить автомаршрут»). Изменение действует сразу и сохраняется в ax-code.json проекта.

Файл конфигурации

{
  "routing": {
    "llm": true
  }
}

Переменная окружения

AX_CODE_SMART_LLM=true ax-code

Переменная окружения перекрывает параметр файла конфигурации.

Автомаршрут и другие параметры

Когда включать автомаршрут

Включайте, если:

• хотите, чтобы простые вопросы автоматически шли на более дешёвую и быструю модель
• хотите снизить стоимость токенов на обменах низкой сложности
• работаете с провайдером, у которого есть надёжная малая или flash-модель

Оставьте выключенным, если:

• предпочитаете нулевую добавленную задержку на каждом сообщении
• работаете офлайн или с ненадёжной сетью
• хотите минимизировать использование токенов
• всегда явно закрепляете модель