PS PrestaShop Początkujący

FAQ AI Produkt — Kompletny przewodnik instalacji i konfiguracji

Instalacja i konfiguracja Product FAQ AI 4.0.0: połączenie z Claude lub OpenAI, ustawienia treści, sprawdzanie wersji roboczych, generowanie masowe z budżetem, dostępne wyświetlanie i dane strukturalne.

Zaktualizowano Wersja modułu 4.0.0

Product FAQ AI za pomocą AI (Anthropic Claude lub OpenAI) pisze FAQ do stron produktów w Twoim sklepie PrestaShop wyłącznie na podstawie danych z Twojego katalogu. Odpowiedzi są zapisywane jako wersje robocze: czytasz je, w razie potrzeby poprawiasz, a następnie zatwierdzasz, zanim pojawią się na stronie produktu w akordeonie obsługiwanym z klawiatury i działającym bez JavaScriptu.

Wersja 4.0.0. Moduł napisany od nowa: PrestaShop 1.7.8, 8 i 9, PHP od 7.1 do 8.5, back office w 8 językach, wersje robocze ze sprawdzaniem, generowanie masowe z szacowaniem kosztu i budżetem, dziennik zużycia, 5 stylów akordeonu. Aktualizacja z wersji 3.x zachowuje Twoje FAQ, ich kolejność, widoczność i ustawienia.

Wymagania

  • PrestaShop 1.7.8, 8.x lub 9.x, motyw Classic, Hummingbird lub motyw, który wywołuje jeden z dostępnych hooków strony produktu.
  • PHP od 7.1 do 8.5 z rozszerzeniami cURL i OpenSSL (szyfrowanie klucza API).
  • Konto Anthropic (console.anthropic.com) lub OpenAI (platform.openai.com) z kluczem API. Wywołania są rozliczane przez dostawcę na Twoim własnym koncie.
  • Serwer musi mieć możliwość wykonywania wychodzących żądań HTTPS do api.anthropic.com lub api.openai.com.

Instalacja i aktualizacja

  1. W Moduły > Menedżer modułów kliknij Załaduj moduł i wybierz productfaqai-4.0.0.zip.
  2. Moduł tworzy tabelę ps_product_faq i trzy tabele techniczne (ps_productfaqai_job, ps_productfaqai_job_item, ps_productfaqai_usage), rejestruje swoje hooki oraz ukryty kontroler administracyjny.
  3. Kliknij Konfiguruj: zakładka Połączenie AI przeprowadzi Cię przez konfigurację klucza API.

Aktualizacja z wersji 3.x. Wgraj plik zip 4.0.0 na poprzednią wersję. Nic nie jest usuwane: FAQ aktywne w 3.x staje się „opublikowane”, FAQ nieaktywne staje się wersją roboczą. Klucz API zapisany jawnym tekstem zostaje zaszyfrowany, identyfikatory modeli są zastępowane aktualnymi modelami (na przykład claude-haiku-4-5-20251001 przez claude-haiku-5-5, gpt-4o-mini przez gpt-6-luna), a położenie displayProductFooter, którego nie wywołuje ani Classic, ani Hummingbird, zmienia się na displayFooterProduct, jeśli Twój motyw go nie używa.

Pulpit

Pulpit pokazuje odsetek aktywnych produktów z opublikowanym FAQ, liczbę produktów z wersjami roboczymi do sprawdzenia, wydatki w bieżącym miesiącu w odniesieniu do Twojego limitu oraz orientacyjny koszt 1000 FAQ przy wybranym modelu. Pokrycie jest przedstawione według języka: opublikowane FAQ, tylko wersje robocze lub brak FAQ.

Product FAQ AI dla PrestaShop: pulpit z pokryciem FAQ według języka i wydatkami w miesiącu
Pulpit z pokryciem FAQ według języka i wydatkami w miesiącu

Połączenie z dostawcą AI

Kreator obejmuje trzy kroki: wybór dostawcy, wklejenie klucza, wybór modelu. Klucz jest najpierw testowany bezpłatnym wywołaniem Models API dostawcy; zostaje zapisany tylko wtedy, gdy test się powiedzie.

Product FAQ AI dla PrestaShop: kreator połączenia z testem klucza API
Kreator połączenia z testem klucza API

Klucz jest przechowywany w bazie w postaci zaszyfrowanej (AES-256-GCM). Nigdy więcej nie jest wyświetlany (widoczne są tylko 4 ostatnie znaki), nigdy nie jest wysyłany do przeglądarki ani zapisywany w logach. Aby go zastąpić, wklej nowy klucz.

