PS PrestaShop Intermédio

AI Review Pros/Cons Synthesizer: guia completo

Instalar, configurar e explorar a síntese por IA das avaliações (Vantagens / Desvantagens) nas fichas de produto do PrestaShop 8 e 9.

Atualizado Versão do módulo 1.0.0

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.
Esta página foi útil?

Ainda com dúvidas? Contacte o suporte