«Нелогично» нужно превратить в пару документов: какой результат ожидался выше, какой оказался выше и по какому запросу. Сохраните точный Query DSL, analyzer version, index alias, document IDs, `_score`, sort values и время. Без этого команда сравнивает разные индексы, персональные контексты или уже обновлённые документы.

Не начинайте с большого boost точному полю. Он способен исправить один скриншот и вытеснить хорошие результаты для сотен других запросов. Сначала спросите Elasticsearch, какие части запроса дали баллы каждому документу, а затем отделите текстовое соответствие от popularity, freshness, маржи и ручных правил.

Порядок меняется на нескольких этапах

ЭтапЧто может поднять документКак увидеть
MatchingAnalyzer, synonyms, поля, operatormatched_queries и highlights
Lexical scoringTerm frequency, rarity, field length_explain или explain=true
Business signalsPopularity, freshness, priorityNamed function и рассчитанное значение
RescorePhrase match или дорогая модельRescore window и второй score
Explicit sortЦена, дата, stock flagsort array; `_score` может не определять порядок
Tie-breakОдинаковые score/sort valuesПоследнее стабильное поле сортировки

Search API умеет вернуть подробности вычисления score, а отдельный `_explain/{id}` объясняет конкретный документ. Эти режимы добавляют работу и предназначены для диагностики, поэтому не включайте explain для всего production traffic. Достаточно двух-трёх document IDs на воспроизводимом запросе.

Сравниваем два explain рядом

POST products/_explain/SKU-17
{
  "query": {
    "bool": {
      "must": [{"multi_match": {"query": "красная кружка", "fields": ["name^3", "description"]}}],
      "should": [{"rank_feature": {"field": "sales_rank"}}]
    }
  }
}

compare:
  name exact contribution
  description token contribution
  sales_rank contribution
  final combination

Проверьте analyzer через реальный indexed token, а не по исходному `_source`: stemming, synonyms и стоп-слова меняют совпадение. Если запрос использует explicit `sort` по цене, по умолчанию порядок уже не равен `_score`; включение track_scores лишь показывает score, но не возвращает ему первенство.

Бизнес-сигналу нужна ограниченная шкала

text_score = 7.4
raw_sales_30d = 18000

wrong: final = text_score * raw_sales_30d
safer hypothesis:
  popularity = saturation(sales_rank, pivot)
  final = text_score * (1 + 0.25 * popularity)

record: query, doc_id, text_score, popularity, final_score, rule_version

Function score позволяет комбинировать исходный score и функции через multiply, sum, replace и другие режимы. Сигналы разных масштабов нельзя складывать вслепую: большая сырая выручка уничтожит различия текста. Ограничьте вклад, предусмотрите missing value и версионируйте формулу, чтобы старый эксперимент можно было воспроизвести.

Дорогой сигнал применяем только к кандидатам

Rescore переупорядочивает верхнее окно кандидатов вторым, обычно более дорогим запросом. Это подходит для phrase match или модели, но документ вне initial window уже не вернётся наверх. Одинаковый window_size нужно сохранять при pagination, иначе границы страниц могут сдвигаться. Для ручного pinning задайте срок и owner, иначе каталог постепенно превращается в список исключений.

Приёмка проходит на запросах, а не на средней позиции

  1. Собрать набор реальных запросов с релевантными и нерелевантными товарами.
  2. Выделить exact SKU, бренд, категорию, длинный запрос и запрос без хорошего ответа.
  3. Зафиксировать baseline метрики и критичные парные ожидания.
  4. Изменить один analyzer, boost или business signal.
  5. Запустить rank evaluation и отдельно проверить latency на холодном и обычном кеше.
  6. Провести canary с логированием rule version и возможностью быстрого отката alias или template.

Для разбора понадобятся mapping, analyzer settings, search template, два `_explain`, пример explicit sort, distribution бизнес-полей и десять-двадцать размеченных запросов. Исправление принято, когда спорная пара меняется по понятной причине, качество всего набора не падает, порядок стабилен при повторе и дополнительный ranking укладывается в latency budget.

Проверенные источники