AI Size & Fit Advisor — Guía completa
Instalar, configurar y usar el asesor de tallas IA para PrestaShop 8 y 9.
AI Size & Fit Advisor sustituye tu guía de tallas estática por un auténtico asesor: el cliente introduce sus medidas en la ficha de producto y obtiene la talla que mejor le sienta, con un índice de confianza, una alternativa y el detalle medida a medida. Esta guía cubre la instalación, la configuración, la creación de guías de tallas y el funcionamiento del motor de recomendación.
Instalación
- Descarga el archivo
dfsizefit.zipdesde tu cuenta DataFirefly. - Back-office de PrestaShop → Módulos → Subir un módulo → envía el ZIP.
- El módulo crea sus tablas, registra sus hooks y añade la pestaña Catálogo → Size & Fit Charts.
Compatible con PrestaShop 8.0 a 9.x, en PHP 7.2.5+ (PS8) y 8.1+ (PS9). Sin override, sin dependencias externas.
Configuración general
Ve a Módulos → AI Size & Fit Advisor → Configurar.
Capa de IA
El módulo funciona sin IA gracias a su motor determinista. Puedes activar una capa de IA opcional para afinar la decisión según la morfología y generar una explicación en el idioma del cliente.
- Activar la capa de IA: si está desactivada, no se realiza ninguna llamada externa.
- Proveedor: Mistral, OpenAI o Anthropic.
- Clave API: almacenada en el servidor, nunca expuesta al front-office.
- Modelo: por ejemplo
mistral-small-latest,gpt-4o-minioclaude-haiku-4-5.
Si la API falla o expira, el módulo vuelve automáticamente al motor determinista. Siempre hay una recomendación disponible.
Preferencia de ajuste
Activa esta opción para ofrecer al cliente las opciones Ceñido / Normal / Holgado. El módulo aplica un sesgo de ±3 % a las medidas para orientar la talla hacia arriba o hacia abajo según el ajuste deseado.
Fit-learning
Cuando está activado, el módulo registra de forma anonimizada los perfiles y las recomendaciones en una tabla dedicada, para analizar la pertinencia y detectar las referencias que tallan pequeño o grande.
Unidad y hook de visualización
- Unidad por defecto: centímetros o pulgadas.
- Hook de visualización:
displayProductActions(junto al botón de añadir al carrito) odisplayProductAdditionalInfo(debajo de la información del producto). - Etiqueta del botón: déjala vacía para usar la traducción por defecto «Encuentra mi talla».
Crear una guía de tallas
Abre Catálogo → Size & Fit Charts → Añadir.
Alcance
Cada guía tiene un alcance que determina los productos a los que se aplica:
- Global: se aplica a todos los productos (referencia dejada en 0).
- Categoría: introduce el ID de la categoría.
- Producto: introduce el ID del producto.
La resolución es en cascada: el módulo busca primero una guía a nivel de producto, luego de sus categorías, luego la guía global. Se usa la primera coincidencia.
El editor de cuadrícula
El editor visual funciona como una tabla: una fila por talla, una columna por medida.
- Añade una columna de medida (pecho, cintura, cadera, entrepierna, longitud de pie, etc.) desde el selector y luego el botón «Añadir columna».
- Añade una fila de talla con «Añadir una talla» y nómbrala (S, M, L, 38, 40…).
- Para cada celda, introduce un rango mínimo / máximo en la unidad configurada.
- Elige el género (mujer, hombre, unisex, niño) y activa la guía.
Introduce rangos coherentes y sin huecos entre tallas. Cuantas más medidas cubras, más fiable será la recomendación.
Cómo funciona la recomendación
La recomendación se desarrolla en varias etapas:
- Matching determinista: el motor puntúa cada talla comparando las medidas del cliente con los rangos de la cuadrícula (distancia al centro de cada rango, penalización si está fuera de rango), y luego aplica el sesgo de ajuste.
- Afinado por IA (opcional): si la capa de IA está activa, el proveedor confirma o ajusta la talla teniendo en cuenta la morfología (estatura, peso) y redacta una breve explicación.
- Repliegue: si la IA falla, se conserva el resultado determinista.
El cliente recibe la talla recomendada, un índice de confianza, una talla alternativa y el detalle por medida (dentro del rango, ceñido o holgado).
Visualización en el front-office
En la ficha de producto, un botón «Encuentra mi talla» abre una ventana modal. El cliente introduce sus medidas, opcionalmente estatura, peso y preferencia de ajuste, y confirma. El resultado se muestra en la misma ventana, con una barra de confianza y el desglose por medida.
Fit-learning y análisis de devoluciones
Cada recomendación puede registrarse con su perfil anonimizado, el motor utilizado y el índice de confianza. El estado de devolución (conservado, devuelto por pequeño, devuelto por grande) permite, con el tiempo, identificar los cortes problemáticos y ajustar tus cuadrículas.
Compatibilidad y notas técnicas
- PrestaShop 8.x y 9.x, multitienda y multidioma.
- Controlador de administración legacy (sin controlador Symfony) para la compatibilidad PS8/PS9.
- Endpoint AJAX de front mediante el enlace del módulo; JSON renderizado por un método dedicado.
- Datos del cliente almacenados en tu tienda; solo se envía al proveedor de IA elegido la parte necesaria para el cálculo.
FAQ y resolución de problemas
El botón no aparece en la ficha de producto. Comprueba que una guía activa se aplica al producto (alcance producto, categoría o global) y que el hook de visualización elegido está injertado en tu tema.
La recomendación indica falta de datos. El cliente no introdujo ninguna medida correspondiente a las columnas de la cuadrícula. Añade columnas comunes (pecho, cintura, cadera) o invita al cliente a rellenar más campos.
La IA no devuelve nada. Comprueba la clave API y el nombre del modelo. El módulo recurre de todos modos al motor determinista; no se pierde ninguna recomendación.