AI Product Support pentru Magento 2

Instalare și configurare

Acest document descrie cum să porniți modulul AI Product Support într-un magazin Magento 2 și cum să îl pregătiți pentru utilizare.

Documentul este scris pentru un magazin care dorește să implementeze un modul gata pregătit și să înceapă să folosească chatul AI fără a intra în detaliile tehnice ale funcționării la nivel de cod.

Cel mai bine este să tratați acest modul ca pe un strat de utilizare. Mai întâi, magazinul pregătește cunoștințele, apoi le pune la dispoziția angajaților sau clienților sub forma unui chat.

Ce trebuie pregătit înainte de instalare

Înainte de implementare aveți nevoie de:

• un magazin Magento 2 funcțional,
• acces la server,
• composer,
• cont OpenAI,
• bază de cunoștințe AI pregătită pentru magazin,
• conexiune a serverului la internet.

Cea mai importantă condiție practică este simplă: modulul va răspunde bine doar atunci când magazinul are conținut pregătit pe care AI îl poate folosi.

Dacă magazinul folosește deja modulul Kowal AI Product Feed, acesta poate îndeplini rolul de pregătire și organizare a conținutului pentru AI. Pe pagina acestui modul, acest lucru a fost descris ca construirea unei baze de cunoștințe organizate și actuale pentru sistemele AI. AI Product Support este pasul următor natural, adică folosirea acestor cunoștințe în conversația cu utilizatorul. Sursă: Kowal AI Product Feed pentru OpenAI Vector Store

Instalarea modulului

Modulul este instalat prin composer.

Exemplu de proces de instalare:

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

Dacă magazinul funcționează în modul producție, după instalare executați și:

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

Unde se află configurația

După instalare, setările modulului se găsesc aici:

Stores > Configuration > Kowal AI > AI Product Support

Cum se configurează modulul

1. Activați chatul în panoul de administrare

În secțiunea General activați:

• Enable Chat

După salvarea setării, în panoul de administrare va apărea fila AI.

2. Decideți dacă activați chatul pe frontend

Dacă doriți ca și clienții magazinului să poată folosi chatul, activați:

• Enable Frontend Chat

Dacă modulul trebuie să deservească doar echipa magazinului, lăsați frontendul dezactivat.

3. Setați lungimea întrebării

Câmpul:

• Maximum Question Length

definește lungimea maximă a mesajului pe care utilizatorul îl poate trimite. Acest lucru ajută la menținerea ordinii și la limitarea interogărilor prea lungi, greu de citit.

4. Setați vizualizarea implicită a magazinului

Dacă magazinul funcționează în mai multe versiuni lingvistice sau are mai multe vizualizări de magazin, puteți indica:

• Default Store View

Acest lucru facilitează lucrul în panou și ajută la pornirea din contextul potrivit.

5. Activați sau dezactivați schimbarea manuală a vizualizării magazinului

Câmpul:

• Allow Store Switcher

decide dacă utilizatorul panoului poate schimba vizualizarea magazinului direct în popupul chatului.

Este util atunci când o singură echipă deservește mai multe versiuni ale magazinului.

6. Activați logarea tehnică pe durata implementării

Câmpul:

• Log Chat Requests

merită activat în etapa de configurare și testare. Astfel este mai ușor să verificați dacă modulul funcționează corect. După implementarea în producție, puteți decide dacă logarea trebuie să rămână activă.

Setările conexiunii cu AI

În secțiunea OpenAI configurați elementele de bază necesare funcționării modulului.

OpenAI API Key

Aceasta este cheia de acces la serviciul AI. Fără ea, modulul nu va prelua lista de modele, nu va citi sursa de cunoștințe și nu va trimite întrebarea.

Response Model

Acesta este modelul responsabil pentru construirea răspunsului.

Lista de modele se încarcă din API. Dacă după salvarea cheii nu apar opțiuni, se poate folosi butonul de reîmprospătare a listei de modele.

Vector Store

Aceasta este sursa de cunoștințe selectată pentru modul.

Cel mai simplu poate fi înțeles astfel:

• este locul în care sunt salvate conținuturile pe care chatul le folosește atunci când răspunde,
• modulul caută răspunsul tocmai acolo,
• dacă alegeți o sursă greșită, răspunsurile vor fi slabe sau incomplete.

Dacă magazinul are deja o bază de cunoștințe organizată și pregătită pentru AI, aici se indică exact această sursă.

Lista surselor de cunoștințe poate fi, de asemenea, reîmprospătată din configurare.

Maximum File Search Results

Această setare definește câte materiale auxiliare ia în considerare modulul la pregătirea unui singur răspuns.

În practică, aceasta influențează:

• calitatea răspunsului,
• viteza de funcționare,
• costul utilizării AI.

