Modul Magento 2 – Întreabă despre produs

MAGENTO 2 · ÎNTREBĂRI · FAQ · ASISTENT AI

Kowal Întreabă despre produs

Combină formularul de contact, FAQ-ul publicat și asistentul AI opțional. Folosește datele produsului și baza de cunoștințe, iar conversațiile repetitive transformă-le în răspunsuri disponibile pentru următorii clienți.

Formular și FAQ · Contextul produsului · Conversații și feedback

CUM FUNCȚIONEAZĂ ÎN PRACTICĂ

Kowal_ZapytajOProdukt este un modul Magento 2 extins pentru comunicarea cu clientul pe pagina produsului. Combină un formular clasic de întrebări, un FAQ structurat și un Asistent AI într-o singură soluție coerentă.

În practică, aceasta înseamnă că pagina produsului nu mai este doar un loc pentru prezentarea descrierii și a parametrilor tehnici, ci devine un punct activ de gestionare a întrebărilor clientului. Utilizatorul poate:

• să adreseze o întrebare clasică despre produs,
• să folosească răspunsurile pregătite publicate în FAQ,
• să discute cu Asistentul AI, care răspunde în contextul produsului vizualizat în acel moment.

Modulul a fost proiectat pentru a rezolva simultan două probleme:

• cea de suport, adică reducerea numărului de întrebări repetitive care ajung la echipa magazinului,
• cea de produs, adică construirea unei baze de cunoștințe în creștere, bine organizate, care în timp îmbunătățește calitatea răspunsurilor.

În multe magazine online, o parte importantă a întrebărilor clienților se repetă:

• dacă produsul este compatibil cu o anumită versiune Magento,
• dacă funcționează fără un modul suplimentar,
• cum decurge instalarea,
• dacă suportă mai multe limbi,
• dacă necesită modificări nestandard în șablon,
• cum se comportă într-un anumit scenariu de business.

Fără un instrument dedicat de suport, astfel de întrebări:

• încarcă echipa de suport,
• încetinesc deciziile de cumpărare,
• dispersează cunoștințele între e-mailuri, tickete și conversații comerciale,
• nu revin în magazin sub forma unui FAQ structurat.

Acest modul ordonează procesul. Mai întâi colectează întrebări și răspunsuri, apoi le organizează în FAQ, iar într-o etapă ulterioară le folosește ca context pentru Asistentul AI și pentru stratul de retrieval bazat pe OpenAI Vector Store.

Modulul funcționează pe straturi.

Pe pagina produsului se poate activa mecanismul standard de adresare a întrebărilor. Clientul trimite o solicitare, iar administratorul sau echipa magazinului o primește pentru procesare ulterioară. Este cea mai simplă și mai previzibilă formă de contact.

Întrebările și răspunsurile repetitive pot fi salvate și publicate ca FAQ al produsului. FAQ-ul poate fi afișat ca tab sau ca secțiune separată pe pagina produsului. Astfel, următorii utilizatori primesc răspunsul fără a fi nevoie să trimită o nouă întrebare.

Deasupra sau sub FAQ-ul standard apare un component ușor de conversație cu AI. Utilizatorul poate:

• să dea clic pe una dintre întrebările populare,
• să introducă propria întrebare în câmpul Zapytaj Asystenta o ten produkt.,
• să vadă răspunsul în aceeași zonă de conversație.

Asistentul nu funcționează ca un chatbot general al magazinului. A fost proiectat ca asistent de produs, ceea ce înseamnă că răspunsul trebuie să se bazeze în principal pe:

• datele produsului curent,
• FAQ-urile publicate,
• istoricul conversației curente,
• opțional, rezultatele de retrieval din OpenAI Vector Store.

Modulul pune la dispoziție un mecanism clasic de contact cu clientul.

Elementele principale:

• buton sau formular Zapytaj o produkt pe pagina produsului,
• suport AJAX pe partea de frontend,
• salvarea întrebării în baza de date,
• posibilitatea de a trimite o notificare e-mail,
• opțiunea de a activa modulul global sau doar pentru produsele selectate.

Această soluție are sens în continuare chiar și atunci când magazinul folosește deja Asistentul AI. Nu fiecare întrebare ar trebui gestionată automat. Unele situații necesită un răspuns comercial, o ofertă individuală sau confirmarea echipei tehnice.

FAQ-ul din acest modul nu este un adaos de marketing, ci un strat structurat de cunoștințe despre produs.

Administratorul poate:

