Moduł Magento 2 – Zapytaj o produkt

MAGENTO 2 · PYTANIA · FAQ · ASYSTENT AI

Kowal Zapytaj o Produkt

Połącz formularz kontaktowy, publikowane FAQ i opcjonalnego asystenta AI. Wykorzystuj dane produktu oraz bazę wiedzy, a powtarzające się rozmowy zamieniaj w odpowiedzi dostępne dla kolejnych klientów.

Formularz i FAQ · Kontekst produktu · Rozmowy i feedback

JAK TO DZIAŁA W PRAKTYCE

Kowal_ZapytajOProdukt to rozbudowany moduł Magento 2 do komunikacji z klientem na karcie produktu. Łączy klasyczny formularz pytań, uporządkowane FAQ oraz Asystenta AI w jednym, spójnym rozwiązaniu.

W praktyce oznacza to, że karta produktu przestaje być jedynie miejscem prezentacji opisu i parametrów technicznych, a staje się aktywnym punktem obsługi pytań klienta. Użytkownik może:

• zadać klasyczne pytanie o produkt,
• skorzystać z gotowych odpowiedzi opublikowanych w FAQ,
• porozmawiać z Asystentem AI, który odpowiada w kontekście aktualnie oglądanego produktu.

Moduł został zaprojektowany tak, aby rozwiązywać dwa problemy jednocześnie:

• obsługowy, czyli ograniczyć liczbę powtarzalnych pytań trafiających do zespołu sklepu,
• produktowy, czyli budować rosnącą, uporządkowaną bazę wiedzy, która z czasem poprawia jakość odpowiedzi.

W wielu sklepach internetowych znaczna część pytań klientów powtarza się:

• czy produkt jest kompatybilny z konkretną wersją Magento,
• czy działa bez dodatkowego modułu,
• jak przebiega instalacja,
• czy obsługuje kilka języków,
• czy wymaga niestandardowych zmian w szablonie,
• jak zachowa się w konkretnym scenariuszu biznesowym.

Bez dedykowanego narzędzia obsługi takie pytania:

• obciążają support,
• spowalniają decyzje zakupowe,
• rozpraszają wiedzę pomiędzy skrzynkami e-mail, ticketami i rozmowami handlowymi,
• nie wracają do sklepu w postaci uporządkowanego FAQ.

Ten moduł porządkuje ten proces. Najpierw zbiera pytania i odpowiedzi, później porządkuje je w FAQ, a na kolejnym etapie wykorzystuje je jako kontekst dla Asystenta AI oraz warstwy retrieval opartej o OpenAI Vector Store.

Moduł działa warstwowo.

Na karcie produktu można uruchomić standardowy mechanizm zadawania pytań. Klient wysyła zapytanie, a administrator lub obsługa sklepu otrzymuje je do dalszej obsługi. To najprostsza i najbardziej przewidywalna forma kontaktu.

Powtarzalne pytania i odpowiedzi mogą zostać zapisane i opublikowane jako FAQ produktu. FAQ może być wyświetlane jako zakładka albo jako osobna sekcja na stronie produktu. Dzięki temu kolejne osoby dostają odpowiedź bez konieczności wysyłania nowego pytania.

Nad lub pod standardowym FAQ pojawia się lekki komponent rozmowy z AI. Użytkownik może:

• kliknąć jedno z popularnych pytań,
• wpisać własne pytanie w polu Zapytaj Asystenta o ten produkt.,
• zobaczyć odpowiedź w tym samym obszarze rozmowy.

Asystent nie działa jako ogólny chatbot sklepu. Został zaprojektowany jako asystent produktowy, co oznacza, że odpowiedź ma bazować przede wszystkim na:

• danych aktualnego produktu,
• opublikowanych FAQ,
• historii bieżącej rozmowy,
• opcjonalnie na wynikach retrieval z OpenAI Vector Store.

Moduł udostępnia klasyczny mechanizm kontaktu z klientem.

Najważniejsze elementy:

• przycisk lub formularz Zapytaj o produkt na stronie produktu,
• obsługa AJAX po stronie frontendu,
• zapis pytania do bazy danych,
• możliwość wysyłki powiadomienia e-mail,
• opcja włączenia modułu globalnie albo tylko dla wybranych produktów.

To rozwiązanie nadal ma sens nawet wtedy, gdy sklep korzysta już z Asystenta AI. Nie każde pytanie powinno być obsługiwane automatycznie. Część spraw wymaga odpowiedzi handlowej, indywidualnej wyceny albo potwierdzenia przez zespół techniczny.

FAQ w tym module nie jest dodatkiem marketingowym, tylko uporządkowaną warstwą wiedzy o produkcie.

Administrator może:

• przeglądać zapisane pytania,
• dopisywać odpowiedzi,
• publikować wybrane rekordy,
• wyświetlać je na stronie produktu.

