AI Size & Fit Advisor: kompletny przewodnik

AI Size & Fit Advisor zastępuje statyczną tabelę rozmiarów prawdziwym doradcą: klient podaje swoje wymiary na karcie produktu i otrzymuje najlepiej dopasowany rozmiar, ze wskaźnikiem pewności, alternatywą i szczegółami wymiar po wymiarze. Ten przewodnik obejmuje instalację, konfigurację, tworzenie tabel rozmiarów i działanie silnika rekomendacji.

Instalacja

1. Pobierz archiwum dfsizefit.zip ze swojego konta DataFirefly.
2. Panel administracyjny PrestaShop, potem Moduły, potem Wgraj moduł: wyślij plik ZIP.
3. Moduł tworzy swoje tabele, rejestruje hooki i dodaje zakładkę Katalog, potem Size & Fit Charts.

Konfiguracja ogólna

Przejdź do Moduły, potem AI Size & Fit Advisor, potem Konfiguruj.

Warstwa AI

Moduł działa bez AI dzięki silnikowi deterministycznemu. Możesz włączyć opcjonalną warstwę AI, aby doprecyzować decyzję według sylwetki i wygenerować wyjaśnienie w języku klienta.

• Włącz warstwę AI: gdy jest wyłączona, żadne zewnętrzne wywołanie nie jest wykonywane.
• Dostawca: Mistral, OpenAI lub Anthropic.
• Klucz API: przechowywany po stronie serwera, nigdy nie trafia do front-office.
• Model: na przykład mistral-small-latest, gpt-4o-mini lub claude-haiku-4-5.

Preferencja kroju

Włącz tę opcję, aby zaproponować klientowi wybór dopasowany / klasyczny / luźny. Moduł stosuje odchylenie ±3% na wymiarach, aby skierować rozmiar w górę lub w dół zgodnie z oczekiwanym krojem.

Fit-learning

Po włączeniu moduł loguje w sposób zanonimizowany profile i rekomendacje w dedykowanej tabeli, aby analizować trafność i wskazywać referencje, których krój wypada mały lub duży.

Jednostka i hook wyświetlania

• Jednostka domyślna: centymetry lub cale.
• Hook wyświetlania: displayProductActions (przy przycisku dodania do koszyka) lub displayProductAdditionalInfo (pod informacjami o produkcie).
• Etykieta przycisku: pozostaw puste, aby użyć domyślnego tłumaczenia „Znajdź mój rozmiar”.

Tworzenie tabeli rozmiarów

Otwórz Katalog, potem Size & Fit Charts, potem Dodaj.

Zasięg

Każda tabela ma zasięg, który określa objęte nią produkty:

• Globalny: obowiązuje dla wszystkich produktów (identyfikator pozostawiony na 0).
• Kategoria: podaj identyfikator kategorii.
• Produkt: podaj identyfikator produktu.

Rozwiązywanie działa kaskadowo: moduł szuka najpierw tabeli na poziomie produktu, potem jego kategorii, a na końcu tabeli globalnej. Używana jest pierwsza znaleziona.

Edytor siatki

Wizualny edytor działa jak arkusz: wiersz na rozmiar, kolumna na wymiar.

• Dodaj kolumnę wymiaru (obwód klatki piersiowej, talia, biodra, wewnętrzna długość nogawki, długość stopy i inne) przez selektor, a potem przycisk „Dodaj kolumnę”.
• Dodaj wiersz rozmiaru przyciskiem „Dodaj rozmiar” i nazwij go (S, M, L, 38, 40 i tak dalej).
• Dla każdej komórki podaj zakres minimum / maksimum w skonfigurowanej jednostce.
• Wybierz płeć (kobieta, mężczyzna, unisex, dziecko) i aktywuj tabelę.

Jak powstaje rekomendacja

Rekomendacja przebiega w kilku etapach:

1. Dopasowanie deterministyczne: silnik punktuje każdy rozmiar, porównując wymiary klienta z zakresami siatki (odległość od środka każdego zakresu, kara za wyjście poza zakres), a następnie stosuje odchylenie kroju.
2. Doprecyzowanie przez AI (opcjonalne): gdy warstwa AI jest aktywna, dostawca potwierdza lub koryguje rozmiar z uwzględnieniem sylwetki (wzrost, waga) i redaguje krótkie wyjaśnienie.
3. Fallback: jeśli AI zawiedzie, zachowany zostaje wynik deterministyczny.

Klient otrzymuje rekomendowany rozmiar, wskaźnik pewności, rozmiar alternatywny i szczegóły per wymiar (w zakresie, ciasno lub luźno).

Wyświetlanie po stronie klienta

Na karcie produktu przycisk „Znajdź mój rozmiar” otwiera okno modalne. Klient podaje swoje wymiary, opcjonalnie wzrost, wagę i preferencję kroju, po czym zatwierdza. Wynik pojawia się w tym samym oknie, z paskiem pewności i rozbiciem na poszczególne wymiary.

Fit-learning i analiza zwrotów

Każda rekomendacja może zostać zalogowana wraz z zanonimizowanym profilem, użytym silnikiem i wskaźnikiem pewności. Status zwrotu (zatrzymany, zwrócony za mały, zwrócony za duży) pozwala z czasem zidentyfikować problematyczne kroje i skorygować siatki.

Zgodność i uwagi techniczne

• PrestaShop 8.x i 9.x, multisklep i wielojęzyczność.
• Kontroler administracyjny legacy (bez kontrolera Symfony) dla zgodności PS8/PS9.
• Endpoint AJAX po stronie front przez link modułu; renderowanie JSON przez dedykowaną metodę.
• Dane klientów przechowywane w Twoim sklepie; do wybranego dostawcy AI trafia tylko część niezbędna do obliczeń.

FAQ i rozwiązywanie problemów

Przycisk nie pojawia się na karcie produktu. Sprawdź, czy do produktu stosuje się aktywna tabela (zasięg produktu, kategorii lub globalny) i czy wybrany hook wyświetlania jest faktycznie obsługiwany przez Twój szablon.

Rekomendacja zgłasza brak danych. Klient nie podał żadnego wymiaru odpowiadającego kolumnom siatki. Dodaj popularne kolumny (klatka piersiowa, talia, biodra) albo zachęć klienta do wypełnienia większej liczby pól.

AI nic nie zwraca. Sprawdź klucz API i nazwę modelu. Moduł i tak przełącza się na silnik deterministyczny, więc żadna rekomendacja nie zostaje utracona.