Wybór modelu

Lista zawiera modele dostępne na Twoim koncie, odczytane przez Models API podczas testu. Przy zalecanych modelach widać ich orientacyjną cenę cennikową i szacowany koszt 1000 FAQ przy Twoich ustawieniach. Bez testu wyświetlana jest lista zapasowa.

  • Anthropic: claude-opus-5-5 (domyślny, najlepsza jakość), claude-sonnet-5-5 (zrównoważony), claude-haiku-5-5 (szybki i ekonomiczny).
  • OpenAI: gpt-6.1-sol (domyślny), gpt-6-astra, gpt-6.1-terra, gpt-6-luna, gpt-5.4-mini, gpt-5.4-nano.
Product FAQ AI dla PrestaShop: wybór modelu Claude z ceną orientacyjną i kosztem 1000 FAQ
Wybór modelu Claude z ceną orientacyjną i kosztem 1000 FAQ

Wysiłek rozumowania jest domyślnie ustawiony na „Niski”: pisanie FAQ na podstawie danych produktu to proste zadanie, a wyższy wysiłek wydłuża czas i zwiększa liczbę tokenów.

Ustawienia treści

Wybierz liczbę pytań na produkt (od 1 do 15), długość odpowiedzi (krótka, średnia, szczegółowa) i ton (profesjonalny, przyjazny, swobodny, techniczny, entuzjastyczny lub uspokajający). Możesz określić grupę docelową i instrukcje dotyczące stylu, na przykład „zwracaj się do klienta per Pan/Pani”.

Product FAQ AI dla PrestaShop: ustawienia treści: liczba pytań, długość i ton
Ustawienia treści: liczba pytań, długość i ton

Instrukcje dotyczące stylu nie mogą znieść zasad modułu: korzystanie wyłącznie z faktów zawartych w danych produktu, zakaz zmyślania cen, terminów dostawy, gwarancji, certyfikatów czy twierdzeń zdrowotnych, pisanie zwykłym tekstem. Informację handlową (gwarancja, zwroty) wpisz w opisie produktu lub dodaj pytanie ręcznie.

Wysyłane dane: nazwa, krótki i długi opis, wymiary i waga są wysyłane zawsze; kategoria główna, marka, cechy produktu i warianty – zależnie od Twoich ustawień. Dane klientów, zamówień i pracowników nigdy nie są wysyłane.

Nowe produkty: opcja „Dodawaj nowe produkty do kolejki FAQ” nie wywołuje AI podczas zapisywania produktu; pulpit pokazuje oczekujące produkty, a Ty uruchamiasz kolejkę, kiedy chcesz. Publikacja bez sprawdzania to osobna opcja, domyślnie wyłączona.

Produkty i edytor FAQ

Zakładka Produkty i FAQ wyświetla listę produktów sklepu, a dla każdego języka liczbę pytań opublikowanych lub roboczych oraz ostrzeżenia. Możesz filtrować produkty bez FAQ, z wersjami roboczymi lub z opublikowanym FAQ.

Product FAQ AI dla PrestaShop: lista produktów ze stanem FAQ według języka
Lista produktów ze stanem FAQ według języka

Edytor otwiera FAQ produktu w wybranym języku:

  • Wygeneruj FAQ: zastępuje wersje robocze w danym języku; już opublikowane pytania są zachowywane, chyba że poprosisz o ich zastąpienie.
  • Wygeneruj ponownie pojedyncze pytanie: nowa wersja, różna od pozostałych pytań, zostaje zapisana jako robocza.
  • Zmień kolejność metodą przeciągnij i upuść lub strzałkami, edytuj, usuń lub dodaj pytanie ręcznie.
  • Zatwierdź pojedyncze pytanie lub użyj Zatwierdź i opublikuj wszystko. Na stronie produktu pojawiają się tylko opublikowane wpisy.
Product FAQ AI dla PrestaShop: edytor FAQ: zatwierdzanie, ponowne generowanie pytania, zmiana kolejności
Edytor FAQ: zatwierdzanie, ponowne generowanie pytania, zmiana kolejności

Ostrzeżenia weryfikacyjne

Każda odpowiedź wskazuje fakty z danych produktu, na których oparło się AI. Moduł wyświetla ostrzeżenie, gdy jakiejś liczby nie ma w danych produktu, gdy odpowiedź mówi o gwarancji, dostawie, zwrotach, certyfikacji lub zdrowiu, choć dane produktu nic o tym nie mówią, albo gdy nie przytoczono żadnego faktu. Wpis z ostrzeżeniem nigdy nie jest publikowany automatycznie.

