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

58 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Агент по графу
Понимает вопрос словами и сам выбирает, что спросить у графа. Работает без
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`) — восстановлены. Урок: перед заменой блока проверять,
что ещё внутри.