FAQ może być pokazane:

• jako zakładka,
• jako oddzielna sekcja na karcie produktu.

Ważne jest to, że FAQ nie służy tylko frontendowi. Opublikowane pytania i odpowiedzi są również wykorzystywane jako jeden z najważniejszych elementów kontekstu dla Asystenta AI.

Asystent AI jest centralnym elementem rozbudowy modułu.

Komponent jest osadzony na karcie produktu, domyślnie pod galerią, i został przygotowany tak, aby:

• działać lekko po stronie frontendu,
• nie obciążać niepotrzebnie pierwszego renderu strony,
• być czytelny na desktopie i mobile,
• nadawać się do dalszej rozbudowy.

Użytkownik widzi:

• tytuł sekcji,
• tekst wprowadzający,
• pojedyncze pole tekstowe do zadawania pytania,
• listę najpopularniejszych pytań,
• obszar rozmowy, który rozwija się wraz z kolejnymi pytaniami i odpowiedziami.

W aktualnej wersji formularz obsługuje także:

• historię rozmowy w ramach sesji,
• klikane popularne pytania,
• feedback do odpowiedzi AI,
• dwa warianty kolorystyczne: jasny i ciemny.

Pod polem tekstowym mogą być wyświetlane najpopularniejsze pytania o produkt.

To rozwiązanie pełni kilka funkcji naraz:

• przyspiesza start rozmowy,
• podpowiada klientowi, o co najczęściej pytają inni,
• pozwala wykorzystać gotowe odpowiedzi FAQ bez kosztu zapytania do modelu AI,
• poprawia UX i zmniejsza liczbę pustych interakcji.

Popularność pytań nie jest już oparta tylko o ręczną kolejność. Moduł zbiera dane o kliknięciach, zadawanych pytaniach i feedbacku, a następnie na tej podstawie rankuje FAQ.

Najważniejszym założeniem projektowym było to, aby AI nie odpowiadało w oderwaniu od produktu.

Odpowiedź może być budowana na podstawie kilku źródeł:

• podstawowych danych produktu,
• short description,
• full description,
• wybranych atrybutów produktowych,
• opublikowanych FAQ,
• historii rozmowy.

Dodatkowo moduł pozwala ograniczyć, które atrybuty trafiają do modelu, dzięki czemu można uniknąć:

• przeładowania promptu,
• wysyłania niepotrzebnych danych,
• zbyt wysokiego kosztu tokenów,
• przypadkowego przekazywania treści, które nie są przydatne klientowi.

Jednym z kluczowych elementów rozbudowy jest integracja z OpenAI Responses API.

W prostszych scenariuszach moduł może działać w trybie lokalnego kontekstu produktu i FAQ. W bardziej rozbudowanych wdrożeniach wspiera:

• file_search,
• vector_store_ids,
• filtrowanie po sku,
• filtrowanie po product_sku,
• filtrowanie po store_code,
• filtrowanie po content_type,
• ograniczanie liczby wyników retrieval,
• tryb hybrid,
• tryb retrieval-first.

To oznacza, że odpowiedź AI może opierać się nie tylko na danych przekazywanych wprost z Magento przy danym requestcie, ale również na dokumentach już wcześniej zasilonych do Vector Store.

W praktyce daje to dwie korzyści:

• niższy koszt, bo nie trzeba za każdym razem wysyłać całego zestawu danych do modelu,
• lepszą skalowalność, bo retrieval może obsługiwać większą bazę wiedzy niż prosty prompt z lokalnym JSON.

Moduł został przygotowany do współpracy z Kowal_AiProductFeed.

Ta integracja pozwala:

• synchronizować dane produktowe do OpenAI Vector Store,
• korzystać z dokumentów typu product.core, product.faq, product.docs i innych,
• dosynchronizować wybrany produkt przed rozmową,
• ograniczyć retrieval do konkretnych typów treści.

To podejście jest szczególnie przydatne tam, gdzie:

• opisy produktowe są długie,
• FAQ jest rozbudowane,
• sklep obsługuje wiele produktów technicznych,
• dane produktowe są stale rozwijane.

Moduł nie kończy się na samym wygenerowaniu odpowiedzi.

Zapisuje również dane, które pozwalają ocenić, czy rozwiązanie działa:

• liczbę kliknięć w FAQ,
• liczbę zadanych pytań,
• oceny pomocna / niepomocna,
• historię rozmów,
• techniczne metadane odpowiedzi AI,
• usage tokenów,
• payload requestu i odpowiedzi, jeśli włączysz logowanie diagnostyczne.

To sprawia, że wdrożenie nie jest czarną skrzynką. Zespół może analizować:

