AI Product Support pour Magento 2

Installation et configuration

Ce document décrit comment lancer le module AI Product Support dans une boutique Magento 2 et comment le préparer à fonctionner.

Il s’adresse à une boutique qui souhaite déployer un module prêt à l’emploi et commencer à utiliser le chat AI sans entrer dans les détails techniques du fonctionnement côté code.

Il est préférable de considérer ce module comme une couche utilisateur. La boutique prépare d’abord les connaissances, puis les met à disposition des collaborateurs ou des clients sous forme de chat.

Ce qu’il faut préparer avant l’installation

Avant le déploiement, vous avez besoin de :

• une boutique Magento 2 fonctionnelle,
• un accès au serveur,
• composer,
• un compte OpenAI,
• une base de connaissances AI préparée pour la boutique,
• une connexion Internet depuis le serveur.

La condition pratique la plus importante est simple : le module ne répondra correctement que si la boutique dispose de contenus préparés que l’AI peut utiliser.

Si la boutique utilise déjà le module Kowal AI Product Feed, c’est précisément lui qui peut assurer la préparation et l’organisation des contenus pour l’AI. Sur la page de ce module, cela est décrit comme la création d’une base de connaissances structurée et à jour pour les systèmes AI. AI Product Support est l’étape suivante naturelle, c’est-à-dire l’utilisation de ces connaissances dans la conversation avec l’utilisateur. Source : Kowal AI Product Feed pour OpenAI Vector Store

Installation du module

Le module s’installe via composer.

Exemple de processus d’installation :

composer config repositories.ai.product.support vcs https://github.com/kowalco/ai-product-supportcomposer config --global --auth github-oauth.github.com composer require kowal/module-ai-product-supportbin/magento module:enable Kowal_AiProductSupportbin/magento setup:upgradebin/magento cache:clean

Si la boutique fonctionne en mode production, exécutez également après l’installation :

bin/magento setup:di:compilebin/magento setup:static-content:deploy -fbin/magento cache:clean

Où se trouve la configuration ?

Après l’installation, vous trouverez les paramètres du module ici :

Stores > Configuration > Kowal AI > AI Product Support

Comment configurer le module

1. Activez le chat dans le panneau d’administration

Dans la section General, activez :

• Enable Chat

Après l’enregistrement du paramètre, l’onglet AI apparaîtra dans le panneau d’administration.

2. Décidez si vous souhaitez activer le chat sur le frontend

Si vous souhaitez que les clients de la boutique puissent également utiliser le chat, activez :

• Enable Frontend Chat

Si le module doit servir uniquement à l’équipe de la boutique, laissez le frontend désactivé.

3. Définissez la longueur de la question

Le champ :

• Maximum Question Length

définit la longueur maximale du message que l’utilisateur peut envoyer. Cela aide à maintenir l’ordre et à limiter les requêtes trop longues et peu lisibles.

4. Définissez la vue de boutique par défaut

Si la boutique fonctionne dans plusieurs versions linguistiques ou possède plusieurs vues de boutique, vous pouvez indiquer :

• Default Store View

Cela facilite le travail dans le panneau et aide à démarrer avec le bon contexte.

5. Activez ou désactivez le changement manuel de vue de boutique

Le champ :

• Allow Store Switcher

détermine si l’utilisateur du panneau peut changer de vue de boutique directement dans la popup du chat.

C’est utile lorsqu’une même équipe gère plusieurs versions de la boutique.

6. Activez la journalisation technique pendant le déploiement

Le champ :

• Log Chat Requests

mérite d’être activé pendant la phase de configuration et de tests. Cela permet de vérifier plus facilement si le module fonctionne correctement. Après le déploiement en production, vous pouvez décider si la journalisation doit rester active.

Paramètres de connexion à l’AI

Dans la section OpenAI, configurez les éléments de base nécessaires au fonctionnement du module.

OpenAI API Key

Il s’agit de la clé d’accès au service AI. Sans elle, le module ne récupérera pas la liste des modèles, ne lira pas la source de connaissances et n’enverra pas de question.

Response Model

Il s’agit du modèle responsable de la construction des réponses.

La liste des modèles se charge depuis l’API. Si aucune option n’apparaît après l’enregistrement de la clé, vous pouvez utiliser le bouton d’actualisation de la liste des modèles.

Vector Store

Il s’agit de la source de connaissances sélectionnée pour le module.

On peut le comprendre simplement ainsi :

• c’est l’endroit où sont enregistrés les contenus que le chat utilise pour répondre,
• le module recherche les réponses précisément à cet endroit,
• si vous choisissez une source incorrecte, les réponses seront faibles ou incomplètes.

Si la boutique dispose déjà d’une base de connaissances structurée préparée pour l’AI, c’est ici que cette source doit être indiquée.

La liste des sources de connaissances peut également être actualisée depuis la configuration.

Maximum File Search Results

