Moduł Magento 2 – Zapytaj o produkt
WARTO NAM ZAUFAĆ
25 lat doświadczenia w e-commerce i Magento 2
Szybka realizacja
Sprawny proces realizacji
Prosty i przejrzysty proces reklamacji
Współpraca z klientami na całym świecie
Darmowe aktualizacje modułów
Płatność przez PayPal i Stripe
Kowal_ZapytajOProdukt to rozbudowany modul Magento 2 do komunikacji z klientem na karcie produktu. Laczy klasyczny formularz pytan, uporzadkowane FAQ oraz Asystenta AI w jednym, spojnym rozwiazaniu.
W praktyce oznacza to, ze karta produktu przestaje byc jedynie miejscem prezentacji opisu i parametrow technicznych, a staje sie aktywnym punktem obslugi pytan klienta. Uzytkownik moze:
- zadac klasyczne pytanie o produkt,
- skorzystac z gotowych odpowiedzi opublikowanych w FAQ,
- porozmawiac z Asystentem AI, ktory odpowiada w kontekscie aktualnie ogladanego produktu.
Modul zostal zaprojektowany tak, aby rozwiazywac dwa problemy jednoczesnie:
- obslugowy, czyli ograniczyc liczbe powtarzalnych pytan trafiajacych do zespolu sklepu,
- produktowy, czyli budowac rosnaca, uporzadkowana baze wiedzy, ktora z czasem poprawia jakosc odpowiedzi.
Cel biznesowy
W wielu sklepach internetowych znaczna czesc pytan klientow powtarza sie:
- czy produkt jest kompatybilny z konkretna wersja Magento,
- czy dziala bez dodatkowego modulu,
- jak przebiega instalacja,
- czy obsluguje kilka jezykow,
- czy wymaga niestandardowych zmian w szablonie,
- jak zachowa sie w konkretnym scenariuszu biznesowym.
Bez dedykowanego narzedzia obslugi takie pytania:
- obciazaja support,
- spowalniaja decyzje zakupowe,
- rozpraszaja wiedze pomiedzy skrzynkami e-mail, ticketami i rozmowami handlowymi,
- nie wracaja do sklepu w postaci uporzadkowanego FAQ.
Ten modul porzadkuje ten proces. Najpierw zbiera pytania i odpowiedzi, pozniej porzadkuje je w FAQ, a na kolejnym etapie wykorzystuje je jako kontekst dla Asystenta AI oraz warstwy retrieval opartej o OpenAI Vector Store.
Glowna idea rozwiazania
Modul dziala warstwowo.
Warstwa 1. Klasyczne pytania o produkt
Na karcie produktu mozna uruchomic standardowy mechanizm zadawania pytan. Klient wysyla zapytanie, a administrator lub obsluga sklepu otrzymuje je do dalszej obslugi. To najprostsza i najbardziej przewidywalna forma kontaktu.
Warstwa 2. FAQ
Powtarzalne pytania i odpowiedzi moga zostac zapisane i opublikowane jako FAQ produktu. FAQ moze byc wyswietlane jako zakladka albo jako osobna sekcja na stronie produktu. Dzieki temu kolejne osoby dostaja odpowiedz bez koniecznosci wysylania nowego pytania.
Warstwa 3. Asystent AI
Nad lub pod standardowym FAQ pojawia sie lekki komponent rozmowy z AI. Uzytkownik moze:
- kliknac jedno z popularnych pytan,
- wpisac wlasne pytanie w polu
Zapytaj Asystenta o ten produkt., - zobaczyc odpowiedz w tym samym obszarze rozmowy.
Asystent nie dziala jako ogolny chatbot sklepu. Zostal zaprojektowany jako asystent produktowy, co oznacza, ze odpowiedz ma bazowac przede wszystkim na:
- danych aktualnego produktu,
- opublikowanych FAQ,
- historii biezacej rozmowy,
- opcjonalnie na wynikach retrieval z OpenAI Vector Store.
Zakres funkcjonalny modulu
1. Formularz Zapytaj o produkt
Modul udostepnia klasyczny mechanizm kontaktu z klientem.
Najwazniejsze elementy:
- przycisk lub formularz
Zapytaj o produktna stronie produktu, - obsluga AJAX po stronie frontendu,
- zapis pytania do bazy danych,
- mozliwosc wysylki powiadomienia e-mail,
- opcja wlaczenia modulu globalnie albo tylko dla wybranych produktow.
To rozwiazanie nadal ma sens nawet wtedy, gdy sklep korzysta juz z Asystenta AI. Nie kazde pytanie powinno byc obslugiwane automatycznie. Czesc spraw wymaga odpowiedzi handlowej, indywidualnej wyceny albo potwierdzenia przez zespol techniczny.
2. FAQ na karcie produktu
FAQ w tym module nie jest dodatkiem marketingowym, tylko uporzadkowana warstwa wiedzy o produkcie.
Administrator moze:
- przegladac zapisane pytania,
- dopisywac odpowiedzi,
- publikowac wybrane rekordy,
- wyswietlac je na stronie produktu.
FAQ moze byc pokazane:
- jako zakladka,
- jako oddzielna sekcja na karcie produktu.
Wazne jest to, ze FAQ nie sluzy tylko frontendowi. Opublikowane pytania i odpowiedzi sa rowniez wykorzystywane jako jeden z najwazniejszych elementow kontekstu dla Asystenta AI.
3. Asystent AI na stronie produktu
Asystent AI jest centralnym elementem rozbudowy modulu.
Komponent jest osadzony na karcie produktu, domyslnie pod galeria, i zostal przygotowany tak, aby:
- dzialac lekko po stronie frontendu,
- nie obciazac niepotrzebnie pierwszego renderu strony,
- byc czytelny na desktopie i mobile,
- nadawac sie do dalszej rozbudowy.
Uzytkownik widzi:
- tytul sekcji,
- tekst wprowadzajacy,
- pojedyncze pole tekstowe do zadawania pytania,
- liste najpopularniejszych pytan,
- obszar rozmowy, ktory rozwija sie wraz z kolejnymi pytaniami i odpowiedziami.
W aktualnej wersji formularz obsluguje takze:
- historie rozmowy w ramach sesji,
- klikane popularne pytania,
- feedback do odpowiedzi AI,
- dwa warianty kolorystyczne: jasny i ciemny.
4. Popularne pytania
Pod polem tekstowym moga byc wyswietlane najpopularniejsze pytania o produkt.
To rozwiazanie pelni kilka funkcji naraz:
- przyspiesza start rozmowy,
- podpowiada klientowi, o co najczesciej pytaja inni,
- pozwala wykorzystac gotowe odpowiedzi FAQ bez kosztu zapytania do modelu AI,
- poprawia UX i zmniejsza liczbe pustych interakcji.
Popularnosc pytan nie jest juz oparta tylko o reczna kolejnosc. Modul zbiera dane o kliknieciach, zadawanych pytaniach i feedbacku, a nastepnie na tej podstawie rankuje FAQ.
5. Kontekst odpowiedzi AI
Najwazniejszym zalozeniem projektowym bylo to, aby AI nie odpowiadalo w oderwaniu od produktu.
Odpowiedz moze byc budowana na podstawie kilku zrodel:
- podstawowych danych produktu,
- short description,
- full description,
- wybranych atrybutow produktowych,
- opublikowanych FAQ,
- historii rozmowy.
Dodatkowo modul pozwala ograniczyc, ktore atrybuty trafiaja do modelu, dzieki czemu mozna uniknac:
- przeadowania promptu,
- wysylania niepotrzebnych danych,
- zbyt wysokiego kosztu tokenow,
- przypadkowego przekazywania tresci, ktore nie sa przydatne klientowi.
6. Integracja z OpenAI Responses API i Vector Store
Jednym z kluczowych elementow rozbudowy jest integracja z OpenAI Responses API.
W prostszych scenariuszach modul moze dzialac w trybie lokalnego kontekstu produktu i FAQ. W bardziej rozbudowanych wdrozeniach wspiera:
file_search,vector_store_ids,- filtrowanie po
sku, - filtrowanie po
product_sku, - filtrowanie po
store_code, - filtrowanie po
content_type, - ograniczanie liczby wynikow retrieval,
- tryb
hybrid, - tryb
retrieval-first.
To oznacza, ze odpowiedz AI moze opierac sie nie tylko na danych przekazywanych wprost z Magento przy danym requestcie, ale rowniez na dokumentach juz wczesniej zasilonych do Vector Store.
W praktyce daje to dwie korzysci:
- nizszy koszt, bo nie trzeba za kazdym razem wysylac calego zestawu danych do modelu,
- lepsza skalowalnosc, bo retrieval moze obslugiwac wieksza baze wiedzy niz prosty prompt z lokalnym JSON.
7. Integracja z Kowal_AiProductFeed
Modul zostal przygotowany do wspolpracy z Kowal_AiProductFeed.
Ta integracja pozwala:
- synchronizowac dane produktowe do OpenAI Vector Store,
- korzystac z dokumentow typu
product.core,product.faq,product.docsi innych, - dosynchronizowac wybrany produkt przed rozmowa,
- ograniczyc retrieval do konkretnych typow tresci.
To podejscie jest szczegolnie przydatne tam, gdzie:
- opisy produktowe sa dlugie,
- FAQ jest rozbudowane,
- sklep obsluguje wiele produktow technicznych,
- dane produktowe sa stale rozwijane.
8. Analityka i feedback
Modul nie konczy sie na samym wygenerowaniu odpowiedzi.
Zapisuje rowniez dane, ktore pozwalaja ocenic, czy rozwiazanie dziala:
- liczbe klikniec w FAQ,
- liczbe zadanych pytan,
- oceny pomocna / niepomocna,
- historie rozmow,
- techniczne metadane odpowiedzi AI,
- usage tokenow,
- payload requestu i odpowiedzi, jesli wlaczysz logowanie diagnostyczne.
To sprawia, ze wdrozenie nie jest czarna skrzynka. Zespol moze analizowac:
- jakie pytania pojawiaja sie najczesciej,
- czy AI korzysta z retrieval,
- czy odpowiedzi sa trafne,
- ktore rekordy warto utrwalic jako FAQ,
- jak zmienia sie koszt i jakosc po zmianie promptu lub konfiguracji.
9. Kandydaci FAQ i workflow administracyjny
Jedna z najwazniejszych zalet modulu jest mozliwosc zamieniania rozmow w nowe FAQ.
Proces wyglada nastepujaco:
- Klienci zadaja pytania.
- Modul zapisuje rozmowy.
- Mechanizm analizy wyznacza kandydatow FAQ.
- Administrator przeglada kandydatow w panelu.
- Po akceptacji kandydat trafia do standardowego FAQ produktu.
To bardzo praktyczny model pracy, bo wiedza nie ginie w historii rozmow. Z kazda kolejna iteracja sklep buduje lepsza warstwe odpowiedzi:
- dla klientow,
- dla FAQ,
- dla Asystenta AI,
- dla przyszlego retrieval.
10. Bezpieczenstwo i kontrola
Modul zostal przygotowany tak, aby jego dzialanie dalo sie kontrolowac.
Konfiguracja obejmuje miedzy innymi:
- ograniczenia dostepu dla gosci,
- TTL rozmow,
- limity zapytan,
- sanitizacje danych wejsciowych,
- opcje logowania diagnostycznego,
- konfiguracje reCAPTCHA,
- kontrolowany zakres danych wysylanych do modelu.
To wazne, bo wdrozenie AI na stronie produktu nie powinno oznaczac utraty kontroli nad:
- kosztem,
- danymi,
- jakoscia odpowiedzi,
- obciazeniem frontendu.
11. Dla kogo jest ten modul
Modul najlepiej sprawdzi sie w projektach, gdzie:
- katalog jest wiekszy niz kilka prostych produktow,
- klienci czesto zadaja pytania o kompatybilnosc, konfiguracje albo wdrozenie,
- zespol chce laczyc klasyczne FAQ z nowoczesna warstwa AI,
- firma rozwija dokumentacje produktowa i chce ja wykorzystac w retrieval,
- wazna jest kontrola nad tym, co AI wie i skad bierze odpowiedzi.
Szczegolnie dobrze pasuje do sklepow sprzedajacych:
- moduly Magento,
- produkty techniczne,
- rozwiazania B2B,
- narzedzia wymagajace wdrozenia lub konfiguracji,
- produkty, przy ktorych klient oczekuje szybkiej i precyzyjnej odpowiedzi jeszcze przed zakupem.
12. Podsumowanie
Kowal_ZapytajOProdukt nie jest juz tylko modulem do prostego formularza kontaktowego na karcie produktu.
To pelna warstwa komunikacji produktowej, ktora:
- zbiera pytania,
- publikuje FAQ,
- odpowiada przez AI,
- wykorzystuje Vector Store,
- analizuje rozmowy,
- i zamienia je w coraz lepsza baze wiedzy sklepu.
Dzieki temu karta produktu staje sie miejscem realnej rozmowy z klientem, a nie tylko statyczna strona z opisem i cena.
Modul Magento 2 do obslugi pytan o produkt oraz Asystenta AI na karcie produktu.
Co robi modul
Modul laczy trzy obszary:
- klasyczny formularz
Zapytaj o produktz zapisem pytan i powiadomieniem e-mail, - sekcje FAQ na karcie produktu z reczna publikacja odpowiedzi,
- Asystenta AI na PDP z popularnymi pytaniami, historia rozmowy, analityka i integracja z OpenAI Vector Store.
Najwazniejsze funkcje
- przycisk i formularz pytania o produkt,
- panel administracyjny do obslugi pytan i odpowiedzi,
- FAQ jako zakladka lub osobna sekcja na stronie produktu,
- komponent rozmowy AI pod galeria produktu,
- popularne pytania oparte o dane FAQ i analityke,
- zapis rozmow i feedback odpowiedzi,
- pipeline kandydatow FAQ z review w panelu administracyjnym,
- provider
OpenAI Responses API + Vector Store, - retrieval z filtrami
sku,product_sku,store_codeicontent_type, - opcjonalna integracja z
Kowal_AiProductFeed.
Wymagania
- Magento 2
- PHP zgodne z wersja projektu
- aktywny modul
kowal/base
Opcjonalnie:
- OpenAI API key dla funkcji AI,
- modul
Kowal_AiProductFeed, jesli chcesz korzystac z dosynchronizacji danych do Vector Store przed rozmowa.
Instalacja
Composer
Add the composer repository to the configuration:
composer config repositories.zapytaj.o.produkt vcs https://github.com/kowalco/magento-2-zapytaj-o-produkt
Add an access token for the private GitLab repository:
composer config --global --auth github-oauth.github.com <YOUR_TOKEN>
composer require kowal/module-zapytajoprodukt
php bin/magento module:enable Kowal_ZapytajOProdukt
php bin/magento setup:upgrade
php bin/magento cache:flush
W srodowisku produkcyjnym zwykle wykonasz dodatkowo:
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento indexer:reindex
Podstawowa konfiguracja
Sciezka:
Stores > Configuration > Zapytaj o produkt
Minimalny start bez AI:
- wlacz modul,
- wlacz FAQ lub formularz pytan,
- opcjonalnie ustaw dodatkowy adres e-mail.
Minimalny start z AI:
Asystent AI - Ogolne > Wlacz Asystenta AI = YesAsystent AI - Provider > Provider = OpenAI Responses API + Vector Store- ustaw
Klucz APIiModel, - w
Asystent AI - KontekstwybierzOpenAI Vector Storealbo skonfiguruj fallback przezKowal_AiProductFeed, - ustaw
Tryb budowania kontekstu z Vector Store, - opcjonalnie wlacz
Pokazuj popularne pytaniaiPokazuj feedback odpowiedzi.
Uwaga wdrozeniowa
Jesli po zmianach frontendowych nie widzisz efektu na stronie produktu, odswiez cache i przebuduj statiki:
php bin/magento cache:flush
php bin/magento setup:static-content:deploy -f pl_PL en_US







