Magento 2 Modul – Frage zum Produkt

MAGENTO 2 · FRAGEN · FAQ · KI-ASSISTENT

Kowal Frage zum Produkt

Kombinieren Sie Kontaktformular, veröffentlichte FAQ und einen optionalen KI-Assistenten. Nutzen Sie Produktdaten und die Wissensdatenbank und verwandeln Sie wiederkehrende Gespräche in Antworten, die weiteren Kunden zur Verfügung stehen.

Formular und FAQ · Produktkontext · Gespräche und Feedback

SO FUNKTIONIERT ES IN DER PRAXIS

Kowal_ZapytajOProdukt ist ein umfangreiches Magento 2 Modul für die Kundenkommunikation auf der Produktseite. Es vereint ein klassisches Frageformular, strukturierte FAQ und einen KI-Assistenten in einer konsistenten Lösung.

In der Praxis bedeutet dies, dass die Produktseite nicht mehr nur der Präsentation von Beschreibungen und technischen Parametern dient, sondern zu einem aktiven Anlaufpunkt für Kundenfragen wird. Benutzer können:

• eine klassische Frage zum Produkt stellen,
• auf fertige, in den FAQ veröffentlichte Antworten zugreifen,
• mit dem KI-Assistenten sprechen, der im Kontext des aktuell angezeigten Produkts antwortet.

Das Modul wurde entwickelt, um zwei Probleme gleichzeitig zu lösen:

• den Supportaufwand, indem die Zahl wiederkehrender Fragen an das Shop-Team reduziert wird,
• die Produktkommunikation, indem eine wachsende, strukturierte Wissensdatenbank aufgebaut wird, die die Qualität der Antworten mit der Zeit verbessert.

In vielen Onlineshops wiederholt sich ein erheblicher Teil der Kundenfragen:

• Ist das Produkt mit einer bestimmten Magento-Version kompatibel?
• Funktioniert es ohne zusätzliches Modul?
• Wie läuft die Installation ab?
• Unterstützt es mehrere Sprachen?
• Sind individuelle Änderungen am Template erforderlich?
• Wie verhält es sich in einem bestimmten Geschäftsszenario?

Ohne ein spezielles Tool für die Bearbeitung solcher Fragen:

• wird der Support zusätzlich belastet,
• werden Kaufentscheidungen verzögert,
• verteilt sich das Wissen auf E-Mail-Postfächer, Tickets und Verkaufsgespräche,
• fließen die Informationen nicht als strukturierte FAQ in den Shop zurück.

Dieses Modul strukturiert den gesamten Prozess. Zunächst sammelt es Fragen und Antworten, anschließend ordnet es diese in FAQ ein und nutzt sie im nächsten Schritt als Kontext für den KI-Assistenten sowie für die auf OpenAI Vector Store basierende Retrieval-Schicht.

Das Modul arbeitet in mehreren Ebenen.

Auf der Produktseite kann ein standardmäßiger Mechanismus zum Stellen von Fragen aktiviert werden. Der Kunde sendet eine Anfrage, die der Administrator oder das Shop-Team zur weiteren Bearbeitung erhält. Dies ist die einfachste und am besten vorhersehbare Form der Kontaktaufnahme.

Wiederkehrende Fragen und Antworten können gespeichert und als Produkt-FAQ veröffentlicht werden. Die FAQ können als Registerkarte oder separater Abschnitt auf der Produktseite angezeigt werden. So erhalten weitere Kunden eine Antwort, ohne eine neue Frage senden zu müssen.

Über oder unter den standardmäßigen FAQ erscheint eine schlanke Komponente für Gespräche mit der KI. Benutzer können:

• eine der häufig gestellten Fragen anklicken,
• eine eigene Frage in das Feld Zapytaj Asystenta o ten produkt. eingeben,
• die Antwort im selben Gesprächsbereich anzeigen.

Der Assistent ist kein allgemeiner Shop-Chatbot. Er wurde als Produktassistent konzipiert. Das bedeutet, dass seine Antworten vor allem auf folgenden Informationen basieren:

