AI Review Pros/Cons Synthesizer: kompletny przewodnik

Moduł AI Review Pros/Cons Synthesizer czyta opinie klientów o produkcie i generuje z nich przez sztuczną inteligencję podsumowanie w postaci odznak Zalety i Wady, wyświetlanych bezpośrednio na karcie produktu. Podsumowania trafiają do cache per produkt, język i sklep, a cron odświeża je automatycznie.

Wprowadzenie

Gdy karta gromadzi setki opinii, mało kto je czyta. Moduł kondensuje ten sygnał w kilku czytelnych odznakach, uzupełnionych neutralnym zdaniem podsumowującym i licznikiem wzmianek. Obsługiwani są trzej dostawcy AI: Mistral AI, OpenAI i Anthropic (Claude). Każde podsumowanie powstaje w języku karty, co odpowiada potrzebom katalogów wielojęzycznych.

Wymagania

• PrestaShop 8.0 do 9.x (jeden sklep lub multisklep).
• PHP 7.4 do 8.x z aktywnym rozszerzeniem cURL.
• Źródło opinii: oficjalny moduł Product Comments albo DataFirefly Reviews.
• Klucz API u dostawcy AI (Mistral, OpenAI lub Anthropic).

Instalacja

1. W panelu administracyjnym otwórz Moduły > Menedżer modułów > Wgraj moduł.
2. Wybierz archiwum dfreviewsynth.zip i zainstaluj.
3. Kliknij Konfiguruj, aby przejść do ustawień.

Konfiguracja

Dostawca AI i klucz API

Wybierz dostawcę (Mistral, OpenAI lub Anthropic), wklej swój klucz API i podaj wybrany model:

• Mistral: mistral-small-latest
• OpenAI: gpt-4o-mini
• Anthropic: claude-haiku-4-5

Źródło opinii

Wskaż pochodzenie opinii. Adapter Product Comments czyta komentarze zatwierdzone i nieusunięte. Adapter DataFirefly Reviews czyta aktywne opinie; jeśli Twój schemat bazy się różni, dostosuj nazwy kolumn w klasie dostępu do danych.

Pozycja wyświetlania

Na karcie produktu dostępne są dwa miejsca: pod krótkim opisem (informacje dodatkowe) albo na dole karty.

Progi i cache

• Minimalna liczba opinii: poniżej tej wartości podsumowanie nie jest generowane.
• Maksymalna liczba odznak na stronę: ogranicza liczbę wyświetlanych Zalet i Wad.
• Maksymalna liczba opinii wysyłanych do AI: ogranicza zużycie tokenów (pierwszeństwo mają najnowsze opinie).
• Czas życia cache (dni): używany przez cron do odświeżania nieaktualnych podsumowań.

Generowanie podsumowań

Konsola administracyjna

Na stronie konfiguracji konsola pozwala wczytać produkty kwalifikujące się do podsumowania (te, które osiągają minimalny próg opinii), a następnie generować podsumowania pojedynczo lub masowo, z paskiem postępu. Generowanie odbywa się w bieżącym języku panelu administracyjnego.

Wielojęzyczny cron

Aby automatycznie utrzymywać aktualność wszystkich języków, zaplanuj regularne wywołanie adresu cron wyświetlanego w konfiguracji:

/index.php?fc=module&module=dfreviewsynth&controller=cron&token=TWOJ_TOKEN&limit=20

Parametr limit ogranicza liczbę produktów przetwarzanych w jednym uruchomieniu (domyślnie 20, maksymalnie 100). Cron przechodzi przez każdy aktywny język i regeneruje wyłącznie podsumowania brakujące, błędne lub nieaktualne.

Wyświetlanie po stronie klienta

Na karcie produktu moduł wyświetla blok „Co mówią klienci” z dwiema kolumnami (Zalety na zielono, Wady na pomarańczowo), opcjonalnym neutralnym zdaniem podsumowującym, liczbą uwzględnionych opinii i licznikiem wzmianek przy każdej odznace. Dla przejrzystości wobec klientów można wyświetlać adnotację „podsumowanie wygenerowane przez AI”.

Katalog wielojęzyczny

Każde podsumowanie jest przechowywane per produkt, język i sklep. Treść powstaje w języku karty, a cron synchronizuje wszystkie aktywne języki. Podsumowanie jest regenerowane tylko wtedy, gdy zmieni się treść opinii (wykrywane przez odcisk treści) albo gdy cache wygaśnie.

Rozwiązywanie problemów

• Żadna odznaka się nie wyświetla. Sprawdź, czy produkt osiąga minimalną liczbę opinii i czy podsumowanie zostało faktycznie wygenerowane (konsola lub cron).
• Status „błąd” w konsoli. Zweryfikuj klucz API, nazwę modelu i dostępność cURL; szczegóły ostatniego błędu są zachowane w cache.
• Opinie nie są wykrywane. Potwierdź wybrane źródło, a w przypadku DataFirefly Reviews zgodność kolumn w adapterze.

Historia wersji

• 1.0.0: pierwsza wersja publiczna. Podsumowanie Zalety / Wady przez AI (Mistral, OpenAI, Anthropic), wielojęzyczny cache, konsola administracyjna i cron odświeżający.