Files
buryan-infra/ops/media/AGENT.md
T
buryan-agent 03d20b95db Агент по графу: понимает вопросы словами, без LLM
agent.py разбирает фразу в план (намерение, персона, жанр, тема, эпоха,
оценка) и выполняет запрос. Словарь берётся из графа, поэтому агент знает
только то, что есть в медиатеке.

Понимает русские синонимы (фантастика → science fiction, искусственный
интеллект → artificial intelligence, робот → robot) и транслитерацию имён
(«фильмы Нолана» → Christopher Nolan). Эпохи в любом виде, оценки по словам.

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

Вызовы: команда «агент», свободный текст Медиа-бота, и «найди» с падением
в граф, когда в Jellyfin пусто.

Проверено: Нолан → Interstellar; ИИ по десятилетиям (1980-е 1, 1990-е 1,
2000-е 2, 2010-е 2); похоже на Дюну → 8 фильмов; высокорейтинговые 80-х →
Blade Runner; «найди про роботов с рейтингом» → 7 фильмов.

Попутно: /pick получил фильтры по персоне и оценке; /compare сравнивает
книгу и фильм (общие и разные жанры, автор, связь экранизации); поиск ядра
понимает русские окончания (Дюну → Dune).

Ловушки: явная команда первым словом (иначе «похоже» перехватывало запрос),
порог основы для коротких слов, и восстановление аналитических функций,
случайно срезанных при замене do_pick.
2026-10-20 11:39:22 +03:00

3.6 KiB
Raw Blame History

Агент по графу

Понимает вопрос словами и сам выбирает, что спросить у графа. Работает без 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) — восстановлены. Урок: перед заменой блока проверять, что ещё внутри.