AI Product Support pentru Magento 2

Instalare și configurare

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

Documentul este scris pentru un magazin care dorește să implementeze un modul gata de utilizare și să înceapă să folosească chatul AI fără a intra în detalii tehnice despre funcționarea la nivel de cod.

Cel mai bine este să tratezi acest modul ca pe un nivel 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 ai nevoie de:

• un magazin Magento 2 funcțional,
• acces la server,
• composer,
• un cont OpenAI,
• o 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 actualizate pentru sistemele AI. AI Product Support este următorul pas firesc, adică folosirea acestor cunoștințe în conversația cu utilizatorul. Sursă: Kowal AI Product Feed pentru OpenAI Vector Store

Instalarea modulului

Modulul se instalează prin composer.

Exemplu de proces de instalare:

Datele de acces la repository-ul Composer, adresa de e-mail a clientului și tokenul de licență, le vei primi prin e-mail după achiziție. Sunt disponibile și în panoul clientului după autentificarea pe kowal.store. Înlocuiește TWOJ_EMAIL_KLIENTA cu adresa de e-mail a contului tău, iar TWOJ_TOKEN cu tokenul primit. Execută comenzile în directorul principal 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

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

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

Unde se află configurarea

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

Stores > Configuration > Kowal AI > AI Product Support

Cum se configurează modulul

1. Activează chatul în panoul de administrare

În secțiunea General, activează:

• Enable Chat

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

2. Decide dacă activezi chatul pe frontend

Dacă dorești ca și clienții magazinului să poată folosi chatul, activează:

• Enable Frontend Chat

Dacă modulul trebuie să servească doar echipei magazinului, lasă frontendul dezactivat.

3. Setează 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 solicitărilor prea lungi și greu de citit.

4. Setează vizualizarea implicită a magazinului

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

• Default Store View

Acest lucru facilitează munca în panou și ajută la pornirea din contextul corect.

5. Activează sau dezactivează 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ă gestionează mai multe versiuni ale magazinului.

6. Activează 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ă verifici dacă modulul funcționează corect. După implementarea în producție, poți decide dacă logarea trebuie să rămână activă.

Setările conexiunii cu AI

În secțiunea OpenAI, configurează 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 descărca 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 modelelor 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 se poate înțelege astfel:

• este locul în care sunt salvate conținuturile pe care chatul le folosește când răspunde,
• modulul caută răspunsurile exact acolo,
• dacă alegi sursa greșită, răspunsurile vor fi slabe sau incomplete.

Dacă magazinul are deja o bază de cunoștințe organizată, pregătită pentru AI, aici se indică tocmai 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 de suport ia în considerare modulul la pregătirea unui răspuns.

În practică, 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ă setezi imediat limitele de securitate.

În secțiunea Frontend Security vei 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 poți:

• să introduci o întrebare,
• să primești un răspuns,
• să vezi cardurile de produse, dacă răspunsul se referă la un anumit produs,
• să lucrezi fără reîncărcarea paginii.

Pe frontend

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

Cum să gândești o astfel de implementare

Cel mai practic model arată astfel:

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

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

Configurare inițială recomandată

Panoul 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ă traficului magazinului
• Minimum Submit Delay = cel puțin 1

Ce trebuie verificat după implementare

După salvarea configurării, efectuează un test simplu:

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

Cele mai frecvente probleme

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

Cel mai des î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.

Înainte de a evalua modulul, merită să verifici:

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

Frontendul blochează utilizatorul prea repede

Atunci merită să verifici setările limitelor și întârzierea trimiterii în secțiunea Frontend Security.

Checklist scurt de implementare

1. Instalează modulul prin composer.
2. Activează modulul și execută setup:upgrade.
3. Configurează conexiunea cu OpenAI.
4. Alege sursa de cunoștințe potrivită.
5. Activează chatul în admin.
6. Opțional, activează chatul pe frontend.
7. Setează limitele de securitate.
8. Testează funcționarea pe întrebări despre produse reale și conținutul 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. În plus, se pot seta limite de securitate și se pot adapta parametrii de bază ai funcționării modulului.