• să revizuiască întrebările salvate,
• să adauge răspunsuri,
• să publice înregistrările selectate,
• să le afișeze pe pagina produsului.

FAQ-ul poate fi afișat:

• ca tab,
• ca secțiune separată pe pagina produsului.

Important este că FAQ-ul nu servește doar frontendului. Întrebările și răspunsurile publicate sunt folosite și ca unul dintre cele mai importante elemente de context pentru Asistentul AI.

Asistentul AI este elementul central al extinderii modulului.

Componentul este integrat pe pagina produsului, implicit sub galerie, și a fost pregătit astfel încât:

• să funcționeze ușor pe partea de frontend,
• să nu încarce inutil primul render al paginii,
• să fie lizibil pe desktop și mobile,
• să fie potrivit pentru extinderi ulterioare.

Utilizatorul vede:

• titlul secțiunii,
• textul introductiv,
• un singur câmp text pentru adresarea întrebării,
• lista celor mai populare întrebări,
• zona de conversație, care se extinde odată cu întrebările și răspunsurile următoare.

În versiunea actuală, formularul gestionează și:

• istoricul conversației în cadrul sesiunii,
• întrebări populare clicabile,
• feedback pentru răspunsurile AI,
• două variante de culoare: deschisă și închisă.

Sub câmpul text pot fi afișate cele mai populare întrebări despre produs.

Această soluție îndeplinește mai multe funcții simultan:

• accelerează începutul conversației,
• îi sugerează clientului ce întreabă cel mai des alții,
• permite folosirea răspunsurilor FAQ pregătite fără costul unei interogări către modelul AI,
• îmbunătățește UX și reduce numărul de interacțiuni goale.

Popularitatea întrebărilor nu se mai bazează doar pe ordinea manuală. Modulul colectează date despre clicuri, întrebări adresate și feedback, iar apoi, pe această bază, clasifică FAQ-urile.

Cea mai importantă premisă de proiectare a fost ca AI să nu răspundă în afara contextului produsului.

Răspunsul poate fi construit pe baza mai multor surse:

• datele de bază ale produsului,
• short description,
• full description,
• atributele de produs selectate,
• FAQ-urile publicate,
• istoricul conversației.

În plus, modulul permite limitarea atributelor care ajung la model, astfel încât să se poată evita:

• supraîncărcarea promptului,
• trimiterea datelor inutile,
• un cost prea ridicat al tokenilor,
• transmiterea accidentală a unor conținuturi care nu sunt utile clientului.

Unul dintre elementele cheie ale extinderii este integrarea cu OpenAI Responses API.

În scenarii mai simple, modulul poate funcționa în modul de context local al produsului și FAQ. În implementări mai complexe, suportă:

• file_search,
• vector_store_ids,
• filtrarea după sku,
• filtrarea după product_sku,
• filtrarea după store_code,
• filtrarea după content_type,
• limitarea numărului de rezultate retrieval,
• modul hybrid,
• modul retrieval-first.

Aceasta înseamnă că răspunsul AI se poate baza nu doar pe datele transmise direct din Magento la solicitarea respectivă, ci și pe documente deja încărcate anterior în Vector Store.

În practică, acest lucru oferă două beneficii:

• cost mai mic, deoarece nu trebuie trimis de fiecare dată întregul set de date către model,
• scalabilitate mai bună, deoarece retrieval poate gestiona o bază de cunoștințe mai mare decât un prompt simplu cu JSON local.

Modulul a fost pregătit pentru colaborarea cu Kowal_AiProductFeed.

Această integrare permite:

• sincronizarea datelor de produs către OpenAI Vector Store,
• utilizarea documentelor de tip product.core, product.faq, product.docs și altele,
• sincronizarea suplimentară a unui produs selectat înainte de conversație,
• limitarea retrieval la anumite tipuri de conținut.

Această abordare este deosebit de utilă acolo unde:

• descrierile produselor sunt lungi,
• FAQ-ul este extins,
• magazinul gestionează multe produse tehnice,
• datele de produs sunt dezvoltate constant.

Modulul nu se oprește la simpla generare a răspunsului.

Salvează și date care permit evaluarea funcționării soluției:

• numărul de clicuri în FAQ,
• numărul de întrebări adresate,
• evaluări util / inutil,
• istoricul conversațiilor,
• metadatele tehnice ale răspunsului AI,
• utilizarea tokenilor,
• payload-ul solicitării și al răspunsului, dacă activezi logarea diagnostică.

Astfel, implementarea nu este o cutie neagră. Echipa poate analiza:

