# AI Review Pros/Cons Synthesizer – Guide complet

> Documentation d'installation et de configuration du module AI Review Pros/Cons Synthesizer : fournisseurs IA, sources d'avis, génération en masse, cron multilingue et affichage.

- Page: <https://www.datafirefly.com/documentation/dfreviewsynth/>
- Langue: fr
- Mis à jour le: 2026-06-17
- Autres langues: [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), [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/documentation/llms.txt>

Le module **AI Review Pros/Cons Synthesizer** lit les avis clients d'un produit et en génère, par intelligence artificielle, une synthèse en badges **Avantages** et **Inconvénients** affichés directement sur la fiche produit. Les synthèses sont mises en cache par produit, langue et boutique, et rafraîchies automatiquement via un cron.

## Présentation

Quand une fiche cumule des centaines d'avis, peu de visiteurs les lisent. Le module condense ce signal en quelques badges clairs, accompagnés d'une phrase de résumé neutre et d'un compteur de mentions. Trois fournisseurs IA sont pris en charge : Mistral AI, OpenAI et Anthropic (Claude). Chaque synthèse est produite dans la langue de la fiche, ce qui convient aux catalogues multilingues.

## Prérequis

- PrestaShop 8.0 à 9.x (mono ou multiboutique).
- PHP 7.4 à 8.x avec l'extension cURL active.
- Une source d'avis : le module officiel _Product Comments_, ou _DataFirefly Reviews_.
- Une clé API auprès d'un fournisseur IA (Mistral, OpenAI ou Anthropic).

## Installation

1. Dans le back-office, ouvrez **Modules > Gestionnaire de modules > Envoyer un module**.
2. Sélectionnez l'archive `dfreviewsynth.zip` puis installez.
3. Cliquez sur **Configurer** pour accéder aux réglages.

**Bon à savoir.** L'installation crée une table de cache dédiée et un onglet d'administration masqué servant uniquement aux appels de génération.

## Configuration

### Fournisseur IA et clé API

Choisissez le **fournisseur** (Mistral, OpenAI ou Anthropic), collez votre **clé API** et renseignez le **modèle** souhaité :

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

**Astuce.** Laissez le champ de clé vide lors d'un nouvel enregistrement pour conserver la clé déjà mémorisée : elle n'est jamais réaffichée pour des raisons de sécurité.

### Source des avis

Sélectionnez l'origine des avis. L'adaptateur _Product Comments_ lit les commentaires approuvés et non supprimés. L'adaptateur _DataFirefly Reviews_ lit les avis actifs ; ajustez au besoin le nom des colonnes dans la classe d'accès aux données si votre schéma diffère.

### Position d'affichage

Deux emplacements sont disponibles sur la fiche produit : **sous la description courte** (informations complémentaires) ou **en pied de fiche**.

### Seuils et cache

- **Nombre minimum d'avis** : en deçà, aucune synthèse n'est générée.
- **Badges maximum par côté** : limite le nombre d'Avantages et d'Inconvénients affichés.
- **Avis maximum envoyés à l'IA** : plafonne la consommation de jetons (les avis les plus récents sont prioritaires).
- **Durée de vie du cache (jours)** : utilisée par le cron pour rafraîchir les synthèses obsolètes.

## Générer les synthèses

### Console d'administration

Dans la page de configuration, la console permet de charger les produits éligibles (ceux qui atteignent le seuil minimum d'avis), puis de générer les synthèses à l'unité ou en masse, avec barre de progression. La génération s'effectue dans la langue courante du back-office.

### Cron multilingue

Pour maintenir automatiquement à jour toutes les langues, planifiez un appel régulier à l'URL de cron affichée dans la configuration :

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

Le paramètre `limit` plafonne le nombre de produits traités par exécution (défaut 20, maximum 100). Le cron parcourt chaque langue active et ne régénère que les synthèses manquantes, en erreur ou obsolètes.

**Attention.** Le jeton de cron est confidentiel. En cas de fuite, régénérez-le depuis la page de configuration : l'ancienne URL cessera immédiatement de fonctionner.

## Affichage côté client

Sur la fiche produit, le module affiche un bloc « Ce que disent les clients » avec deux colonnes (Avantages en vert, Inconvénients en orange), une phrase de résumé neutre optionnelle, le nombre d'avis pris en compte et un compteur de mentions par badge. Une mention « résumé généré par IA » peut être affichée pour la transparence vis-à-vis des clients.

## Catalogue multilingue

Chaque synthèse est stockée par produit, langue et boutique. Le contenu est généré dans la langue de la fiche, et le cron synchronise l'ensemble des langues actives. Une synthèse n'est régénérée que lorsque le contenu des avis change (détection par empreinte) ou lorsque le cache arrive à expiration.

## Dépannage

- **Aucun badge ne s'affiche.** Vérifiez que le produit atteint le nombre minimum d'avis et qu'une synthèse a bien été générée (console ou cron).
- **Statut « erreur » dans la console.** Contrôlez la clé API, le nom du modèle et la disponibilité de cURL ; le détail de la dernière erreur est conservé en cache.
- **Avis non détectés.** Confirmez la source sélectionnée et, pour DataFirefly Reviews, la correspondance des colonnes dans l'adaptateur.

## Journal des versions

- **1.0.0** — Première version publique : synthèse Avantages / Inconvénients par IA (Mistral, OpenAI, Anthropic), cache multilingue, console d'administration et cron de rafraîchissement.