# AI Review Pros/Cons Synthesizer: kompletny przewodnik

> Dokumentacja instalacji i konfiguracji modułu AI Review Pros/Cons Synthesizer: dostawcy AI, źródła opinii, generowanie masowe, wielojęzyczny cron i wyświetlanie.

- Strona: <https://www.datafirefly.com/pl/documentation/dfreviewsynth/>
- Język: pl
- Zaktualizowano: 2026-07-31
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfreviewsynth/index.md), [en](https://www.datafirefly.com/en/documentation/dfreviewsynth/index.md), [es](https://www.datafirefly.com/es/documentation/dfreviewsynth/index.md), [de](https://www.datafirefly.com/de/documentation/dfreviewsynth/index.md), [it](https://www.datafirefly.com/it/documentation/dfreviewsynth/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfreviewsynth/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfreviewsynth/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

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

**Warto wiedzieć.** Instalacja tworzy dedykowaną tabelę cache oraz ukrytą zakładkę administracyjną, używaną wyłącznie do wywołań generowania.

## 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`

**Wskazówka.** Przy kolejnym zapisie zostaw pole klucza puste, aby zachować już zapamiętany klucz: ze względów bezpieczeństwa nigdy nie jest on wyświetlany ponownie.

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

**Uwaga.** Token cron jest poufny. W razie wycieku wygeneruj go ponownie na stronie konfiguracji: stary adres natychmiast przestanie działać.

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