AI Review Pros/Cons Synthesizer – Complete handleiding

De module AI Review Pros/Cons Synthesizer leest de klantbeoordelingen van een product en genereert er via artificiële intelligentie een samenvatting van in badges Voordelen en Nadelen, rechtstreeks getoond op de productpagina. De samenvattingen worden gecachet per product, taal en winkel, en automatisch ververst via een cron.

Presentatie

Wanneer een productpagina honderden beoordelingen verzamelt, leest bijna geen enkele bezoeker ze allemaal. De module condenseert dat signaal tot enkele duidelijke badges, vergezeld van een neutrale samenvattingszin en een vermeldingsteller. Drie AI-providers worden ondersteund: Mistral AI, OpenAI en Anthropic (Claude). Elke samenvatting wordt geproduceerd in de taal van de productpagina, wat geschikt is voor meertalige catalogi.

Vereisten

• PrestaShop 8.0 tot 9.x (single- of multistore).
• PHP 7.4 tot 8.x met de cURL-extensie actief.
• Een beoordelingsbron: de officiële module Product Comments, of DataFirefly Reviews.
• Een API-sleutel bij een AI-provider (Mistral, OpenAI of Anthropic).

Installatie

1. Open in de backoffice Modules > Modulebeheer > Een module uploaden.
2. Selecteer het archief dfreviewsynth.zip en installeer.
3. Klik op Configureren om de instellingen te openen.

Configuratie

AI-provider en API-sleutel

Kies de provider (Mistral, OpenAI of Anthropic), plak uw API-sleutel en vul het gewenste model in:

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

Bron van de beoordelingen

Selecteer de herkomst van de beoordelingen. De adapter Product Comments leest de goedgekeurde, niet-verwijderde commentaren. De adapter DataFirefly Reviews leest de actieve beoordelingen; pas indien nodig de kolomnamen aan in de datatoegangsklasse als uw schema afwijkt.

Weergavepositie

Twee posities zijn beschikbaar op de productpagina: onder de korte beschrijving (aanvullende informatie) of onderaan de productpagina.

Drempels en cache

• Minimum aantal beoordelingen: daaronder wordt geen samenvatting gegenereerd.
• Maximum aantal badges per kant: beperkt het aantal getoonde Voordelen en Nadelen.
• Maximum aantal beoordelingen naar de AI: begrenst het tokenverbruik (de meest recente beoordelingen krijgen voorrang).
• Levensduur van de cache (dagen): gebruikt door de cron om verouderde samenvattingen te verversen.

De samenvattingen genereren

Beheerconsole

Op de configuratiepagina laadt de console de in aanmerking komende producten (die de minimumdrempel aan beoordelingen halen) en genereert vervolgens de samenvattingen per stuk of in bulk, met voortgangsbalk. De generatie gebeurt in de actieve taal van de backoffice.

Meertalige cron

Om alle talen automatisch up-to-date te houden, plant u een regelmatige aanroep van de cron-URL die in de configuratie wordt getoond:

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

De parameter limit begrenst het aantal verwerkte producten per uitvoering (standaard 20, maximaal 100). De cron doorloopt elke actieve taal en regenereert alleen de ontbrekende, mislukte of verouderde samenvattingen.

Weergave aan klantzijde

Op de productpagina toont de module een blok “Wat klanten zeggen” met twee kolommen (Voordelen in het groen, Nadelen in het oranje), een optionele neutrale samenvattingszin, het aantal meegenomen beoordelingen en een vermeldingsteller per badge. Een vermelding “samenvatting gegenereerd door AI” kan worden getoond voor transparantie richting de klanten.

Meertalige catalogus

Elke samenvatting wordt opgeslagen per product, taal en winkel. De inhoud wordt gegenereerd in de taal van de productpagina, en de cron synchroniseert alle actieve talen. Een samenvatting wordt alleen geregenereerd wanneer de inhoud van de beoordelingen wijzigt (detectie via fingerprint) of wanneer de cache verloopt.

Probleemoplossing

• Er wordt geen enkele badge getoond. Controleer of het product het minimum aantal beoordelingen haalt en of er daadwerkelijk een samenvatting is gegenereerd (console of cron).
• Status “fout” in de console. Controleer de API-sleutel, de modelnaam en de beschikbaarheid van cURL; het detail van de laatste fout wordt in de cache bewaard.
• Beoordelingen worden niet gedetecteerd. Bevestig de geselecteerde bron en, voor DataFirefly Reviews, de overeenstemming van de kolommen in de adapter.

Versiegeschiedenis

• 1.0.0 — Eerste publieke versie: AI-samenvatting Voordelen / Nadelen (Mistral, OpenAI, Anthropic), meertalige cache, beheerconsole en verversingscron.