• Daten des aktuellen Produkts,
• veröffentlichte FAQ,
• Verlauf des aktuellen Gesprächs,
• optional Retrieval-Ergebnisse aus OpenAI Vector Store.

Das Modul stellt einen klassischen Mechanismus für die Kundenkontaktaufnahme bereit.

Die wichtigsten Elemente:

• Schaltfläche oder Formular Zapytaj o produkt auf der Produktseite,
• AJAX-Unterstützung im Frontend,
• Speicherung der Frage in der Datenbank,
• Möglichkeit zum Versand einer E-Mail-Benachrichtigung,
• Option zur globalen Aktivierung des Moduls oder nur für ausgewählte Produkte.

Diese Lösung ist auch dann sinnvoll, wenn der Shop bereits den KI-Assistenten verwendet. Nicht jede Frage sollte automatisch bearbeitet werden. Einige Anliegen erfordern eine vertriebliche Antwort, ein individuelles Angebot oder eine Bestätigung durch das technische Team.

Die FAQ in diesem Modul sind kein Marketingzusatz, sondern eine strukturierte Wissensebene zum Produkt.

Der Administrator kann:

• gespeicherte Fragen einsehen,
• Antworten ergänzen,
• ausgewählte Einträge veröffentlichen,
• sie auf der Produktseite anzeigen.

Die FAQ können angezeigt werden:

• als Registerkarte,
• als separater Abschnitt auf der Produktseite.

Wichtig ist, dass die FAQ nicht nur dem Frontend dienen. Veröffentlichte Fragen und Antworten werden außerdem als eines der wichtigsten Kontextelemente für den KI-Assistenten genutzt.

Der KI-Assistent ist das zentrale Element der Modulerweiterung.

Die Komponente ist auf der Produktseite standardmäßig unterhalb der Galerie eingebettet und wurde so konzipiert, dass sie:

• ressourcenschonend im Frontend arbeitet,
• das erste Rendering der Seite nicht unnötig belastet,
• auf Desktop- und Mobilgeräten gut lesbar ist,
• für weitere Erweiterungen geeignet ist.

Benutzer sehen:

• den Titel des Abschnitts,
• einen Einführungstext,
• ein einzelnes Textfeld zum Stellen einer Frage,
• eine Liste der häufigsten Fragen,
• einen Gesprächsbereich, der mit weiteren Fragen und Antworten erweitert wird.

In der aktuellen Version unterstützt das Formular außerdem:

• den Gesprächsverlauf innerhalb einer Sitzung,
• anklickbare häufige Fragen,
• Feedback zu KI-Antworten,
• zwei Farbvarianten: hell und dunkel.

Unter dem Textfeld können die häufigsten Fragen zum Produkt angezeigt werden.

Diese Lösung erfüllt mehrere Funktionen gleichzeitig:

• Sie erleichtert den Gesprächseinstieg,
• zeigt Kunden, welche Fragen andere am häufigsten stellen,
• ermöglicht die Nutzung fertiger FAQ-Antworten ohne Kosten für eine Anfrage an das KI-Modell,
• verbessert die User Experience und reduziert leere Interaktionen.

Die Beliebtheit der Fragen basiert nicht mehr ausschließlich auf einer manuellen Reihenfolge. Das Modul erfasst Daten zu Klicks, gestellten Fragen und Feedback und erstellt auf dieser Grundlage ein Ranking der FAQ.

Eine der wichtigsten Designvorgaben bestand darin, dass die KI nicht losgelöst vom Produkt antwortet.

Die Antwort kann auf Grundlage mehrerer Quellen erstellt werden:

• grundlegende Produktdaten,
• short description,
• full description,
• ausgewählte Produktattribute,
• veröffentlichte FAQ,
• Gesprächsverlauf.

Zusätzlich ermöglicht das Modul die Einschränkung der Attribute, die an das Modell übermittelt werden. Dadurch lässt sich Folgendes vermeiden:

• ein überladener Prompt,
• die Übermittlung unnötiger Daten,
• zu hohe Token-Kosten,
• die versehentliche Weitergabe von Inhalten, die für Kunden nicht relevant sind.