Product FAQ AI dla PrestaShop: wersje robocze z ostrzeżeniem o liczbie i obietnicy, których brak w danych produktu
Wersje robocze z ostrzeżeniem o liczbie i obietnicy, których brak w danych produktu

Dane wysyłane do AI

Przycisk Dane wysyłane do AI pokazuje dokładnie, co moduł przekazuje dla tego produktu: instrukcje (identyczne dla wszystkich produktów, dzięki czemu mogą być przechowywane w pamięci podręcznej) i wiadomość o produkcie, wraz z szacunkową liczbą tokenów i kosztem.

Product FAQ AI dla PrestaShop: podgląd danych produktu wysyłanych do AI, bez danych klientów
Podgląd danych produktu wysyłanych do AI, bez danych klientów

Generowanie masowe

Wybierz języki, produkty (tylko te bez FAQ lub wszystkie aktywne produkty), ewentualnie listę ID oraz to, co ma się stać po wygenerowaniu (wersje robocze do sprawdzenia – zalecane – lub publikacja wpisów bez ostrzeżeń). Kliknij Oszacuj koszt: przed jakąkolwiek wysyłką moduł pokazuje liczbę produktów × języków, szacowaną liczbę tokenów i zakres kosztu, z instrukcjami w pamięci podręcznej i bez niej.

Product FAQ AI dla PrestaShop: generowanie masowe z szacunkiem kosztu przed uruchomieniem
Generowanie masowe z szacunkiem kosztu przed uruchomieniem
  • Kolejka posuwa się krótkimi krokami, dopóki strona modułu jest otwarta: bez niekończących się żądań, bez zadania cron.
  • Blokada uniemożliwia przetwarzanie tej samej kolejki w dwóch kartach lub przez dwóch pracowników; w każdym sklepie aktywna jest tylko jedna kolejka.
  • Kolejka zatrzymuje się po osiągnięciu budżetu uruchomienia i limitu miesięcznego. Możesz ją wstrzymać, wznowić, anulować lub ponowić błędne pozycje (3 próby na produkt).
  • Jeśli dostawca odrzuca wszystkie żądania (klucz, środki, model), kolejka zostaje wstrzymana z komunikatem wskazującym, co należy poprawić.

Tryb oszczędny: żądania są wysyłane do Message Batches API Anthropic lub Batch API OpenAI, za mniej więcej połowę ceny. Wyniki przychodzą zwykle w ciągu kilku godzin, najpóźniej w ciągu 24 godzin, i są pobierane, gdy strona modułu jest otwarta.

Product FAQ AI dla PrestaShop: kolejka generowania w trybie oszczędnym (batch) z postępem i budżetem
Kolejka generowania w trybie oszczędnym (batch) z postępem i budżetem

Koszty, budżet i dziennik

Ustaw domyślny budżet uruchomienia masowego, limit miesięczny (dla wszystkich generowań łącznie) oraz maksymalną liczbę tokenów na odpowiedź. Dziennik wymienia każde wywołanie: operację, produkt, język, model, tokeny wejściowe, wyjściowe i odczytane z pamięci podręcznej zgodnie z danymi zwróconymi przez dostawcę, orientacyjny koszt i ewentualny błąd.

Product FAQ AI dla PrestaShop: budżet, limit miesięczny i dziennik zużycia tokenów
Budżet, limit miesięczny i dziennik zużycia tokenów

Stosowane ceny to orientacyjne ceny cennikowe sprawdzone 11.11.2026. Szacunek przyjmuje około 3,5 znaku na token: to rząd wielkości. Wiążąca jest faktura Twojego dostawcy.

Wyświetlanie na stronie produktu

W zakładce Wyświetlanie wybierz styl, kolor akcentu, otwieranie pierwszego pytania, położenie na stronie i tytuł bloku w każdym języku. Położenie, którego Twój motyw nie wywołuje, jest sygnalizowane.

Product FAQ AI dla PrestaShop: ustawienia wyświetlania: style akordeonu, położenie i dane strukturalne
Ustawienia wyświetlania: style akordeonu, położenie i dane strukturalne

Dostępnych jest pięć stylów: minimalny, karty, ramka, przyciski + i wszystko otwarte. Blok korzysta z natywnych elementów HTML <details> i <summary>: działa z klawiatury (Tab, Enter, Spacja) i z czytnikami ekranu, bez żadnego pliku JavaScript. HTML jest generowany przez serwer, więc nic się nie przesuwa podczas ładowania strony, a arkusz stylów jest ładowany tylko na stronach produktów, które wyświetlają FAQ.

