AI Product Support para Magento 2

Instalación y configuración

Este documento describe cómo poner en marcha el móduloAI Product Supporten una tienda Magento 2 y cómo prepararlo para su uso.

El documento está pensado para una tienda que desea implementar un módulo listo para usar y empezar a utilizar el chat de AI sin profundizar en los detalles técnicos de su funcionamiento a nivel de código.

Lo más recomendable es tratar este módulo como una capa funcional para el usuario. Primero, la tienda prepara el conocimiento y, solo después, lo pone a disposición de empleados o clientes en forma de chat.

Qué hay que preparar antes de la instalación

Antes de la implementación necesitas:

• una tienda Magento 2 operativa,
• acceso al servidor,
• composer,
• una cuenta de OpenAI,
• una base de conocimiento AI preparada para la tienda,
• conexión del servidor a internet.

La condición práctica más importante es sencilla: el módulo responderá bien solo si la tienda tiene contenidos preparados que la AI pueda utilizar.

Si la tienda ya utiliza el móduloKowal AI Product Feed, este puede encargarse precisamente de preparar y ordenar los contenidos para la AI. En la página de este módulo se describe como la creación de una base de conocimiento estructurada y actualizada para sistemas de AI.AI Product Supportes el siguiente paso natural, es decir, utilizar ese conocimiento en la conversación con el usuario. Fuente:Kowal AI Product Feed para OpenAI Vector Store

Instalación del módulo

El módulo se instala mediantecomposer.

Ejemplo de proceso de instalación:

composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
composer require kowal/module-ai-product-support
bin/magento module:enable Kowal_AiProductSupport
bin/magento setup:upgrade
bin/magento cache:clean

Si la tienda funciona en modo de producción, después de la instalación ejecuta también:

bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:clean

Dónde se encuentra la configuración

Después de la instalación, encontrarás la configuración del módulo aquí:

Stores > Configuration > Kowal AI > AI Product Support

Cómo configurar el módulo

1. Activa el chat en el panel de administración

En la secciónGeneral, activa:

• Enable Chat

Después de guardar la configuración, aparecerá la pestaña AI en el panel de administración.

2. Decide si activar el chat en el frontend

Si quieres que los clientes de la tienda también puedan utilizar el chat, activa:

• Enable Frontend Chat

Si el módulo debe servir solo al equipo de la tienda, deja el frontend desactivado.

3. Define la longitud de la pregunta

Campo:

• Maximum Question Length

determina la longitud máxima del mensaje que puede enviar el usuario. Esto ayuda a mantener el orden y a limitar consultas demasiado largas y poco legibles.

4. Define la vista de tienda predeterminada

Si la tienda funciona en varios idiomas o tiene varias vistas de tienda, puedes indicar:

• Default Store View

Esto facilita el trabajo en el panel y ayuda a empezar desde el contexto adecuado.

5. Activa o desactiva el cambio manual de vista de tienda

Campo:

• Allow Store Switcher

decide si el usuario del panel puede cambiar la vista de tienda directamente en el popup del chat.

Es útil cuando un mismo equipo gestiona varias versiones de la tienda.

6. Activa el registro técnico durante la implementación

Campo:

• Log Chat Requests

durante la fase de configuración y pruebas. Gracias a ello, es más fácil comprobar si el módulo funciona correctamente. Tras la puesta en producción, se puede decidir si el registro debe seguir activo.

Configuración de la conexión con AI

En la secciónOpenAI, configura los elementos básicos necesarios para que el módulo funcione.

OpenAI API Key

Es la clave de acceso al servicio de AI. Sin ella, el módulo no descargará la lista de modelos, no leerá la fuente de conocimiento y no enviará la pregunta.

Response Model

Es el modelo responsable de generar las respuestas.

La lista de modelos se carga desde la API. Si después de guardar la clave no aparecen opciones, se puede utilizar el botón para actualizar la lista de modelos.

Vector Store

Es la fuente de conocimiento seleccionada para el módulo.

La forma más sencilla de entenderlo es la siguiente:

• es el lugar donde se guardan los contenidos que utiliza el chat al responder,
• el módulo busca las respuestas precisamente ahí,
• si eliges una fuente incorrecta, las respuestas serán deficientes o incompletas.

Si la tienda ya tiene una base de conocimiento ordenada y preparada para AI, aquí se indica precisamente esa fuente.

La lista de fuentes de conocimiento también puede actualizarse desde la configuración.

Maximum File Search Results

Esta opción determina cuántos materiales de apoyo tiene en cuenta el módulo al preparar una única respuesta.

En la práctica, esto influye en:

• la calidad de las respuestas,
• la velocidad de funcionamiento,
• el coste de uso de AI.