Ce paramètre définit le nombre de contenus d’aide que le module prend en compte lors de la préparation d’une réponse.

En pratique, cela influence :

• la qualité de la réponse,
• la vitesse de fonctionnement,
• le coût d’utilisation de l’AI.

Une valeur moyenne constitue un bon réglage de départ, par exemple 6.

Sécurité du frontend

Si le chat fonctionne côté boutique, il est recommandé de définir immédiatement des limites de sécurité.

Dans la section Frontend Security, vous trouverez :

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

Ces paramètres aident à limiter :

• l’envoi trop fréquent de questions,
• les abus de la part de bots,
• la consommation inutile de ressources et de coûts.

Prompt système supplémentaire

Dans la section Prompting, vous pouvez compléter :

• System Prompt Template

Ce champ n’est pas obligatoire. Dans la plupart des déploiements, il peut être laissé vide et le paramètre par défaut du module peut être utilisé.

Le remplacement n’a de sens que si la boutique souhaite introduire son propre style de réponse ou des règles de communication supplémentaires.

Comment le module fonctionne du point de vue de l’utilisateur

Dans le panneau d’administration

Après l’activation du module, l’utilisateur voit un onglet AI sur le bord droit de l’écran. En cliquant dessus, le panneau de chat s’ouvre.

Dans le panneau, il est possible de :

• saisir une question,
• recevoir une réponse,
• voir des cartes produit si la réponse concerne un produit précis,
• travailler sans recharger la page.

Sur le frontend

Si le chat a été activé, un onglet similaire apparaît côté boutique. Le client peut poser une question sans quitter la page produit ou le listing.

Comment envisager un tel déploiement

Le modèle le plus pratique est le suivant :

1. la boutique organise les contenus et prépare la base de connaissances,
2. l’administrateur indique cette base de connaissances dans la configuration du module,
3. l’utilisateur utilise le chat,
4. les réponses sont construites à partir des contenus préparés par la boutique.

Cette approche donne de meilleurs résultats que le lancement d’un simple chat sans données préparées.

Configuration de départ recommandée

Panneau d’administration

• Enable Chat = Yes
• Enable Frontend Chat = selon le projet
• Maximum Question Length = 1000
• Allow Store Switcher = Yes avec plusieurs vues de boutique
• Log Chat Requests = Yes pendant la phase de tests
• Maximum File Search Results = 6

Frontend

• Requests Per Minute = valeur de départ prudente
• Requests Per Hour = valeur adaptée au trafic de la boutique
• Minimum Submit Delay = au moins 1

Que vérifier après le déploiement

Après l’enregistrement de la configuration, effectuez un test simple :

1. vérifiez si l’onglet AI est apparu dans le panneau d’administration,
2. ouvrez la popup et envoyez une question,
3. assurez-vous que la réponse s’affiche correctement,
4. vérifiez si la section des produits apparaît pour les questions concernant des produits précis,
5. si le frontend est activé, vérifiez également le fonctionnement de l’onglet sur la boutique.

Problèmes les plus fréquents

Les modèles ou les sources de connaissances ne sont pas visibles

Le plus souvent, cela signifie :

• absence de clé OpenAI correcte,
• absence de connexion Internet depuis le serveur,
• cache non vidé après les modifications.

Le chat répond trop faiblement ou manque le sujet

La cause la plus fréquente n’est pas le module lui-même, mais la qualité de la base de connaissances préparée. Si les contenus sont incomplets, obsolètes ou trop pauvres, les réponses seront également plus faibles.

Avant d’évaluer le module lui-même, il vaut donc la peine de vérifier :

• si les descriptions de produits sont pertinentes et complètes,
• si la FAQ et la documentation sont à jour,
• si la base de connaissances contient réellement les contenus nécessaires aux utilisateurs,
• si la source de connaissances choisie est appropriée pour la boutique concernée.

Le frontend bloque l’utilisateur trop rapidement

Dans ce cas, il est utile de vérifier les paramètres de limites et le délai d’envoi dans la section Frontend Security.

Brève checklist de déploiement

1. Installez le module via composer.
2. Activez le module et exécutez setup:upgrade.
3. Configurez la connexion avec OpenAI.
4. Sélectionnez la bonne source de connaissances.
5. Activez le chat dans l’admin.
6. Activez le chat sur le frontend en option.
7. Définissez les limites de sécurité.
8. Testez le fonctionnement avec des questions portant sur de vrais produits et contenus de la boutique.

Courte description pour la section « Installation et configuration »

Le module s’installe via composer et se configure dans Stores > Configuration > Kowal AI > AI Product Support. L’administrateur saisit les données d’accès à OpenAI, choisit le modèle ainsi que la source de connaissances de la boutique, puis active le chat dans le panneau d’administration et, en option, sur le frontend. Il est également possible de définir des limites de sécurité et d’adapter les paramètres de base du fonctionnement du module.