Nowość w Endora Commerce: wbudowany CRM z szansami sprzedażowymi Zobacz →
Endora Commerce

Integracja z Meilisearch

Meilisearch jest silnikiem wyszukiwania katalogu w Endora Commerce: osobny indeks dla każdego kanału sprzedaży, podpowiedzi w trakcie pisania i filtrowanie po atrybutach, a cena kupującego zawsze z cennika, nigdy z indeksu.

Dlaczego wyszukiwanie działa na osobnym silniku?

Meilisearch to otwartoźródłowy silnik wyszukiwania pełnotekstowego napisany w języku Rust, który można uruchomić u siebie albo kupić jako usługę Meilisearch Cloud. W Endora Commerce jest częścią standardowego stosu, obok PostgreSQL i Redisa, a nie dodatkiem z wyższego planu.

Dla katalogu B2B liczą się trzy jego cechy: tolerancja literówek, wyniki zwracane w trakcie pisania i filtrowanie po dowolnych zadeklarowanych polach. Platforma celuje w czas odpowiedzi wyszukiwarki poniżej 200 ms w 95. percentylu, a demo działa na katalogu ponad 120 tysięcy SKU.

Co trafia do indeksu, a co celowo nie

Każdy kanał sprzedaży ma własny indeks, więc portal dystrybutora i publiczny sklep mogą mieć różny asortyment i nie widzą nawzajem swoich produktów. W indeksie leży jeden dokument na produkt: SKU, nazwa, opis, typ, kategorie, atrybuty i adres głównego zdjęcia. Nazwa jest zapisywana w domyślnym języku kanału, z uwzględnieniem nadpisań treści ustawionych dla kanału i języka.

O tym, po czym da się szukać i filtrować, decydują flagi atrybutów w katalogu. Atrybut oznaczony jako wyszukiwalny trafia do pól przeszukiwanych, oznaczony jako filtrowalny do pól filtrów, a zmiana flagi odświeża ustawienia indeksu. Dla atrybutów typu lista wyboru indeksowana jest też etykieta opcji w języku kanału, więc kupujący wpisujący „Czerwony” znajdzie produkt, którego wartość w bazie to klucz red.

W dokumencie nie ma ceny. W B2B cena zależy od kupującego, a jeden dokument na produkt nie pomieści cennika każdej organizacji. Meilisearch zwraca więc identyfikatory trafień, a platforma dociąga produkty z bazy, odrzuca te, których dany kupujący nie może widzieć, i wylicza cenę z jego cennika. Jak działa ta część, opisuje wpis o silniku cenowym.

Jak indeks nadąża za katalogiem

  • Utworzenie, zmiana i archiwizacja produktu wywołują zdarzenie katalogu, które aktualizuje albo usuwa pojedynczy dokument. Zdarzenie przechodzi przez tę samą kolejkę Redis, która obsługuje webhooki i pocztę.
  • Proces roboczy co pewien czas przebudowuje indeksy w całości. Odstęp jest ustawieniem, domyślnie 10 minut.
  • Pełną przebudowę można wymusić z panelu albo poleceniem CLI, które odtwarza indeks każdego kanału z PostgreSQL.

Indeks nie jest więc źródłem prawdy. Można go skasować i zbudować od nowa, nic się nie gubi.

Co widzi kupujący, a co ustawia administrator

W nagłówku sklepu działa pole z podpowiedziami: po krótkiej pauzie w pisaniu pojawia się lista produktów, po której można poruszać się strzałkami. Pełna strona wyników to ten sam widok co listing katalogu, z tymi samymi filtrami, paginacją i sortowaniem według trafności, daty dodania albo nazwy. Formularz działa także bez JavaScriptu.

Ustawienia wyszukiwarki są osobne dla każdego kanału:

UstawienieWartość domyślna
Liczba produktów w podpowiedziach8
Minimalna długość frazy uruchamiająca popup3 znaki
Wyszukiwanie hybrydowewyłączone

Każda zatwierdzona fraza jest zapisywana razem z kanałem i liczbą wyników, również wtedy, gdy wynik był pusty. Zapis odbywa się w tle i nie opóźnia odpowiedzi sklepu.

Wyszukiwanie hybrydowe

Po włączeniu trybu hybrydowego platforma podpina do indeksu kanału embedder, a Meilisearch łączy dopasowanie fraz z dopasowaniem znaczeniowym. Embedder to dowolny punkt zgodny z API OpenAI: samo OpenAI, Azure OpenAI albo lokalnie uruchomiona Ollama, jeśli dane katalogu nie mają opuszczać Twojej infrastruktury. Panel nie pozwoli włączyć trybu, dopóki dla kanału nie podano adresu, klucza i modelu, a wyłączenie przywraca zwykły ranking leksykalny.

Gdy Meilisearch nie odpowiada

Awaria silnika nie blokuje zapisu produktów i nie wyłącza katalogu. Listing przechodzi wtedy na zapytanie do PostgreSQL: bez tolerancji literówek, ale sklep dalej sprzedaje. Sonda gotowości platformy sprawdza wyszukiwarkę razem z bazą i cache.

Przed uruchomieniem

Po stronie Meilisearch potrzebna jest działająca instancja (własna albo w Meilisearch Cloud), jej adres i klucz API, które podaje się w konfiguracji backendu. W trybie produkcyjnym Meilisearch wymaga ustawienia klucza głównego. Indeksy platforma zakłada sama.

Warto znać kilka ograniczeń silnika:

  • W zapytaniu uwzględnianych jest najwyżej 10 słów, więc wklejony długi opis techniczny zostanie obcięty.
  • Jedno wyszukiwanie zwraca domyślnie do 1000 dokumentów.
  • Domyślnie dopuszczana jest jedna literówka w słowach od 5 znaków i dwie od 9 znaków. To zachowanie silnika opisane w dokumentacji tolerancji literówek i warto je sprawdzić na własnych danych, jeśli katalog opiera się na podobnych do siebie numerach katalogowych.

Sprawdźmy, co da się podłączyć u Ciebie

Umów bezpłatną konsultację. Przejdziemy przez Twój ERP, magazyn i procesy sprzedaży, i pokażemy, jak wygląda ścieżka integracji krok po kroku.

Michał Zabielski, założyciel i CEO Endory

Michał Zabielski

Założyciel i CEO Endory

Odpowiadamy w ciągu jednego dnia roboczego.