# Агент по графу Понимает вопрос словами и сам выбирает, что спросить у графа. Работает без LLM: словарь берётся из самого графа, поэтому агент знает ровно то, что есть в медиатеке. ## Намерения | Намерение | Как понять | Что делает | |---|---|---| | подбор | по умолчанию | `GET /pick` с фильтрами | | фильмография | «кто снимал», «фильмография», «с кем» | `GET /person` | | по десятилетиям | «когда», «динамика», «по годам» | `GET /timeline` | | похожее | «похоже», «вроде» | `/search` + `/similar` | | сравнение | «сравни», «что общего» | `GET /compare` | ## Как понимает слова 1. **Персоны** — напрямую латиницей или через транслитерацию: «фильмы Нолана» → `Christopher Nolan`. 2. **Жанры и темы** — словарь русских синонимов: `фантастика` → `science fiction`, `искусственный интеллект` → `artificial intelligence`, `робот` → `robot`. 3. **Эпоха** — `80-е`, `1980`, `2019`. 4. **Оценка** — «высокий рейтинг», «8+», «топ» → `высокая (8+)`. После ответа агент показывает, **как понял**: `_понял так: намерение: подбор, персона: Christopher Nolan_`. ## Мягкое ослабление условий Если с фильтрами ничего не нашлось, агент снимает их по одному в порядке оценка → тема → жанр → эпоха → персона и сообщает, что убрал. Поэтому «фильмы про роботов с высоким рейтингом» не возвращает пустоту, а находит 7 фильмов с рейтингом. ## Где живёт `/opt/hub-bots/hub/agent.py`. Вызовы: * команда `!агент <фраза>`; * свободный текст Медиа-бота с глаголами «найди», «посоветуй», «сравни», «похоже», «когда», «фильмография»; * `!find` — если в файлах Jellyfin пусто, ищет по графу. ## Ловушки * **Явная команда первым словом.** Раньше «агент похоже на Дюну» разбиралось как команда `похоже`, и агент не вызывался. Теперь первое слово, совпавшее с командой, выигрывает. * **Русские окончания.** «Дюну» не находило «Dune». Добавлена грубая основа (`stem_ru`): убираем окончания, ищем по `%дюн%`. * **Порог основы.** Условие `len(t) > len(suf) + 3` не срабатывало для коротких слов («дюну» → 4 символа). Заменено на `>=`. * **Вырезанный код.** Замена `do_pick` захватила и удалила аналитические функции (`do_timeline`, `do_cross`, `do_top_persons`, `do_graph_stats`, `do_graph_json`) — восстановлены. Урок: перед заменой блока проверять, что ещё внутри.