AI Review Pros/Cons Synthesizer – Vollständige Anleitung

Das Modul AI Review Pros/Cons Synthesizer liest die Kundenbewertungen eines Produkts und erstellt mittels KI eine Zusammenfassung als Pro– und Contra-Badges, die direkt auf der Produktseite angezeigt werden. Die Synthesen werden pro Produkt, Sprache und Shop zwischengespeichert und automatisch über einen Cron aktualisiert.

Überblick

Wenn eine Produktseite Hunderte Bewertungen ansammelt, lesen nur wenige Besucher sie. Das Modul verdichtet dieses Signal zu einigen klaren Badges, mit einer neutralen Zusammenfassungszeile und einem Erwähnungszähler. Drei KI-Anbieter werden unterstützt: Mistral AI, OpenAI und Anthropic (Claude). Jede Synthese entsteht in der Sprache der Seite, was sich für mehrsprachige Kataloge eignet.

Voraussetzungen

• PrestaShop 8.0 bis 9.x (Einzel- oder Multishop).
• PHP 7.4 bis 8.x mit aktivierter cURL-Erweiterung.
• Eine Bewertungsquelle: das offizielle Modul Product Comments oder DataFirefly Reviews.
• Ein API-Schlüssel eines KI-Anbieters (Mistral, OpenAI oder Anthropic).

Installation

1. Öffnen Sie im Back-Office Module > Modul-Manager > Modul hochladen.
2. Wählen Sie das Archiv dfreviewsynth.zip aus und installieren Sie es.
3. Klicken Sie auf Konfigurieren, um die Einstellungen zu öffnen.

Konfiguration

KI-Anbieter und API-Schlüssel

Wählen Sie den Anbieter (Mistral, OpenAI oder Anthropic), fügen Sie Ihren API-Schlüssel ein und geben Sie das gewünschte Modell an:

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

Bewertungsquelle

Wählen Sie, woher die Bewertungen stammen. Der Adapter Product Comments liest freigegebene, nicht gelöschte Kommentare. Der Adapter DataFirefly Reviews liest aktive Bewertungen; passen Sie bei Bedarf die Spaltennamen in der Datenzugriffsklasse an, falls Ihr Schema abweicht.

Anzeigeposition

Zwei Positionen stehen auf der Produktseite zur Verfügung: unter der Kurzbeschreibung (Zusatzinformationen) oder im Produktfuß.

Schwellenwerte und Cache

• Mindestanzahl Bewertungen: darunter wird keine Synthese erzeugt.
• Maximale Badges pro Seite: begrenzt die Anzahl der angezeigten Pro- und Contra-Punkte.
• Maximale an die KI gesendete Bewertungen: begrenzt den Token-Verbrauch (die neuesten Bewertungen haben Vorrang).
• Cache-Lebensdauer (Tage): vom Cron verwendet, um veraltete Synthesen zu aktualisieren.

Synthesen erzeugen

Admin-Konsole

Auf der Konfigurationsseite lädt die Konsole die infrage kommenden Produkte (die den Mindestschwellenwert erreichen) und erzeugt dann die Synthesen einzeln oder als Massenvorgang mit Fortschrittsbalken. Die Generierung läuft in der aktuellen Back-Office-Sprache.

Mehrsprachiger Cron

Um alle Sprachen automatisch aktuell zu halten, planen Sie einen regelmäßigen Aufruf der in der Konfiguration angezeigten Cron-URL:

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

Der Parameter limit begrenzt, wie viele Produkte pro Durchlauf verarbeitet werden (Standard 20, Maximum 100). Der Cron durchläuft jede aktive Sprache und erzeugt nur fehlende, fehlerhafte oder veraltete Synthesen neu.

Anzeige im Shop

Auf der Produktseite zeigt das Modul einen Block „Was Kunden sagen“ mit zwei Spalten (Pro in Grün, Contra in Orange), einer optionalen neutralen Zusammenfassungszeile, der Anzahl der berücksichtigten Bewertungen und einem Erwähnungszähler pro Badge. Ein Hinweis „von KI erzeugte Zusammenfassung“ kann zur Transparenz gegenüber Kunden angezeigt werden.

Mehrsprachiger Katalog

Jede Synthese wird pro Produkt, Sprache und Shop gespeichert. Der Inhalt wird in der Sprache der Seite erzeugt, und der Cron synchronisiert alle aktiven Sprachen. Eine Synthese wird nur neu erzeugt, wenn sich der Inhalt der Bewertungen ändert (Erkennung über einen Fingerabdruck) oder wenn der Cache abläuft.

Fehlerbehebung

• Es werden keine Badges angezeigt. Prüfen Sie, ob das Produkt die Mindestanzahl an Bewertungen erreicht und ob eine Synthese erzeugt wurde (Konsole oder Cron).
• Status „Fehler“ in der Konsole. Überprüfen Sie den API-Schlüssel, den Modellnamen und die Verfügbarkeit von cURL; das Detail des letzten Fehlers wird im Cache aufbewahrt.
• Bewertungen nicht erkannt. Bestätigen Sie die gewählte Quelle und, für DataFirefly Reviews, die Spaltenzuordnung im Adapter.

Änderungsprotokoll

• 1.0.0 — Erste öffentliche Version: KI-Synthese von Pro / Contra (Mistral, OpenAI, Anthropic), mehrsprachiger Cache, Admin-Konsole und Aktualisierungs-Cron.