Un buen ajuste inicial es un valor medio, por ejemplo6.

Seguridad del frontend

Si el chat funciona en la parte de la tienda, conviene configurar desde el principio los límites de seguridad.

En la secciónFrontend Securityencontrarás:

• Requests Per Minute
• Requests Per Hour
• Minimum Submit Delay

Estos ajustes ayudan a limitar:

• el envío demasiado frecuente de preguntas,
• los abusos por parte de bots,
• el consumo innecesario de recursos y costes.

Prompt de sistema adicional

En la secciónPromptingse puede completar:

• System Prompt Template

Este campo no es obligatorio. En la mayoría de implementaciones puede dejarse vacío y utilizar la configuración predeterminada del módulo.

Sobrescribirlo solo tiene sentido si la tienda quiere introducir un estilo propio de respuesta o reglas adicionales de comunicación.

Cómo funciona el módulo desde la perspectiva del usuario

En el panel de administración

Tras iniciar el módulo, el usuario ve una pestaña AI en el borde derecho de la pantalla. Al hacer clic, se abre el panel de chat.

En el panel se puede:

• escribir una pregunta,
• recibir una respuesta,
• ver tarjetas de producto si la respuesta se refiere a un producto concreto,
• trabajar sin recargar la página.

En el frontend

Si se ha activado el chat, aparece una pestaña similar en la parte de la tienda. El cliente puede hacer una pregunta sin abandonar la página de producto ni el listado.

Cómo enfocar este tipo de implementación

El modelo más práctico es el siguiente:

1. la tienda ordena los contenidos y prepara la base de conocimiento,
2. el administrador indica esa base de conocimiento en la configuración del módulo,
3. el usuario utiliza el chat,
4. las respuestas se generan a partir de los contenidos preparados por la tienda.

Este enfoque ofrece mejores resultados que lanzar solo el chat sin datos preparados.

Configuración inicial recomendada

Panel de administración

• Enable Chat=Yes
• Enable Frontend Chat= según el proyecto
• Maximum Question Length=1000
• Allow Store Switcher=Yescon varias vistas de tienda
• Log Chat Requests=Yesdurante la fase de pruebas
• Maximum File Search Results=6

Frontend

• Requests Per Minute= valor inicial prudente
• Requests Per Hour= valor adaptado al tráfico de la tienda
• Minimum Submit Delay= al menos1

Qué comprobar después de la implementación

Después de guardar la configuración, realiza una prueba sencilla:

1. comprueba si la pestaña AI ha aparecido en el panel de administración,
2. abre el popup y envía una pregunta,
3. asegúrate de que la respuesta aparece correctamente,
4. comprueba si la sección de productos aparece en las preguntas sobre productos concretos,
5. si el frontend está activado, comprueba también el funcionamiento de la pestaña en la tienda.

Problemas más frecuentes

No se ven los modelos ni las fuentes de conocimiento

Normalmente significa:

• falta de una clave OpenAI correcta,
• falta de conexión del servidor a internet,
• cache sin limpiar después de los cambios.

El chat responde de forma deficiente o no acierta con el tema

La causa más habitual no es el propio módulo, sino la calidad de la base de conocimiento preparada. Si los contenidos son incompletos, están desactualizados o son demasiado pobres, las respuestas también serán peores.

Por eso, antes de evaluar el propio módulo, conviene comprobar:

• si las descripciones de los productos son claras y completas,
• si las FAQ y la documentación están actualizadas,
• si la base de conocimiento contiene realmente los contenidos que necesitan los usuarios,
• si la fuente de conocimiento seleccionada es la adecuada para esa tienda.

El frontend bloquea al usuario demasiado rápido

En ese caso, conviene revisar la configuración de los límites y del retraso de envío en la secciónFrontend Security.

Breve checklist de implementación

1. Instala el módulo mediantecomposer.
2. Activa el módulo y ejecutasetup:upgrade.
3. Configura la conexión con OpenAI.
4. Selecciona la fuente de conocimiento adecuada.
5. Activa el chat en el admin.
6. Opcionalmente, activa el chat en el frontend.
7. Configura los límites de seguridad.
8. Prueba el funcionamiento con preguntas sobre productos reales y contenidos de la tienda.

Breve descripción para la sección «Instalación y configuración»

El módulo se instala mediantecomposery se configura enStores > Configuration > Kowal AI > AI Product Support. El administrador introduce los datos de acceso a OpenAI, selecciona el modelo y la fuente de conocimiento para la tienda y, a continuación, activa el chat en el panel de administración y, opcionalmente, en el frontend. Además, se pueden configurar límites de seguridad y ajustar los parámetros básicos de funcionamiento del módulo.