# AI Review Pros/Cons Synthesizer – Vollständige Anleitung

> Installations- und Konfigurationsanleitung für das Modul AI Review Pros/Cons Synthesizer: KI-Anbieter, Bewertungsquellen, Massengenerierung, mehrsprachiger Cron und Anzeige.

- Seite: <https://www.datafirefly.com/de/documentation/dfreviewsynth/>
- Sprache: de
- Aktualisiert am: 2026-06-17
- Weitere Sprachen: [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), [it](https://www.datafirefly.com/it/documentation/dfreviewsynth/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfreviewsynth/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfreviewsynth/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfreviewsynth/index.md)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

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.

**Gut zu wissen.** Die Installation legt eine eigene Cache-Tabelle und einen versteckten Admin-Tab an, der nur für die Generierungsaufrufe dient.

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

**Tipp.** Lassen Sie das Schlüsselfeld beim erneuten Speichern leer, um den gespeicherten Schlüssel zu behalten: Er wird aus Sicherheitsgründen nie wieder angezeigt.

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

**Achtung.** Das Cron-Token ist vertraulich. Bei einem Leck erzeugen Sie es auf der Konfigurationsseite neu: Die alte URL funktioniert sofort nicht mehr.

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