AI Size & Fit Advisor: guia completo

O AI Size & Fit Advisor substitui o seu guia de tamanhos estático por um verdadeiro conselheiro: o cliente introduz as suas medidas na ficha de produto e recebe o tamanho mais adequado, com um índice de confiança, uma alternativa e o detalhe medida a medida. Este guia cobre a instalação, a configuração, a criação dos guias de tamanhos e o funcionamento do motor de recomendação.

Instalação

1. Descarregue o ficheiro dfsizefit.zip a partir da sua conta DataFirefly.
2. Back-office do PrestaShop → Módulos → Carregar um módulo → envie o ZIP.
3. O módulo cria as suas tabelas, regista os seus hooks e acrescenta o separador Catálogo → Size & Fit Charts.

Configuração geral

Vá a Módulos → AI Size & Fit Advisor → Configurar.

Camada de IA

O módulo funciona sem IA graças ao seu motor determinista. Pode ativar uma camada de IA opcional para afinar a decisão consoante a morfologia e gerar uma explicação no idioma do cliente.

• Ativar a camada de IA: se estiver desativada, não é feita qualquer chamada externa.
• Fornecedor: Mistral, OpenAI ou Anthropic.
• Chave de API: guardada do lado do servidor, nunca exposta ao front-office.
• Modelo: por exemplo, mistral-small-latest, gpt-4o-mini ou claude-haiku-4-5.

Preferência de corte

Ative esta opção para propor ao cliente as escolhas Justo / Clássico / Largo. O módulo aplica um desvio de ±3 % às medidas, para orientar o tamanho para cima ou para baixo consoante o corte pretendido.

Fit-learning

Quando está ativado, o módulo regista de forma anonimizada os perfis e as recomendações na tabela dedicada, para analisar a pertinência e identificar as referências que ficam pequenas ou grandes.

Unidade e hook de apresentação

• Unidade predefinida: centímetros ou polegadas.
• Hook de apresentação: displayProductActions (junto ao botão de adicionar ao carrinho) ou displayProductAdditionalInfo (por baixo das informações do produto).
• Legenda do botão: deixe vazio para usar a tradução predefinida «Encontrar o meu tamanho».

Criar um guia de tamanhos

Abra Catálogo → Size & Fit Charts → Adicionar.

Âmbito

Cada guia tem um âmbito que determina os produtos abrangidos:

• Global: aplica-se a todos os produtos (referência deixada a 0).
• Categoria: indique o ID da categoria.
• Produto: indique o ID do produto.

A resolução é feita em cascata: o módulo procura primeiro um guia ao nível do produto, depois das suas categorias e, por fim, o guia global. É usado o primeiro que encontrar.

O editor de grelha

O editor visual funciona como uma tabela: uma linha por tamanho, uma coluna por medida.

• Acrescente uma coluna de medida (peito, cintura, ancas, entrepernas, comprimento do pé, etc.) através do seletor e do botão «Adicionar uma coluna».
• Acrescente uma linha de tamanho com «Adicionar um tamanho» e dê-lhe um nome (S, M, L, 38, 40…).
• Em cada célula, indique um intervalo mínimo / máximo na unidade configurada.
• Escolha o género (mulher, homem, unissexo, criança) e ative o guia.

Como funciona a recomendação

A recomendação decorre em várias etapas:

1. Correspondência determinista: o motor pontua cada tamanho comparando as medidas do cliente com os intervalos da grelha (distância ao centro de cada intervalo, penalização se ficar fora do intervalo) e depois aplica o desvio de corte.
2. Afinamento por IA (opcional): se a camada de IA estiver ativa, o fornecedor confirma ou ajusta o tamanho tendo em conta a morfologia (altura, peso) e redige uma explicação curta.
3. Recurso: se a IA falhar, o resultado determinista é mantido.

O cliente recebe o tamanho recomendado, um índice de confiança, um tamanho alternativo e o detalhe por medida (dentro do intervalo, apertado ou largo).

Apresentação do lado do cliente

Na ficha de produto, um botão «Encontrar o meu tamanho» abre uma janela modal. O cliente introduz as suas medidas, eventualmente a altura, o peso e a preferência de corte, e valida. O resultado é apresentado na mesma janela, com uma barra de confiança e a decomposição por medida.

Fit-learning e análise das devoluções

Cada recomendação pode ser registada com o seu perfil anonimizado, o motor utilizado e o índice de confiança. O estado de devolução (ficou com o artigo, devolvido por ser pequeno demais, devolvido por ser grande demais) permite, com o tempo, identificar os cortes problemáticos e ajustar as suas grelhas.

Compatibilidade e notas técnicas

• PrestaShop 8.x e 9.x, multiloja e multilingue.
• Controlador de administração legacy (sem controlador Symfony) para a compatibilidade PS8/PS9.
• Endpoint AJAX do front-office através da ligação do módulo; resposta JSON produzida por um método dedicado.
• Dados do cliente guardados na sua loja; só a parte necessária ao cálculo é transmitida ao fornecedor de IA escolhido.

FAQ e resolução de problemas

O botão não aparece na ficha de produto. Verifique se existe um guia ativo aplicável ao produto (âmbito de produto, de categoria ou global) e se o hook de apresentação escolhido está mesmo ligado ao seu tema.

A recomendação indica falta de dados. O cliente não indicou nenhuma medida correspondente às colunas da grelha. Acrescente colunas comuns (peito, cintura, ancas) ou convide o cliente a preencher mais campos.

A IA não devolve nada. Verifique a chave de API e o nome do modelo. O módulo passa de qualquer forma para o motor determinista; nenhuma recomendação se perde.