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 voorbereidt voor gebruik.

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

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

Wat u vóór de installatie moet voorbereiden

Voor de implementatie heeft u nodig:

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

De belangrijkste praktische voorwaarde is eenvoudig: de module zal alleen goed antwoorden wanneer de winkel voorbereide content heeft waar AI gebruik van kan maken.

Als de winkel al de module Kowal AI Product Feed gebruikt, kan juist die module dienen voor het voorbereiden en ordenen van content voor AI. Op de pagina van die module wordt dit beschreven als het bouwen van een gestructureerde en actuele kennisbank voor AI-systemen. AI Product Support is de logische volgende stap, namelijk 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 een installatieproces:

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 na inloggen 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 dan na de installatie ook uit:

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

Waar de configuratie zich bevindt

Na 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 er in het beheerpaneel een AI-tabblad.

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 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 een gebruiker kan verzenden. Dit helpt orde te bewaren en te lange, onleesbare vragen te beperken.

4. Stel de standaard store view in

Als de winkel in meerdere taalversies werkt of meerdere store views heeft, kunt u aangeven:

• Default Store View

Dit vereenvoudigt het werk in het paneel en helpt om met de juiste context te starten.

5. Schakel handmatig wisselen van store view in of uit

Het veld:

• Allow Store Switcher

bepaalt of de gebruiker van het paneel de store view rechtstreeks in de chat-popup kan wijzigen.

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

6. Schakel technische logging in tijdens de implementatie

Het veld:

• Log Chat Requests

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

Instellingen voor de verbinding met AI

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 geladen vanuit de API. Als er na het opslaan van de sleutel geen opties verschijnen, kunt u de knop voor het vernieuwen van de modellenlijst gebruiken.

Vector Store

Dit is de geselecteerde kennisbron voor de module.

Het eenvoudigst kunt u dit zo begrijpen:

• dit is de plek waar de content is opgeslagen die de chat gebruikt bij het beantwoorden,
• de module zoekt de antwoorden juist daar,
• 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, geeft u hier juist 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 in aanmerking neemt bij het voorbereiden van één antwoord.

In de praktijk heeft dit invloed op:

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

Een goede startinstelling is een gemiddelde waarde, bijvoorbeeld 6.

Frontend-beveiliging

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

In de sectie Frontend Security vindt u:

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

Deze instellingen helpen beperken:

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

Aanvullende systeemprompt

In de sectie Prompting kunt u 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 heeft alleen zin wanneer 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 een AI-tabblad aan de rechterrand van het scherm. Na klikken wordt het chatpaneel geopend.

In het paneel kunt u:

• een vraag invoeren,
• een antwoord ontvangen,
• productkaarten bekijken als het antwoord betrekking heeft op een specifiek 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 content en bereidt de kennisbank voor,
2. de beheerder geeft deze kennisbank aan in de moduleconfiguratie,
3. de gebruiker gebruikt de chat,
4. antwoorden worden opgebouwd op basis van content die door de winkel is voorbereid.

Deze aanpak geeft een beter resultaat dan alleen een chat starten 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 store views
• 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 AI-tabblad 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 specifieke producten,
5. als de frontend is ingeschakeld, controleer dan ook de werking van het tabblad in de winkel.

Meest voorkomende problemen

Modellen of kennisbronnen zijn niet zichtbaar

Meestal betekent dit:

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

De chat geeft te zwakke antwoorden of mist 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 te controleren:

• of productbeschrijvingen zinvol en volledig 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

Dan is het de moeite waard de limietinstellingen en de 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 basisparameters van de werking van de module worden aangepast.