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.
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.comlubapi.openai.com.
Instalacja i aktualizacja
- W Moduły > Menedżer modułów kliknij Załaduj moduł i wybierz
productfaqai-4.0.0.zip. - Moduł tworzy tabelę
ps_product_faqi trzy tabele techniczne (ps_productfaqai_job,ps_productfaqai_job_item,ps_productfaqai_usage), rejestruje swoje hooki oraz ukryty kontroler administracyjny. - 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.

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.

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.

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”.

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.

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.

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.

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.

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.

- 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.

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.

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.

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.







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.