Installation et configuration
Ce document explique comment lancer le module AI Product Support dans une boutique Magento 2 et comment le préparer à fonctionner.
Le document est rédigé pour 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 du serveur à Internet.
La condition pratique la plus importante est simple : le module répondra correctement uniquement 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 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 construction 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 une 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 http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'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, après l’installation, exécutez également :
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 :
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 :
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 :
définit la longueur maximale du message qu’un utilisateur peut envoyer. Cela aide à maintenir l’ordre et à limiter les requêtes trop longues et difficiles à lire.
4. Définissez le store view par défaut
Si la boutique fonctionne en plusieurs versions linguistiques ou dispose de plusieurs store views, vous pouvez indiquer :
Cela facilite le travail dans le panneau et aide à démarrer avec le bon contexte.
5. Activez ou désactivez le changement manuel de store view
Le champ :
détermine si l’utilisateur du panneau peut changer de store view 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 :
mérite d’être activé pendant la configuration et les tests. Cela permet de vérifier plus facilement que le module fonctionne correctement. Après la mise 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 chargé de construire la réponse.
La liste des modèles se charge depuis l’API. Si, après l’enregistrement de la clé, les options n’apparaissent pas, 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.
Le plus simple est de le comprendre ainsi :
- c’est l’endroit où sont enregistrés les contenus que le chat utilise pour répondre,
- le module y recherche précisément les réponses,
- si vous choisissez une mauvaise source, 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 vous indiquez cette source.
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 ressources d’aide que le module prend en compte pour préparer une réponse.
En pratique, cela influe sur :
- la qualité des réponses,
- la vitesse de fonctionnement,
- le coût d’utilisation de l’AI.
Une bonne valeur de départ est une valeur moyenne, par exemple 6.
Sécurité du frontend
Si le chat fonctionne côté boutique, il vaut la peine de définir immédiatement des limites de sécurité.
Dans la section Frontend Security, vous trouverez :
Requests Per MinuteRequests Per HourMinimum Submit Delay
Ces paramètres aident à limiter :
- l’envoi trop fréquent de questions,
- les abus de la part des bots,
- la consommation inutile de ressources et les coûts.
Prompt système supplémentaire
Dans la section Prompting, vous pouvez compléter :
Ce champ n’est pas obligatoire. Dans la plupart des déploiements, vous pouvez le laisser vide et utiliser le paramètre par défaut du module.
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.
Fonctionnement du module 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. Après un clic, 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 :
- la boutique organise ses contenus et prépare une base de connaissances,
- l’administrateur indique cette base de connaissances dans la configuration du module,
- l’utilisateur utilise le chat,
- les réponses sont construites à partir des contenus préparés par la boutique.
Cette approche donne un meilleur résultat que le lancement d’un simple chat sans données préparées.
Configuration de départ recommandée
Panneau d’administration
Enable Chat = YesEnable Frontend Chat = selon le projetMaximum Question Length = 1000Allow Store Switcher = Yes avec plusieurs store viewsLog Chat Requests = Yes pendant les testsMaximum File Search Results = 6
Frontend
Requests Per Minute = valeur de départ prudenteRequests Per Hour = valeur adaptée au trafic de la boutiqueMinimum Submit Delay = au moins 1
Ce qu’il faut vérifier après le déploiement
Après avoir enregistré la configuration, effectuez un test simple :
- vérifiez que l’onglet AI est apparu dans le panneau d’administration,
- ouvrez la popup et envoyez une question,
- assurez-vous que la réponse s’affiche correctement,
- vérifiez que la section des produits apparaît pour les questions concernant des produits précis,
- si le frontend est activé, vérifiez également le fonctionnement de l’onglet côté boutique.
Problèmes les plus fréquents
Les modèles ou sources de connaissances ne sont pas visibles
Le plus souvent, cela signifie :
- absence de clé OpenAI valide,
- absence de connexion du serveur à Internet,
- cache non vidé après les modifications.
Le chat répond de manière trop faible ou hors 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 moins bonnes.
Avant d’évaluer le module lui-même, il est donc utile 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 sélectionnée est adaptée à la boutique concernée.
Le frontend bloque l’utilisateur trop rapidement
Dans ce cas, il vaut la peine de vérifier les paramètres de limites et le délai d’envoi dans la section Frontend Security.
Courte checklist de déploiement
- Installez le module via
composer. - Activez le module et exécutez
setup:upgrade. - Configurez la connexion à OpenAI.
- Choisissez la bonne source de connaissances.
- Activez le chat dans l’admin.
- Activez éventuellement le chat sur le frontend.
- Définissez les limites de sécurité.
- Testez le fonctionnement avec des questions portant sur des produits réels et les contenus de la boutique.
Court descriptif 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 et la source de connaissances pour 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’ajuster les paramètres de base du fonctionnement du module.
