Как настроить semanticRatio в Meilisearch для артикулов и смысловых запросов

Порядок действий

1. Соберите минимум три класса вопросов: точный код, описание синонимами и смешанная фраза.
2. Назначьте каждому вопросу ожидаемые document IDs и допустимые позиции в top-5.
3. Выполните три одинаковых запроса с semanticRatio 0, 0.5 и 1; меняйте только значение ratio.
4. Подберите промежуточную настройку по качеству и p95; для важного SKU задайте отдельный серверный маршрут, если необходимо.
5. После выбора проверьте отложенную выборку, на которой параметры не подбирались, и оставьте возможность отката.

После каждого шага сохраняйте ID операции или задачи, связанные с тестом версии модели, а не только HTTP-статус. Если задача окончилась ошибкой, не скрывайте её повторным запросом к поиску: сначала устраняйте причину. Применение к Meilisearch Cloud и самостоятельной установке зависит от доступности endpoint и полномочий ключа; здесь используются точные имена HTTP API из официальной документации, но не выдуманные пункты интерфейса.

Готовый запрос или шаблон

POST /indexes/products/search
{"q":"SKU-42 устройство для взбивания теста",
 "hybrid":{"embedder":"products-v1","semanticRatio":0.5},
 "limit":5,"showRankingScore":true}

Никогда не копируйте заглушки URL, API key, model ID или тестовые vectors в рабочую систему без замены и проверки. Векторы длины три демонстрируют контракт данных; они не представляют реальную языковую модель и не позволяют обещать заданный порядок поисковых результатов.

Пример входа и ожидаемого результата

Вход: A с точным артикулом SKU-42, B с описанием «венчик для густого теста», C — аксессуар другого артикула. Для запроса SKU-42 ожидайте A в первых позициях; для «чем взбить густое тесто» заранее отметьте B как релевантный. Для смешанного запроса проверьте A и B без обещания фиксированного порядка: он зависит от данных и модели.

Что важно при внедрении

Доля семантики не равна линейной вероятности правильного ответа и не гарантирует, что каждый поиск даст равное число результатов двух типов. Ведите таблицу per-query: есть ли нужный ID в top-5, сколько времени заняла генерация query vector и не был ли вытеснен точный код. Если ratio 1 улучшает синонимы, но губит буквальные SKU, сегментируйте интерфейс либо снимайте намерение на backend, не прячьте ошибку в средней метрике. Если ratio 0 быстро отрабатывает, но не видит перефразирования, проверьте успешность индексирования vectors до изменения веса. Для финансовых/медицинских ответов одного поискового score недостаточно: генерация должна опираться на проверяемый текст, а не на близость чисел.

Сравнение решений

Сравнивайте режимы на фиксированном наборе вопросов и ID: табличные свойства указывают механизм, а не гарантируют результат на вашем корпусе.

Критерии проверки

• Три режима сравниваются на одних IDs и неизменном индексе.
• Точные артикула не теряются на контрольных кейсах.
• Синонимы находятся без буквального слова.
• Зафиксированы top-k и p95, не только выбранный ratio.