Product FAQ AI dla PrestaShop: FAQ na stronie produktu, styl minimalny (Hummingbird)
FAQ na stronie produktu, styl minimalny (Hummingbird)
Product FAQ AI dla PrestaShop: FAQ na stronie produktu, styl karty
FAQ na stronie produktu, styl karty
Product FAQ AI dla PrestaShop: FAQ na stronie produktu, styl ramka
FAQ na stronie produktu, styl ramka
Product FAQ AI dla PrestaShop: FAQ na stronie produktu, styl przyciski + z kolorem akcentu
FAQ na stronie produktu, styl przyciski + z kolorem akcentu
Product FAQ AI dla PrestaShop: FAQ ze wszystkimi odpowiedziami widocznymi
FAQ ze wszystkimi odpowiedziami widocznymi
Product FAQ AI dla PrestaShop: strona produktu Hummingbird z blokiem FAQ
Strona produktu Hummingbird z blokiem FAQ
Product FAQ AI dla PrestaShop: FAQ na telefonie, dostępne z klawiatury i bez JavaScriptu
FAQ na telefonie, dostępne z klawiatury i bez JavaScriptu

Dane strukturalne FAQPage

Moduł może dodać znaczniki schema.org FAQPage (JSON-LD) do stron produktów, które wyświetlają FAQ. Opcja jest domyślnie wyłączona.

Google w sierpniu 2023 ograniczył wyniki rozszerzone FAQ do wiarygodnych witryn rządowych i medycznych, a 7 maja 2026 przestał je pokazywać dla wszystkich witryn. Znaczniki pozostają poprawnym schema.org i nie szkodzą, ale nie dają żadnego wyniku rozszerzonego w Google: nie oczekuj od nich korzyści SEO.

Jeśli włączysz tę opcję, a moduł DataFirefly All in One SEO już wyświetla blok FAQPage na stronie, Product FAQ AI nie dodaje drugiego; ustawienia drugiego modułu nigdy nie są zmieniane. JSON-LD jest kodowany tak, aby pozostał poprawny i nigdy nie mógł zamknąć znacznika script.

Bezpieczeństwo i poufność

  • Tekst produktu jest umieszczany w wydzielonym bloku danych i traktowany jako treść niezaufana: opis, który zawierałby instrukcje („zignoruj instrukcje…”), pozostaje zwykłymi danymi.
  • Odpowiedź AI jest ograniczona schematem JSON, a następnie oczyszczana: wyłącznie zwykły tekst, bez HTML, linków, adresów e-mail i Markdownu.
  • Akcje w back office przechodzą przez kontroler chroniony tokenem; zapisy wymagają żądania POST modułu i uprawnienia „edycja” do zakładki Product FAQ AI. Pracownik, który ma tylko uprawnienie „podgląd”, może przeglądać dane, ale nie może generować ani edytować.
  • Multistore: ustawienia, klucz, FAQ, kolejka i dziennik są odrębne dla każdego sklepu; aby skonfigurować moduł, wybierz jeden sklep.

Rozwiązywanie problemów

  • „Dostawca odrzucił klucz (401)”: sprawdź klucz w konsoli dostawcy lub utwórz nowy, a następnie wklej go ponownie.
  • „Nieznany lub niedostępny model (404)”: wybierz inny model; przycisk Testuj zapisany klucz ponownie wczytuje listę z Twojego konta.
  • Brak środków lub limit rozliczeń: doładuj konto u dostawcy, a następnie wznów kolejkę.
  • Zbyt wiele żądań (429), usługa przeciążona: moduł już ponowił próbę z zachowaniem czasu oczekiwania wskazanego przez dostawcę; poczekaj lub użyj trybu oszczędnego.
  • Ucięta odpowiedź: zwiększ maksymalną liczbę tokenów na odpowiedź albo poproś o mniej pytań lub krótsze odpowiedzi.
  • Odmowa dostawcy: sprawdź tekst produktu lub napisz pytania ręcznie.
  • FAQ się nie wyświetla: sprawdź, czy pytania są opublikowane w przeglądanym języku i czy wybrane położenie jest wywoływane przez Twój motyw (ostrzeżenie w zakładce Wyświetlanie).

Odinstalowanie

Odinstalowanie usuwa wszystkie FAQ, kolejkę generowania, dziennik zużycia, ustawienia i kontroler administracyjny. Wymagane jest potwierdzenie.

Czy ta strona była pomocna?

Nadal utknąłeś? Napisz do wsparcia