4.5 KiB
Оркестрирование секретаря (23.10, спринт 3)
Решение об архитектуре
Секретарь остаётся единым входом — разбор намерений и проверка ролей только там. Профильные боты — исполнители со своими командами.
Почему не разносить разбор по ботам:
| Причина | Эффект |
|---|---|
| Одна точка разбора | нет девяти разных парсеров |
| Одна проверка прав | _role_gate в одном dispatch |
| Один журнал решений | routing.jsonl |
| Новый бот = набор команд | не нужно копировать логику входа |
Цепочка обработки
1. намерение → конкретная команда бота (сильные намерения)
2. маршрут по словам → бот.dispatch
3. готовый ответ из /intent (слабые намерения)
4. RAG по документации
5. пожелание + эскалация владельцу
Приоритет: «сильные» намерения (recommend, stats, who, similar, play, infra, books, photos, home, digest) идут в пункт 1. Слабое find уступает
маршруту по словам — иначе любая фраза превращалась в поиск.
Маршрут по словам: скоринг
Раньше выбирался бот по самому длинному совпавшему слову. Теперь:
score = длина_слова × вес_бота
Веса: DIGEST 1.2 (длинные фразы «что нового»), SEARCH 0.8 (частые
глаголы не должны перебивать домен), остальные 1.0.
Побеждает максимальный score среди доступных ботов. Все кандидаты
сохраняются в след (candidates) — видно, почему выбран именно этот.
Журнал решений
/var/lib/hub-bots/routing.jsonl:
{"at": "2026-10-23T20:21:49", "user": "@akadmin:...", "text": "статус бэкапов",
"trace": {"intent": "infra", "bot": "INFRA", "command": "статус",
"via": "intent-command"}, "answered": true}
Поле via: intent-command · route · intent-answer.
Команда !маршрут
Только владелец. Показывает разбор любой фразы:
!маршрут найди дюну
намерение: find (источник: rules)
извлечённое название: «дюну»
цепочка: бот MEDIA, команда поиск
маршрут по словам: SEARCH (слово «найди»)
кандидаты: SEARCH(4.0), MEDIA(1.0)
Проверка на 11 фразах
| Фраза | Намерение | Цепочка | Маршрут |
|---|---|---|---|
| включи музыку на кухне | play | MEDIA/включи | MEDIA |
| статус бэкапов | infra | INFRA/статус | INFRA |
| покажи книги Стругацкого | books | BOOK/поиск | BOOK |
| фотографии за лето | photos | PHOTO/поиск | PHOTO |
| что нового за неделю | digest | DIGEST/дайджест | DIGEST |
| температура в комнате | home | HOME/статус | HOME |
| найди дюну | find | маршрут | SEARCH |
| что посмотреть вечером | recommend | MEDIA/что посмотреть | MEDIA |
| сколько фильмов | stats | MEDIA/статистика | MEDIA |
| кто дома | who | HOME/кто дома | — |
| найди матрицу | find | маршрут | SEARCH |
Ловушка, которую поймал
Первый патч оркестрирования не сохранил файл (забыл write в скрипте
правки), при этом напечатал «таблица маршрутов заменена». Проверка маркеров
после применения это выявила: _intent_route вызывался, но не был определён.
Вывод: после любого патча проверять наличие маркеров в файле и синтаксис, а не доверять сообщению «готово».