Перед добавлением синонимов решите, должны ли слова заменять друг друга в обе стороны. Запись эквивалентности подходит для двух названий одного понятия; направленное правило — для приведения нескольких вариантов к выбранной форме. Ошибка этого выбора расширяет выдачу сильнее, чем ожидает редактор словаря. Начните с одной пары и искусственного мини-каталога.
Откройте настройки поля, по которому реально ищет приложение, и определите поисковый анализатор — цепочку преобразования запроса в токены. Проверка другого анализатора в консоли ничего не доказывает. Ожидаемый результат теста: нужный документ добавился, а контрольный документ с похожим, но другим смыслом не получил необоснованного совпадения.
Две записи, два разных обещания
Условные правила тестового словаря:
ноутбук, лэптоп
беспроводная мышка => беспроводная мышь
Вопрос для проверки:
должна ли обратная формулировка расширяться так же?Актуальная инструкция Elastic различает эквивалентные правила через запятую и явные направленные отображения через =>. Для многословных синонимов в поисковом анализаторе рекомендован synonym_graph. Наборы синонимов, создаваемые через API или интерфейс Kibana, используются во время поиска. Проверено 14 октября 2026 года. Доступность управления и конкретную настройку сверяйте с версией и способом развёртывания своего кластера.
| Ситуация | Решение словаря | Контрольный вопрос |
|---|---|---|
| Два имени одного понятия | Эквивалентность | Разрешены ли обе стороны? |
| Приведение к канонической форме | Направленная замена | Что происходит с обратным запросом? |
| Общая и частная категория | Не объявлять автоматически равными | Не потеряется ли уточнение? |
| Разные товары с похожим названием | Оставить раздельными | Нет ли ложного расширения? |
Смотрите токены, затем выдачу
Проверка анализатора отвечает на вопрос, какое преобразование произошло. Проверка выдачи отвечает, помогло ли оно пользователю. Сохраните исходный запрос, выбранное поле, анализатор и полученные токены на стенде. После этого выполните тот же запрос через приложение: оно может добавлять фильтры, выбирать другое поле или вообще использовать точное сравнение вместо полнотекстового поиска.
- Прямой запрос должен находить согласованный документ.
- Обратный запрос соответствует выбранному направлению.
- Многословная фраза не теряет значимое уточнение.
- Контрольный посторонний товар не становится равнозначным.
- Фильтры доступности продолжают действовать.
Условный пример: редактор хочет связать разговорное название устройства с официальным, но добавляет к нему название всей категории. В выдачу попадают все устройства категории. Исправление — уточнить смысл правила и оставить проверку отрицательных примеров, а не компенсировать слишком широкое расширение постоянно растущими весами конкретных товаров.
Порядок фильтров анализатора имеет значение. Например, удаление стоп-слов может менять разбор многословного правила. Документация Elastic отдельно предупреждает о взаимодействии синонимов со stop-фильтром и об ошибках невалидных правил. Поэтому новый словарь сначала проверяется на тестовом индексе с той же цепочкой обработки, что у рабочего поля.
Обновление словаря — отдельный выпуск
Поисковые синонимы удобны тем, что их можно обновлять без полной переиндексации при поддерживаемой конфигурации. Это не универсальное обещание для любого фильтра и способа хранения. Не переносите процедуру обновления API-набора на файл без проверки документации. Держите исходный словарь, его ревизию, результат проверки и способ возврата предыдущего набора вместе.
Если часть правил не загрузилась, не объявляйте выпуск успешным только по доступности кластера. Сопоставьте принятый набор с ожидаемым и повторите запросы, ради которых делалось изменение. При откате возвращается согласованный словарь и проверяется фактическая выдача; старые результаты из прикладного кеша не должны скрывать состояние поискового анализатора.
Следующий полезный шаг — небольшой набор пар «запрос — ожидаемый товар» и отрицательных примеров для каждого нового правила. Для помощи с конкретным словарём достаточно обезличенного mapping, цепочки анализатора, версии Elasticsearch и спорной пары терминов. Пользовательские журналы целиком и доступ к рабочему кластеру для первичного разбора не нужны.