• ce întrebări apar cel mai frecvent,
• dacă AI folosește retrieval,
• dacă răspunsurile sunt relevante,
• ce înregistrări merită fixate ca FAQ,
• cum se schimbă costul și calitatea după modificarea promptului sau a configurației.

Unul dintre cele mai importante avantaje ale modulului este posibilitatea de a transforma conversațiile în FAQ-uri noi.

Procesul arată astfel:

1. Clienții adresează întrebări.
2. Modulul salvează conversațiile.
3. Mecanismul de analiză identifică candidații FAQ.
4. Administratorul revizuiește candidații în panou.
5. După acceptare, candidatul ajunge în FAQ-ul standard al produsului.

Este un model de lucru foarte practic, deoarece cunoștințele nu se pierd în istoricul conversațiilor. Cu fiecare iterație, magazinul construiește un strat de răspunsuri mai bun:

• pentru clienți,
• pentru FAQ,
• pentru Asistentul AI,
• pentru retrieval viitor.

Modulul a fost pregătit astfel încât funcționarea sa să poată fi controlată.

Configurația include, printre altele:

• restricții de acces pentru vizitatori,
• TTL pentru conversații,
• limite de solicitări,
• sanitizarea datelor de intrare,
• opțiuni de logare diagnostică,
• configurarea reCAPTCHA,
• un domeniu controlat al datelor trimise către model.

Acest lucru este important, deoarece implementarea AI pe pagina produsului nu ar trebui să însemne pierderea controlului asupra:

• costului,
• datelor,
• calității răspunsurilor,
• încărcării frontendului.

Modulul se potrivește cel mai bine proiectelor în care:

• catalogul este mai mare decât câteva produse simple,
• clienții pun frecvent întrebări despre compatibilitate, configurare sau implementare,
• echipa dorește să combine FAQ-ul clasic cu un strat AI modern,
• compania dezvoltă documentația de produs și dorește să o folosească în retrieval,
• este important controlul asupra a ceea ce știe AI și de unde își ia răspunsurile.

Se potrivește deosebit de bine magazinelor care vând:

• module Magento,
• produse tehnice,
• soluții B2B,
• instrumente care necesită implementare sau configurare,
• produse pentru care clientul așteaptă un răspuns rapid și precis încă înainte de cumpărare.

Kowal_ZapytajOProdukt nu mai este doar un modul pentru un formular de contact simplu pe pagina produsului.

Este un strat complet de comunicare de produs, care:

• colectează întrebări,
• publică FAQ-uri,
• răspunde prin AI,
• folosește Vector Store,
• analizează conversațiile,
• și le transformă într-o bază de cunoștințe a magazinului tot mai bună.

Astfel, pagina produsului devine un loc de conversație reală cu clientul, nu doar o pagină statică cu descriere și preț.

În Stores → Configuration → Întreabă despre produs poți începe cu formularul și FAQ-ul, precum și cu o adresă de e-mail suplimentară. Funcțiile AI le activezi separat: setezi providerul, cheia API, modelul, domeniul contextului și opțiunile Vector Store. Integrarea cu Kowal_AiProductFeed este opțională.

AI necesită acces la API și facturare separată. Calitatea răspunsurilor și costul depind de context, model și configurație. Întrebările care necesită confirmare individuală pot ajunge la echipa magazinului prin formularul clasic.

Pachetul include opțional Kowal_ZapytajOProduktHyva pentru formular, FAQ și asistentul AI. Adaptorul este dezactivat implicit. Pentru Hyvä îl activezi suplimentar și verifici poziționarea componentelor în tema utilizată. Magazinul Luma folosește modulul de bază.

Pachetul kowal/module-zapytajoprodukt, modulul Kowal_ZapytajOProdukt. După configurarea accesului la repository-ul Kowal, instalează pachetul, activează modulul, actualizează Magento și golește cache-ul. În producție, include compilarea și implementarea conținutului static conform procesului magazinului.

1. Configurezi comunicarea
Activezi formularul, FAQ-ul și, opțional, asistentul AI.

2. Clientul pune o întrebare
Folosește întrebări pregătite sau introduce propria întrebare.

3. Dezvolți baza de cunoștințe
Revizuiești conversațiile și aprobi candidații FAQ.

Clientul întreabă despre compatibilitatea produsului. Echipa de suport răspunde prin formular, iar întrebarea repetitivă poate fi publicată în FAQ.

Asistentul AI opțional folosește datele produsului, FAQ-ul și Vector Store configurat. Administratorul verifică calitatea conversațiilor și propunerile de FAQ-uri noi.