AI Product Support voor Magento 2

Installatie en configuratie

Dit document beschrijft hoe u de module AI Product Support in een Magento 2-winkel start en klaarmaakt voor gebruik.

Het document is geschreven voor een winkel die een kant-en-klare module wil implementeren en AI-chat wil gaan gebruiken zonder zich te verdiepen in de technische details van de werking aan de codezijde.

U kunt deze module het best zien als een gebruikerslaag. Eerst bereidt de winkel de kennis voor, en pas daarna stelt deze die beschikbaar aan medewerkers of klanten in de vorm van een chat.

Wat u vóór de installatie moet voorbereiden

Voor de implementatie hebt u nodig:

• een werkende Magento 2-winkel,
• toegang tot de server,
• composer,
• een OpenAI-account,
• een voorbereide AI-kennisbank voor de winkel,
• een internetverbinding vanaf de server.

De belangrijkste praktische voorwaarde is eenvoudig: de module zal alleen goed antwoorden als de winkel content heeft voorbereid waarvan AI gebruik kan maken.

Als de winkel al gebruikmaakt van de module Kowal AI Product Feed, kan juist deze module dienen voor het voorbereiden en ordenen van content voor AI. Op de pagina van die module wordt dit beschreven als het opbouwen van een gestructureerde en actuele kennisbank voor AI-systemen. AI Product Support is de natuurlijke volgende stap: het gebruiken van die kennis in een gesprek met de gebruiker. Bron: Kowal AI Product Feed voor OpenAI Vector Store

Installatie van de module

De module wordt geïnstalleerd via composer.

Voorbeeld van het installatieproces:

De toegangsgegevens voor de Composer-repository (het e-mailadres van de klant en de licentietoken) ontvangt u na aankoop per e-mail. Ze zijn ook beschikbaar in het klantpaneel nadat u bent ingelogd op kowal.store. Vervang TWOJ_EMAIL_KLIENTA door het e-mailadres van uw account en TWOJ_TOKEN door de ontvangen token. Voer de opdrachten uit in de hoofdmap van Magento.

composer config repositories.kowal composer https://repo.kowal.store

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

Als de winkel in productiemodus draait, voer na de installatie dan ook het volgende uit:

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

Waar de configuratie zich bevindt

Na de installatie vindt u de module-instellingen hier:

Stores > Configuration > Kowal AI > AI Product Support

Hoe u de module configureert

1. Schakel de chat in het beheerpaneel in

Schakel in de sectie General het volgende in:

• Enable Chat

Na het opslaan van de instelling verschijnt in het beheerpaneel het tabblad AI.

2. Beslis of u de chat op de frontend wilt inschakelen

Als u wilt dat ook klanten van de winkel de chat kunnen gebruiken, schakel dan het volgende in:

• Enable Frontend Chat

Als de module alleen bedoeld is voor het winkelteam, laat de frontend dan uitgeschakeld.

3. Stel de vraaglengte in

Het veld:

• Maximum Question Length

bepaalt de maximale lengte van het bericht dat de gebruiker kan verzenden. Dit helpt om overzicht te houden en te lange, onleesbare vragen te beperken.

4. Stel de standaard winkelweergave in

Als de winkel in meerdere taalversies werkt of meerdere winkelweergaven heeft, kunt u het volgende aangeven:

• Default Store View

Dit vereenvoudigt het werken in het paneel en helpt om vanuit de juiste context te starten.

5. Schakel handmatig wisselen van winkelweergave in of uit

Het veld:

• Allow Store Switcher

bepaalt of de gebruiker van het paneel de winkelweergave rechtstreeks in de chatpopup kan wijzigen.

Dit is handig wanneer één team meerdere versies van de winkel beheert.

6. Schakel technische logging in voor de duur van de implementatie

Het veld:

• Log Chat Requests

is het waard om in te schakelen tijdens de configuratie- en testfase. Zo kunt u eenvoudiger controleren of de module correct werkt. Na de productie-implementatie kunt u beslissen of logging actief moet blijven.

Instellingen voor de AI-verbinding

Configureer in de sectie OpenAI de basiselementen die nodig zijn voor de werking van de module.

OpenAI API Key

Dit is de toegangssleutel tot de AI-service. Zonder deze sleutel haalt de module geen lijst met modellen op, leest hij de kennisbron niet uit en verzendt hij geen vraag.

Response Model

Dit is het model dat verantwoordelijk is voor het opbouwen van antwoorden.

De lijst met modellen wordt via de API geladen. Als er na het opslaan van de sleutel geen opties verschijnen, kunt u de knop gebruiken om de lijst met modellen te vernieuwen.

Vector Store

Dit is de gekozen kennisbron voor de module.

U kunt dit het eenvoudigst als volgt begrijpen:

• dit is de plaats waar de content is opgeslagen die de chat gebruikt bij het beantwoorden,
• de module zoekt juist daar naar antwoorden,
• als u de verkeerde bron kiest, zullen de antwoorden zwak of onvolledig zijn.

Als de winkel al een gestructureerde kennisbank heeft die voor AI is voorbereid, wijst u hier precies die bron aan.

De lijst met kennisbronnen kan ook vanuit de configuratie worden vernieuwd.