Ein zentrales Element der Erweiterung ist die Integration mit OpenAI Responses API.

In einfacheren Szenarien kann das Modul mit dem lokalen Produkt- und FAQ-Kontext arbeiten. Bei umfangreicheren Implementierungen unterstützt es:

• file_search,
• vector_store_ids,
• Filterung nach sku,
• Filterung nach product_sku,
• Filterung nach store_code,
• Filterung nach content_type,
• Begrenzung der Anzahl von Retrieval-Ergebnissen,
• den Modus hybrid,
• den Modus retrieval-first.

Das bedeutet, dass eine KI-Antwort nicht nur auf Daten basieren kann, die bei einer bestimmten Anfrage direkt aus Magento übermittelt werden, sondern auch auf Dokumenten, die zuvor in Vector Store eingespeist wurden.

In der Praxis bietet dies zwei Vorteile:

• geringere Kosten, da nicht jedes Mal der gesamte Datensatz an das Modell gesendet werden muss,
• bessere Skalierbarkeit, da Retrieval eine größere Wissensdatenbank verarbeiten kann als ein einfacher Prompt mit lokalem JSON.

Das Modul wurde für die Zusammenarbeit mit Kowal_AiProductFeed vorbereitet.

Diese Integration ermöglicht:

• die Synchronisierung von Produktdaten mit OpenAI Vector Store,
• die Nutzung von Dokumenten der Typen product.core, product.faq, product.docs und weiteren,
• die Synchronisierung eines ausgewählten Produkts vor dem Gespräch,
• die Einschränkung des Retrievals auf bestimmte Inhaltstypen.

Dieser Ansatz ist besonders nützlich, wenn:

• Produktbeschreibungen lang sind,
• umfangreiche FAQ vorhanden sind,
• der Shop zahlreiche technische Produkte anbietet,
• Produktdaten kontinuierlich erweitert werden.

Das Modul endet nicht bei der Generierung einer Antwort.

Es speichert außerdem Daten, anhand derer sich beurteilen lässt, ob die Lösung funktioniert:

• Anzahl der Klicks auf FAQ,
• Anzahl der gestellten Fragen,
• Bewertungen hilfreich / nicht hilfreich,
• Gesprächsverlauf,
• technische Metadaten der KI-Antworten,
• Token-Nutzung,
• Payload von Anfrage und Antwort, sofern die Diagnoseprotokollierung aktiviert ist.

Dadurch ist die Implementierung keine Blackbox. Das Team kann analysieren:

• welche Fragen am häufigsten gestellt werden,
• ob die KI Retrieval nutzt,
• ob die Antworten zutreffend sind,
• welche Einträge als FAQ dauerhaft übernommen werden sollten,
• wie sich Kosten und Qualität nach Änderungen am Prompt oder an der Konfiguration entwickeln.

Einer der wichtigsten Vorteile des Moduls ist die Möglichkeit, Gespräche in neue FAQ umzuwandeln.

Der Prozess sieht wie folgt aus:

1. Kunden stellen Fragen.
2. Das Modul speichert die Gespräche.
3. Der Analysemechanismus ermittelt FAQ-Kandidaten.
4. Der Administrator prüft die Kandidaten im Admin-Panel.
5. Nach der Freigabe wird der Kandidat in die standardmäßigen Produkt-FAQ übernommen.

Dies ist ein sehr praktisches Arbeitsmodell, da Wissen nicht im Gesprächsverlauf verloren geht. Mit jeder weiteren Iteration baut der Shop eine bessere Antwortebene auf:

• für Kunden,
• für die FAQ,
• für den KI-Assistenten,
• für zukünftiges Retrieval.

Das Modul wurde so entwickelt, dass sein Betrieb kontrolliert werden kann.

Die Konfiguration umfasst unter anderem:

• Zugriffsbeschränkungen für Gäste,
• TTL für Gespräche,
• Anfragelimits,
• Bereinigung von Eingabedaten,
• Optionen für die Diagnoseprotokollierung,
• reCAPTCHA-Konfiguration,
• einen kontrollierten Umfang der an das Modell übermittelten Daten.