• jakie pytania pojawiają się najczęściej,
• czy AI korzysta z retrieval,
• czy odpowiedzi są trafne,
• które rekordy warto utrwalić jako FAQ,
• jak zmienia się koszt i jakość po zmianie promptu lub konfiguracji.

Jedną z najważniejszych zalet modułu jest możliwość zamieniania rozmów w nowe FAQ.

Proces wygląda następująco:

1. Klienci zadają pytania.
2. Moduł zapisuje rozmowy.
3. Mechanizm analizy wyznacza kandydatów FAQ.
4. Administrator przegląda kandydatów w panelu.
5. Po akceptacji kandydat trafia do standardowego FAQ produktu.

To bardzo praktyczny model pracy, bo wiedza nie ginie w historii rozmów. Z każdą kolejną iteracją sklep buduje lepszą warstwę odpowiedzi:

• dla klientów,
• dla FAQ,
• dla Asystenta AI,
• dla przyszłego retrieval.

Moduł został przygotowany tak, aby jego działanie dało się kontrolować.

Konfiguracja obejmuje między innymi:

• ograniczenia dostępu dla gości,
• TTL rozmów,
• limity zapytań,
• sanitizację danych wejściowych,
• opcje logowania diagnostycznego,
• konfigurację reCAPTCHA,
• kontrolowany zakres danych wysyłanych do modelu.

To ważne, bo wdrożenie AI na stronie produktu nie powinno oznaczać utraty kontroli nad:

• kosztem,
• danymi,
• jakością odpowiedzi,
• obciążeniem frontendu.

Moduł najlepiej sprawdzi się w projektach, gdzie:

• katalog jest większy niż kilka prostych produktów,
• klienci często zadają pytania o kompatybilność, konfigurację albo wdrożenie,
• zespół chce łączyć klasyczne FAQ z nowoczesną warstwą AI,
• firma rozwija dokumentację produktową i chce ją wykorzystać w retrieval,
• ważna jest kontrola nad tym, co AI wie i skąd bierze odpowiedzi.

Szczególnie dobrze pasuje do sklepów sprzedających:

• moduły Magento,
• produkty techniczne,
• rozwiązania B2B,
• narzędzia wymagające wdrożenia lub konfiguracji,
• produkty, przy których klient oczekuje szybkiej i precyzyjnej odpowiedzi jeszcze przed zakupem.

Kowal_ZapytajOProdukt nie jest już tylko modułem do prostego formularza kontaktowego na karcie produktu.

To pełna warstwa komunikacji produktowej, która:

• zbiera pytania,
• publikuje FAQ,
• odpowiada przez AI,
• wykorzystuje Vector Store,
• analizuje rozmowy,
• i zamienia je w coraz lepszą bazę wiedzy sklepu.

Dzięki temu karta produktu staje się miejscem realnej rozmowy z klientem, a nie tylko statyczną stroną z opisem i ceną.

W Stores → Configuration → Zapytaj o produkt możesz zacząć od formularza i FAQ oraz dodatkowego adresu e-mail. Funkcje AI aktywujesz osobno: ustawiasz provider, klucz API, model, zakres kontekstu i opcje Vector Store. Integracja z Kowal_AiProductFeed jest opcjonalna.

AI wymaga dostępu do API i jego osobnego rozliczania. Jakość odpowiedzi oraz koszt zależą od kontekstu, modelu i konfiguracji. Pytania wymagające indywidualnego potwierdzenia mogą trafiać do zespołu sklepu przez klasyczny formularz.

Pakiet zawiera opcjonalny Kowal_ZapytajOProduktHyva dla formularza, FAQ i asystenta AI. Adapter jest domyślnie wyłączony. Dla Hyvä aktywujesz go dodatkowo i sprawdzasz umieszczenie komponentów w używanym motywie. Sklep Luma korzysta z podstawowego modułu.

Pakiet kowal/module-zapytajoprodukt, moduł Kowal_ZapytajOProdukt. Po skonfigurowaniu dostępu do repozytorium Kowal zainstaluj pakiet, włącz moduł, zaktualizuj Magento i wyczyść cache. W produkcji uwzględnij kompilację i wdrożenie treści statycznych zgodnie z procesem sklepu.

1. Konfigurujesz komunikację
Włączasz formularz, FAQ i opcjonalnie asystenta AI.

2. Klient zadaje pytanie
Korzysta z gotowych pytań lub wpisuje własne.

3. Rozwijasz bazę wiedzy
Przeglądasz rozmowy i zatwierdzasz kandydatów FAQ.

Klient pyta o zgodność produktu. Obsługa odpowiada przez formularz, a powtarzające się pytanie może opublikować w FAQ.

Opcjonalny asystent AI wykorzystuje dane produktu, FAQ oraz skonfigurowany Vector Store. Administrator sprawdza jakość rozmów i propozycje nowych FAQ.