# AI Review Pros/Cons Synthesizer – Guida completa

> Guida all'installazione e configurazione del modulo AI Review Pros/Cons Synthesizer: fornitori IA, sorgenti recensioni, generazione in blocco, cron multilingua e visualizzazione.

- Pagina: <https://www.datafirefly.com/it/documentation/dfreviewsynth/>
- Lingua: it
- Aggiornato il: 2026-06-17
- Altre lingue: [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), [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)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

Il modulo **AI Review Pros/Cons Synthesizer** legge le recensioni dei clienti di un prodotto e, tramite IA, ne genera una sintesi sotto forma di badge **Pro** e **Contro** mostrati direttamente sulla scheda prodotto. Le sintesi sono memorizzate in cache per prodotto, lingua e negozio, e aggiornate automaticamente tramite un cron.

## Panoramica

Quando una scheda accumula centinaia di recensioni, pochi visitatori le leggono. Il modulo condensa questo segnale in pochi badge chiari, con una riga di riepilogo neutra e un contatore di menzioni. Sono supportati tre fornitori IA: Mistral AI, OpenAI e Anthropic (Claude). Ogni sintesi è prodotta nella lingua della scheda, il che è adatto ai cataloghi multilingua.

## Requisiti

- PrestaShop 8.0 fino a 9.x (mono o multinegozio).
- PHP 7.4 fino a 8.x con l'estensione cURL attiva.
- Una sorgente di recensioni: il modulo ufficiale _Product Comments_ oppure _DataFirefly Reviews_.
- Una chiave API di un fornitore IA (Mistral, OpenAI o Anthropic).

## Installazione

1. Nel back office, aprire **Moduli > Gestore dei moduli > Carica un modulo**.
2. Selezionare l'archivio `dfreviewsynth.zip` e installarlo.
3. Fare clic su **Configura** per accedere alle impostazioni.

**Da sapere.** L'installazione crea una tabella di cache dedicata e una scheda di amministrazione nascosta usata solo per le chiamate di generazione.

## Configurazione

### Fornitore IA e chiave API

Scegliere il **fornitore** (Mistral, OpenAI o Anthropic), incollare la propria **chiave API** e indicare il **modello** desiderato:

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

**Suggerimento.** Lasciare vuoto il campo della chiave al nuovo salvataggio per conservare la chiave memorizzata: per motivi di sicurezza non viene mai più mostrata.

### Sorgente delle recensioni

Selezionare l'origine delle recensioni. L'adattatore _Product Comments_ legge i commenti approvati e non eliminati. L'adattatore _DataFirefly Reviews_ legge le recensioni attive; se necessario, adattare i nomi delle colonne nella classe di accesso ai dati qualora lo schema sia diverso.

### Posizione di visualizzazione

Sulla scheda prodotto sono disponibili due posizioni: **sotto la descrizione breve** (informazioni aggiuntive) o **nel piè della scheda**.

### Soglie e cache

- **Recensioni minime**: al di sotto di questo numero non viene generata alcuna sintesi.
- **Badge massimi per lato**: limita il numero di Pro e Contro mostrati.
- **Recensioni massime inviate all'IA**: limita il consumo di token (le recensioni più recenti hanno la priorità).
- **TTL della cache (giorni)**: usato dal cron per aggiornare le sintesi obsolete.

## Generare le sintesi

### Console di amministrazione

Nella pagina di configurazione, la console consente di caricare i prodotti idonei (quelli che raggiungono la soglia minima di recensioni), quindi di generare le sintesi singolarmente o in blocco, con barra di avanzamento. La generazione avviene nella lingua corrente del back office.

### Cron multilingua

Per mantenere automaticamente aggiornate tutte le lingue, pianificare una chiamata periodica all'URL del cron mostrato nella configurazione:

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

Il parametro `limit` limita quanti prodotti vengono elaborati per esecuzione (predefinito 20, massimo 100). Il cron percorre ogni lingua attiva e rigenera solo le sintesi mancanti, in errore o obsolete.

**Attenzione.** Il token del cron è riservato. In caso di fuga, rigenerarlo dalla pagina di configurazione: il vecchio URL smette immediatamente di funzionare.

## Visualizzazione nel negozio

Sulla scheda prodotto, il modulo mostra un blocco «Cosa dicono i clienti» con due colonne (Pro in verde, Contro in arancione), una riga di riepilogo neutra opzionale, il numero di recensioni considerate e un contatore di menzioni per badge. È possibile mostrare una dicitura «riepilogo generato dall'IA» per trasparenza verso i clienti.

## Catalogo multilingua

Ogni sintesi è memorizzata per prodotto, lingua e negozio. Il contenuto è generato nella lingua della scheda e il cron sincronizza tutte le lingue attive. Una sintesi viene rigenerata solo quando cambia il contenuto delle recensioni (rilevamento tramite impronta) o quando la cache scade.

## Risoluzione dei problemi

- **Nessun badge visualizzato.** Verificare che il prodotto raggiunga il numero minimo di recensioni e che una sintesi sia stata generata (console o cron).
- **Stato «errore» nella console.** Controllare la chiave API, il nome del modello e la disponibilità di cURL; il dettaglio dell'ultimo errore è conservato nella cache.
- **Recensioni non rilevate.** Confermare la sorgente selezionata e, per DataFirefly Reviews, la corrispondenza delle colonne nell'adattatore.

## Registro delle modifiche

- **1.0.0** — Prima versione pubblica: sintesi Pro / Contro tramite IA (Mistral, OpenAI, Anthropic), cache multilingua, console di amministrazione e cron di aggiornamento.