Обзор Relevance Studio
Что такое Relevance Studio, 16 админ-панелей сгруппированных в 5 областей (Релевантность, LTR, Health & Scale, Cross-region, Аналитика и отладка) и когда использовать Studio.
Relevance Studio — это закрытая для администраторов панель управления
для настройки, наблюдения и масштабирования AACsearch. Она поставляется
как набор из 16 панелей внутри apps/saas и намеренно отделена от
повседневного Dashboard: Studio — это место, где search-инженер или
платформенный владелец тюнят ранжирование, запускают LTR-эксперименты,
следят за здоровьем кластера, управляют межрегиональной репликацией и
отлаживают путь чтения.
Если вы редактор контента и правите синонимы или curations, используйте Dashboard → Настройка релевантности. Studio — более тяжёлая поверхность: требует роль администратора и позволяет менять ранжирование для всей организации.
Доступ
- Гейт по роли: Studio требует
adminилиownerв активной организации. Пользователи с рольюmemberвидят баннер 403. - Гейт по тарифу: области LTR и Cross-region дополнительно требуют тариф Scale или выше (см. Тарифы и лимиты).
- Маршрут:
/[orgSlug]/studio/<область>/<панель>.
Дерево поверхностей Studio
16 панелей сгруппированы в 5 областей. Дерево ниже соответствует тому, что отрисовывает боковая панель в SaaS-приложении.
flowchart LR
classDef area fill:#dbeafe,stroke:#1d4ed8,color:#1e3a8a
classDef panel fill:#fef3c7,stroke:#b45309,color:#78350f
classDef root fill:#ede9fe,stroke:#6d28d9,color:#4c1d95
Root["Relevance Studio<br/>(только админ)"]:::root
Root --> Relevance["1 · Релевантность"]:::area
Root --> LTR["2 · Learning to Rank"]:::area
Root --> Health["3 · Health & Scale"]:::area
Root --> CrossRegion["4 · Cross-region"]:::area
Root --> Analytics["5 · Аналитика и отладка"]:::area
Relevance --> R1["Веса полей"]:::panel
Relevance --> R2["Бусты и затухание"]:::panel
Relevance --> R3["Пресеты"]:::panel
Relevance --> R4["Персонализация"]:::panel
LTR --> L1["Обратная связь по кликам"]:::panel
LTR --> L2["Прогоны обучения"]:::panel
LTR --> L3["Модели"]:::panel
LTR --> L4["A/B-тесты"]:::panel
Health --> H1["Здоровье кластера"]:::panel
Health --> H2["Планировщик ёмкости"]:::panel
Health --> H3["Лог медленных запросов"]:::panel
CrossRegion --> C1["Карта реплик"]:::panel
CrossRegion --> C2["Дашборд лага"]:::panel
Analytics --> A1["Инспектор запросов"]:::panel
Analytics --> A2["Объяснитель ранжирования"]:::panel
Analytics --> A3["Воспроизведение аудита"]:::panelПять областей кратко
1 · Релевантность
Статические, редакторские ручки, формирующие ранжирование до применения выученной модели.
| Панель | Что настраивает |
|---|---|
| Веса полей | query_by_weights по полям (напр. title:4, brand:2, description:1) |
| Бусты и затухание | Бусты числовых полей (свежесть цены, популярность, гео-затухание) |
| Пресеты | Именованные комплекты весов + фильтров, повторно используемые в SDK |
| Персонализация | Бусты профиля, segment-rank, реранкинг сессии (см. Персонализация) |
2 · Learning to Rank (LTR)
Полный конвейер, управляемый обратной связью: приём кликов → дебиас → обучение → A/B-тест → активация.
| Панель | Роль в цикле |
|---|---|
| Обратная связь по кликам | Сырые клики + сводка коррекции позиционного смещения |
| Прогоны обучения | Запуск, мониторинг и инспекция обучающих заданий |
| Модели | Версионированные обученные модели с метриками (NDCG, MRR, AUC) |
| A/B-тесты | Эксперименты со сплитом трафика и значимостью по z-критерию |
Полный поток LTR описан на отдельной странице — см. Learning to Rank.
3 · Health & Scale
Операционная видимость кластера Typesense и конвейера загрузки.
| Панель | Показывает |
|---|---|
| Здоровье кластера | Статус узлов, запас памяти, возраст снапшота |
| Планировщик ёмкости | Прогноз количества документов, RAM на p50/p95, рекомендуемый узел |
| Лог медленных запросов | p99-запросы по индексам с выводом explain |
4 · Cross-region
Мульти-региональная репликация и failover — только тариф Scale.
| Панель | Показывает |
|---|---|
| Карта реплик | Где реплицирован каждый индекс (primary + read-реплики) |
| Дашборд лага | Лаг репликации по регионам в секундах, с порогами алёртов |
5 · Аналитика и отладка
Форензика по конкретному запросу и инструменты воспроизводимости.
| Панель | Назначение |
|---|---|
| Инспектор запросов | Переиграть любой исторический запрос с точно теми же входами ранжирования |
| Объяснитель ранжирования | Разбор скоринга документа (текст + бусты + LTR + персонализация) |
| Воспроизведение аудита | Каждая правка из Studio, повлиявшая на ранжирование в выбранном окне |
Когда использовать Studio
Studio — правильный выбор, если нужно ответить на один из таких вопросов:
- "Почему этот товар во вторник упал на 12-ю позицию?" → Объяснитель ранжирования
- "Улучшаются ли клики после новых весов title?" → A/B-тесты + Обратная связь по кликам
- "Какой запас до перехода на узел побольше?" → Планировщик ёмкости
- "EU-реплика отстаёт?" → Дашборд лага
- "Почему 'electric guitar' медленный?" → Лог медленных запросов + Инспектор запросов
- "Стоит ли персонализировать выдачу для залогиненных пользователей?" → Персонализация
Для чисто редакторских задач (добавить синоним, закрепить товар) оставайтесь
в Dashboard — он доступен всем местам, включая
роль member.
Читать дальше
- Персонализация — профили, сегменты, реранкинг сессии, рекомендации.
- Learning to Rank — обратная связь по кликам, обучение, A/B-тесты, активация.
- Архитектура → Цикл обратной связи аналитики — событийный конвейер, который читает Studio.
- Dashboard → Настройка релевантности — редакторский аналог.
Аналитический контур обратной связи
Как поисковый запрос становится SearchUsageEvent, как фиксируются клики и конверсии и как агрегация питает дашборд для настройки релевантности.
Персонализация
Профили пользователей, сегменты, реранкинг сессии и рекомендации в Relevance Studio. Как personalize=true + sessionId подключают буст профиля к ранжированию, и лучшие практики по PII.