# AI Review Pros/Cons Synthesizer: guia completo
> Documentação de instalação e configuração do módulo AI Review Pros/Cons Synthesizer: fornecedores de IA, fontes de avaliações, geração em massa, cron multilingue e apresentação.
- Página:
- Idioma: pt
- Atualizado em: 2026-09-16
- Outros idiomas: [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), [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)
- Índice:
O módulo **AI Review Pros/Cons Synthesizer** lê as avaliações dos clientes de um produto e gera, por inteligência artificial, uma síntese em etiquetas de **Vantagens** e **Desvantagens** apresentadas diretamente na ficha de produto. As sínteses ficam em cache por produto, idioma e loja, e são atualizadas automaticamente por um cron.
## Apresentação
Quando uma ficha acumula centenas de avaliações, poucos visitantes as leem. O módulo condensa esse sinal em algumas etiquetas claras, acompanhadas de uma frase de resumo neutra e de um contador de menções. São suportados três fornecedores de IA: Mistral AI, OpenAI e Anthropic (Claude). Cada síntese é produzida no idioma da ficha, o que serve bem os catálogos multilingues.
## Pré-requisitos
- PrestaShop 8.0 a 9.x (loja única ou multiloja).
- PHP 7.4 a 8.x com a extensão cURL ativa.
- Uma fonte de avaliações: o módulo oficial _Product Comments_ ou o _DataFirefly Reviews_.
- Uma chave de API junto de um fornecedor de IA (Mistral, OpenAI ou Anthropic).
## Instalação
1. No back-office, abra **Módulos > Gestor de módulos > Carregar um módulo**.
2. Selecione o ficheiro `dfreviewsynth.zip` e instale.
3. Clique em **Configurar** para aceder às definições.
**Bom saber.** A instalação cria uma tabela de cache dedicada e um separador de administração oculto, usado apenas para as chamadas de geração.
## Configuração
### Fornecedor de IA e chave de API
Escolha o **fornecedor** (Mistral, OpenAI ou Anthropic), cole a sua **chave de API** e indique o **modelo** pretendido:
- Mistral: `mistral-small-latest`
- OpenAI: `gpt-4o-mini`
- Anthropic: `claude-haiku-4-5`
**Dica.** Deixe o campo da chave vazio ao gravar de novo para manter a chave já memorizada: por razões de segurança, ela nunca é reapresentada.
### Fonte das avaliações
Selecione a origem das avaliações. O adaptador _Product Comments_ lê os comentários aprovados e não eliminados. O adaptador _DataFirefly Reviews_ lê as avaliações ativas; se o seu esquema for diferente, ajuste o nome das colunas na classe de acesso aos dados.
### Posição de apresentação
Estão disponíveis dois locais na ficha de produto: **por baixo da descrição curta** (informações complementares) ou **no rodapé da ficha**.
### Limiares e cache
- **Número mínimo de avaliações**: abaixo desse valor, não é gerada qualquer síntese.
- **Máximo de etiquetas por lado**: limita o número de Vantagens e de Desvantagens apresentadas.
- **Máximo de avaliações enviadas à IA**: limita o consumo de tokens (as avaliações mais recentes têm prioridade).
- **Duração do cache (dias)**: usada pelo cron para atualizar as sínteses obsoletas.
## Gerar as sínteses
### Consola de administração
Na página de configuração, a consola permite carregar os produtos elegíveis (os que atingem o limiar mínimo de avaliações) e depois gerar as sínteses uma a uma ou em massa, com barra de progresso. A geração é feita no idioma atual do back-office.
### Cron multilingue
Para manter todos os idiomas automaticamente atualizados, agende uma chamada regular ao URL de cron indicado na configuração:
```
/index.php?fc=module&module=dfreviewsynth&controller=cron&token=O_SEU_TOKEN&limit=20
```
O parâmetro `limit` limita o número de produtos tratados em cada execução (20 por omissão, máximo 100). O cron percorre cada idioma ativo e só regenera as sínteses em falta, em erro ou obsoletas.
**Atenção.** O token do cron é confidencial. Em caso de fuga, gere-o novamente a partir da página de configuração: o URL antigo deixa imediatamente de funcionar.
## Apresentação ao cliente
Na ficha de produto, o módulo mostra um bloco «O que dizem os clientes» com duas colunas (Vantagens a verde, Desvantagens a laranja), uma frase de resumo neutra opcional, o número de avaliações consideradas e um contador de menções por etiqueta. É possível apresentar a menção «resumo gerado por IA» para efeitos de transparência perante os clientes.
## Catálogo multilingue
Cada síntese é guardada por produto, idioma e loja. O conteúdo é gerado no idioma da ficha e o cron sincroniza o conjunto dos idiomas ativos. Uma síntese só é regenerada quando o conteúdo das avaliações muda (deteção por impressão digital) ou quando o cache expira.
**Nota para o mercado português.** A síntese segue o idioma da ficha: se o português estiver ativo no PrestaShop, as etiquetas saem em português. Verifique as primeiras gerações, sobretudo se as avaliações de origem estiverem escritas noutro idioma, e confirme que o resultado está em português europeu antes de gerar em massa.
## Resolução de problemas
- **Não aparece nenhuma etiqueta.** Verifique se o produto atinge o número mínimo de avaliações e se a síntese foi efetivamente gerada (consola ou cron).
- **Estado «erro» na consola.** Confirme a chave de API, o nome do modelo e a disponibilidade do cURL; o detalhe do último erro fica guardado em cache.
- **Avaliações não detetadas.** Confirme a fonte selecionada e, no caso do DataFirefly Reviews, a correspondência das colunas no adaptador.
## Registo de versões
- **1.0.0** — Primeira versão pública: síntese Vantagens / Desvantagens por IA (Mistral, OpenAI, Anthropic), cache multilingue, consola de administração e cron de atualização.