O setare inițială bună este o valoare medie, de exemplu 6.

Securitatea frontendului

Dacă chatul funcționează pe partea magazinului, merită să setați de la început limitele de securitate.

În secțiunea Frontend Security veți găsi:

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

Aceste setări ajută la limitarea:

• trimiterii prea frecvente a întrebărilor,
• abuzurilor din partea boților,
• consumului inutil de resurse și costuri.

Prompt de sistem suplimentar

În secțiunea Prompting se poate completa:

• System Prompt Template

Acest câmp nu este obligatoriu. În majoritatea implementărilor poate fi lăsat gol și se poate folosi setarea implicită a modulului.

Suprascrierea are sens doar atunci când magazinul dorește să introducă propriul stil de răspuns sau reguli suplimentare de comunicare.

Cum funcționează modulul din perspectiva utilizatorului

În panoul de administrare

După pornirea modulului, utilizatorul vede fila AI la marginea dreaptă a ecranului. După clic, se deschide panoul de chat.

În panou se poate:

• introduce o întrebare,
• primi un răspuns,
• vedea carduri de produse, dacă răspunsul se referă la un anumit produs,
• lucra fără reîncărcarea paginii.

Pe frontend

Dacă chatul a fost activat, o filă similară apare pe partea magazinului. Clientul poate adresa o întrebare fără a părăsi pagina produsului sau listingul.

Cum trebuie privită o astfel de implementare

Cel mai practic model arată astfel:

1. magazinul organizează conținuturile și pregătește baza de cunoștințe,
2. administratorul indică această bază de cunoștințe în configurația modulului,
3. utilizatorul folosește chatul,
4. răspunsurile sunt construite pe baza conținuturilor pregătite de magazin.

Această abordare oferă un rezultat mai bun decât pornirea chatului fără date pregătite.

Configurație inițială recomandată

Panou de administrare

• Enable Chat = Yes
• Enable Frontend Chat = în funcție de proiect
• Maximum Question Length = 1000
• Allow Store Switcher = Yes pentru mai multe vizualizări de magazin
• Log Chat Requests = Yes în etapa de testare
• Maximum File Search Results = 6

Frontend

• Requests Per Minute = valoare inițială prudentă
• Requests Per Hour = valoare adaptată la traficul magazinului
• Minimum Submit Delay = cel puțin 1

Ce trebuie verificat după implementare

După salvarea configurației, efectuați un test simplu:

1. verificați dacă în panoul de administrare a apărut fila AI,
2. deschideți popupul și trimiteți o întrebare,
3. asigurați-vă că răspunsul apare corect,
4. verificați dacă secțiunea de produse apare la întrebările despre produse concrete,
5. dacă frontendul este activat, verificați funcționarea filei și în magazin.

Cele mai frecvente probleme

Nu se văd modelele sau sursele de cunoștințe

Cel mai des, acest lucru înseamnă:

• lipsa unei chei OpenAI corecte,
• lipsa conexiunii serverului la internet,
• cache necurățat după modificări.

Chatul răspunde prea slab sau nu nimerește subiectul

Cea mai frecventă cauză nu este modulul în sine, ci calitatea bazei de cunoștințe pregătite. Dacă informațiile sunt incomplete, neactualizate sau prea sărace, și răspunsurile vor fi mai slabe.

Prin urmare, înainte de a evalua modulul în sine, merită să verificați:

• dacă descrierile produselor sunt utile și complete,
• dacă FAQ și documentația sunt actuale,
• dacă baza de cunoștințe conține într-adevăr conținuturile necesare utilizatorilor,
• dacă sursa de cunoștințe selectată este potrivită pentru magazinul respectiv.

Frontendul blochează utilizatorul prea repede

În acest caz, merită verificate setările limitelor și ale întârzierii de trimitere în secțiunea Frontend Security.

Checklist scurt de implementare

1. Instalați modulul prin composer.
2. Activați modulul și executați setup:upgrade.
3. Configurați conexiunea cu OpenAI.
4. Alegeți sursa de cunoștințe potrivită.
5. Activați chatul în admin.
6. Opțional, activați chatul pe frontend.
7. Setați limitele de securitate.
8. Testați funcționarea pe întrebări despre produse reale și conținuturi ale magazinului.

Scurtă descriere pentru secțiunea Instalare și configurare

Modulul se instalează prin composer și se configurează în Stores > Configuration > Kowal AI > AI Product Support. Administratorul introduce datele de acces la OpenAI, alege modelul și sursa de cunoștințe pentru magazin, apoi activează chatul în panoul de administrare și opțional pe frontend. Suplimentar, pot fi setate limite de securitate și pot fi ajustați parametrii de bază ai funcționării modulului.