Dies ist wichtig, da die Implementierung von KI auf der Produktseite nicht zu einem Kontrollverlust führen sollte über:

• Kosten,
• Daten,
• Antwortqualität,
• Frontend-Belastung.

Das Modul eignet sich am besten für Projekte, bei denen:

• der Katalog mehr als nur einige einfache Produkte umfasst,
• Kunden häufig Fragen zu Kompatibilität, Konfiguration oder Implementierung stellen,
• das Team klassische FAQ mit einer modernen KI-Ebene verbinden möchte,
• das Unternehmen die Produktdokumentation erweitert und für Retrieval nutzen möchte,
• die Kontrolle darüber wichtig ist, was die KI weiß und woher sie ihre Antworten bezieht.

Besonders gut eignet es sich für Shops, die Folgendes verkaufen:

• Magento Module,
• technische Produkte,
• B2B-Lösungen,
• Tools, die eine Implementierung oder Konfiguration erfordern,
• Produkte, bei denen Kunden bereits vor dem Kauf eine schnelle und präzise Antwort erwarten.

Kowal_ZapytajOProdukt ist nicht mehr nur ein Modul für ein einfaches Kontaktformular auf der Produktseite.

Es ist eine vollständige Ebene für die Produktkommunikation, die:

• Fragen sammelt,
• FAQ veröffentlicht,
• mithilfe von KI antwortet,
• Vector Store nutzt,
• Gespräche analysiert,
• und sie in eine immer bessere Wissensdatenbank des Shops umwandelt.

Dadurch wird die Produktseite zu einem Ort für echte Kundengespräche und ist nicht mehr nur eine statische Seite mit Beschreibung und Preis.

Unter Stores → Configuration → Frage zum Produkt können Sie mit dem Formular, den FAQ und einer zusätzlichen E-Mail-Adresse beginnen. Die KI-Funktionen aktivieren Sie separat: Sie legen Provider, API-Schlüssel, Modell, Kontextumfang und Vector-Store-Optionen fest. Die Integration mit Kowal_AiProductFeed ist optional.

Für die KI sind ein API-Zugang und eine separate Abrechnung erforderlich. Die Qualität der Antworten und die Kosten hängen vom Kontext, Modell und von der Konfiguration ab. Fragen, die eine individuelle Bestätigung erfordern, können über das klassische Formular an das Shop-Team weitergeleitet werden.

Das Paket enthält das optionale Modul Kowal_ZapytajOProduktHyva für das Formular, die FAQ und den KI-Assistenten. Der Adapter ist standardmäßig deaktiviert. Für Hyvä aktivieren Sie ihn zusätzlich und prüfen die Platzierung der Komponenten im verwendeten Theme. Ein Luma-Shop verwendet das Basismodul.

Paket kowal/module-zapytajoprodukt, Modul Kowal_ZapytajOProdukt. Nachdem Sie den Zugriff auf das Kowal-Repository konfiguriert haben, installieren Sie das Paket, aktivieren das Modul, aktualisieren Magento und leeren den Cache. Berücksichtigen Sie in der Produktionsumgebung die Kompilierung und Bereitstellung statischer Inhalte entsprechend dem Prozess Ihres Shops.

1. Sie konfigurieren die Kommunikation
Sie aktivieren das Formular, die FAQ und optional den KI-Assistenten.

2. Der Kunde stellt eine Frage
Er nutzt vorgegebene Fragen oder gibt eine eigene Frage ein.

3. Sie erweitern die Wissensdatenbank
Sie prüfen Gespräche und bestätigen FAQ-Kandidaten.

Ein Kunde fragt nach der Kompatibilität des Produkts. Das Shop-Team antwortet über das Formular und kann eine wiederkehrende Frage in den FAQ veröffentlichen.

Der optionale KI-Assistent nutzt Produktdaten, FAQ und den konfigurierten Vector Store. Der Administrator prüft die Qualität der Gespräche und Vorschläge für neue FAQ.