Maximum File Search Results

Deze instelling bepaalt hoeveel ondersteunende materialen de module meeneemt bij het voorbereiden van één antwoord.

In de praktijk heeft dit invloed op:

• de kwaliteit van antwoorden,
• de snelheid van werking,
• de kosten van het gebruik van AI.

Een goede startinstelling is een gemiddelde waarde, bijvoorbeeld 6.

Frontend-beveiliging

Als de chat aan de winkelzijde actief is, is het verstandig om meteen beveiligingslimieten in te stellen.

In de sectie Frontend Security vindt u:

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

Deze instellingen helpen het volgende te beperken:

• het te vaak verzenden van vragen,
• misbruik door bots,
• onnodig verbruik van resources en kosten.

Extra systeemprompt

In de sectie Prompting kunt u het volgende aanvullen:

• System Prompt Template

Dit veld is niet verplicht. Bij de meeste implementaties kunt u het leeg laten en de standaardinstelling van de module gebruiken.

Overschrijven is alleen zinvol als de winkel een eigen antwoordstijl of aanvullende communicatieregels wil invoeren.

Hoe de module werkt vanuit het perspectief van de gebruiker

In het beheerpaneel

Na het starten van de module ziet de gebruiker het tabblad AI aan de rechterrand van het scherm. Na een klik wordt het chatpaneel geopend.

In het paneel kunt u:

• een vraag invoeren,
• een antwoord ontvangen,
• productkaarten bekijken als het antwoord betrekking heeft op een concreet product,
• werken zonder de pagina opnieuw te laden.

Op de frontend

Als de chat is ingeschakeld, verschijnt een vergelijkbaar tabblad aan de winkelzijde. De klant kan een vraag stellen zonder de productpagina of listing te verlaten.

Hoe u over zo’n implementatie kunt denken

Het meest praktische model ziet er als volgt uit:

1. de winkel ordent de content en bereidt de kennisbank voor,
2. de beheerder wijst deze kennisbank aan in de moduleconfiguratie,
3. de gebruiker maakt gebruik van de chat,
4. antwoorden worden opgebouwd op basis van de content die door de winkel is voorbereid.

Deze aanpak geeft een beter resultaat dan het starten van alleen de chat zonder voorbereide gegevens.

Aanbevolen startconfiguratie

Beheerpaneel

• Enable Chat = Yes
• Enable Frontend Chat = afhankelijk van het project
• Maximum Question Length = 1000
• Allow Store Switcher = Yes bij meerdere winkelweergaven
• Log Chat Requests = Yes tijdens de testfase
• Maximum File Search Results = 6

Frontend

• Requests Per Minute = voorzichtige startwaarde
• Requests Per Hour = waarde afgestemd op het winkelverkeer
• Minimum Submit Delay = minimaal 1

Wat u na de implementatie moet controleren

Voer na het opslaan van de configuratie een eenvoudige test uit:

1. controleer of het tabblad AI in het beheerpaneel is verschenen,
2. open de popup en verzend een vraag,
3. controleer of het antwoord correct verschijnt,
4. controleer of de productsectie verschijnt bij vragen over concrete producten,
5. als de frontend is ingeschakeld, controleer dan ook de werking van het tabblad in de winkel.

Veelvoorkomende problemen

Modellen of kennisbronnen zijn niet zichtbaar

Meestal betekent dit:

• geen correcte OpenAI-sleutel,
• geen internetverbinding vanaf de server,
• cache niet geleegd na wijzigingen.

De chat antwoordt te zwak of sluit niet aan op het onderwerp

De meest voorkomende oorzaak is niet de module zelf, maar de kwaliteit van de voorbereide kennisbank. Als de content onvolledig, verouderd of te beperkt is, zullen de antwoorden ook zwakker zijn.

Voordat u de module zelf beoordeelt, is het daarom verstandig om te controleren:

• of de productbeschrijvingen logisch en compleet zijn,
• of FAQ en documentatie actueel zijn,
• of de kennisbank daadwerkelijk de content bevat die gebruikers nodig hebben,
• of de gekozen kennisbron geschikt is voor de betreffende winkel.

De frontend blokkeert de gebruiker te snel

In dat geval is het verstandig om de instellingen voor limieten en verzendvertraging in de sectie Frontend Security te controleren.

Korte implementatiechecklist

1. Installeer de module via composer.
2. Schakel de module in en voer setup:upgrade uit.
3. Configureer de verbinding met OpenAI.
4. Kies de juiste kennisbron.
5. Schakel de chat in de admin in.
6. Schakel optioneel de chat op de frontend in.
7. Stel beveiligingslimieten in.
8. Test de werking met vragen over echte producten en winkelcontent.

Korte beschrijving voor de sectie ‘Installatie en configuratie’

De module wordt geïnstalleerd via composer en geconfigureerd in Stores > Configuration > Kowal AI > AI Product Support. De beheerder voert de toegangsgegevens voor OpenAI in, kiest het model en de kennisbron voor de winkel, en schakelt vervolgens de chat in het beheerpaneel en optioneel op de frontend in. Daarnaast kunnen beveiligingslimieten worden ingesteld en kunnen de basisparameters van de modulewerking worden aangepast.