Magento-2-Modul – Fragen zum Produkt

Kowal_ZapytajOProdukt ist ein umfangreiches Magento-2-Modul für die Kommunikation mit Kunden auf der Produktseite. Es kombiniert ein klassisches Frageformular, strukturierte FAQ und einen AI-Assistenten in einer einheitlichen Lösung.

In der Praxis bedeutet das, dass die Produktseite nicht mehr nur ein Ort zur Präsentation von Beschreibung und technischen Parametern ist, sondern zu einem aktiven Kontaktpunkt für Kundenfragen wird. Der Benutzer kann:

• eine klassische Frage zum Produkt stellen,
• fertige Antworten aus den veröffentlichten FAQ nutzen,
• mit dem AI-Assistenten sprechen, der im Kontext des aktuell angesehenen Produkts antwortet.

Das Modul wurde so entwickelt, dass es zwei Probleme gleichzeitig löst:

• servicebezogen, also die Anzahl wiederkehrender Fragen an das Shop-Team zu reduzieren,
• produktbezogen, also eine wachsende, strukturierte Wissensdatenbank aufzubauen, die mit der Zeit die Qualität der Antworten verbessert.

Geschäftsziel

In vielen Online-Shops wiederholt sich ein großer Teil der Kundenfragen:

• ob das Produkt mit einer bestimmten Magento-Version kompatibel ist,
• ob es ohne zusätzliches Modul funktioniert,
• wie die Installation abläuft,
• ob es mehrere Sprachen unterstützt,
• ob es individuelle Änderungen am Template erfordert,
• wie es sich in einem konkreten Geschäftsszenario verhält.

Ohne ein dediziertes Support-Tool führen solche Fragen dazu, dass sie:

• den Support belasten,
• Kaufentscheidungen verlangsamen,
• Wissen auf E-Mail-Postfächer, Tickets und Vertriebsgespräche verteilen,
• nicht in Form strukturierter FAQ in den Shop zurückfließen.

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

Grundidee der Lösung

Das Modul arbeitet schichtweise.

Ebene 1. Klassische Produktfragen

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

Ebene 2. FAQ

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

Ebene 3. AI-Assistent

Über oder unter den Standard-FAQ erscheint eine schlanke Komponente für die Unterhaltung mit AI. Der Benutzer kann:

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

Der Assistent funktioniert nicht als allgemeiner Shop-Chatbot. Er wurde als Produktassistent entwickelt, was bedeutet, dass die Antwort vor allem auf folgenden Grundlagen basieren soll:

• Daten des aktuellen Produkts,
• veröffentlichten FAQ,
• dem Verlauf des aktuellen Gesprächs,
• optional auf Retrieval-Ergebnissen aus OpenAI Vector Store.

Funktionsumfang des Moduls

1. Formular Zapytaj o produkt

Das Modul stellt einen klassischen Mechanismus für den Kundenkontakt bereit.

Die wichtigsten Elemente:

• Button 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, das Modul global oder nur für ausgewählte Produkte zu aktivieren.

Diese Lösung ist auch dann weiterhin sinnvoll, wenn der Shop bereits den AI-Assistenten nutzt. Nicht jede Frage sollte automatisch beantwortet werden. Ein Teil der Anliegen erfordert eine vertriebliche Antwort, ein individuelles Angebot oder eine Bestätigung durch das technische Team.

2. FAQ auf der Produktseite

Die FAQ in diesem Modul sind kein Marketing-Zusatz, sondern eine strukturierte Wissensebene zum Produkt.

Der Administrator kann:

• gespeicherte Fragen prüfen,
• Antworten ergänzen,
• ausgewählte Datensätze veröffentlichen,
• sie auf der Produktseite anzeigen.

Die FAQ können angezeigt werden:

• als Tab,
• 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 AI-Assistenten genutzt.

3. AI-Assistent auf der Produktseite

Der AI-Assistent ist das zentrale Element der Modulerweiterung.

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

• im Frontend leichtgewichtig arbeitet,
• das erste Rendering der Seite nicht unnötig belastet,
• auf Desktop und Mobile übersichtlich ist,
• sich für zukünftige Erweiterungen eignet.

Der Benutzer sieht:

• den Titel des Abschnitts,
• einen einführenden Text,
• ein einzelnes Textfeld zum Stellen einer Frage,
• eine Liste der beliebtesten Fragen,
• einen Gesprächsbereich, der sich mit weiteren Fragen und Antworten erweitert.

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

• den Gesprächsverlauf innerhalb der Sitzung,
• anklickbare beliebte Fragen,
• Feedback zu AI-Antworten,
• zwei Farbvarianten: hell und dunkel.

4. Beliebte Fragen

Unter dem Textfeld können die beliebtesten Fragen zum Produkt angezeigt werden.

Diese Lösung erfüllt mehrere Funktionen gleichzeitig:

• sie beschleunigt den Gesprächsstart,
• sie zeigt dem Kunden, wonach andere am häufigsten fragen,
• sie ermöglicht die Nutzung fertiger FAQ-Antworten ohne Kosten für eine Anfrage an das AI-Modell,
• sie verbessert die UX und reduziert die Anzahl leerer Interaktionen.

Die Beliebtheit der Fragen basiert nicht mehr nur auf einer manuellen Reihenfolge. Das Modul sammelt Daten zu Klicks, gestellten Fragen und Feedback und ordnet die FAQ anschließend auf dieser Grundlage.

5. Kontext der AI-Antwort

Die wichtigste Designannahme war, dass die AI nicht losgelöst vom Produkt antwortet.

Die Antwort kann auf mehreren Quellen aufgebaut werden:

• grundlegenden Produktdaten,
• short description,
• full description,
• ausgewählten Produktattributen,
• veröffentlichten FAQ,
• dem Gesprächsverlauf.

Zusätzlich ermöglicht das Modul zu begrenzen, welche Attribute an das Modell übergeben werden. Dadurch lässt sich vermeiden:

• eine Überladung des Prompts,
• das Senden unnötiger Daten,
• zu hohe Token-Kosten,
• die versehentliche Übermittlung von Inhalten, die für den Kunden nicht nützlich sind.

6. Integration mit OpenAI Responses API und Vector Store

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

In einfacheren Szenarien kann das Modul im Modus eines lokalen Produkt- und FAQ-Kontexts arbeiten. In 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 der Retrieval-Ergebnisse,
• Modus hybrid,
• Modus retrieval-first.

Das bedeutet, dass die AI-Antwort nicht nur auf Daten basieren kann, die bei einem bestimmten Request direkt aus Magento übergeben werden, sondern auch auf Dokumenten, die bereits zuvor in den Vector Store eingespeist wurden.

In der Praxis bietet das zwei Vorteile:

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

7. Integration mit Kowal_AiProductFeed

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 des Typs product.core, product.faq, product.docs und anderen,
• die Nachsynchronisierung eines ausgewählten Produkts vor dem Gespräch,
• die Begrenzung des Retrievals auf konkrete Inhaltstypen.

Dieser Ansatz ist besonders nützlich dort, wo:

• Produktbeschreibungen lang sind,
• die FAQ umfangreich sind,
• der Shop viele technische Produkte unterstützt,
• Produktdaten kontinuierlich weiterentwickelt werden.

8. Analyse und Feedback

Das Modul endet nicht mit der reinen Generierung einer Antwort.

Es speichert außerdem Daten, mit denen bewertet werden kann, ob die Lösung funktioniert:

• Anzahl der Klicks in den FAQ,
• Anzahl der gestellten Fragen,
• Bewertungen hilfreich / nicht hilfreich,
• Gesprächsverläufe,
• technische Metadaten der AI-Antwort,
• Token Usage,
• Request- und Response-Payload, wenn Sie das Diagnose-Logging aktivieren.

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

• welche Fragen am häufigsten auftreten,
• ob die AI Retrieval nutzt,
• ob die Antworten zutreffend sind,
• welche Datensätze als FAQ dauerhaft gespeichert werden sollten,
• wie sich Kosten und Qualität nach einer Änderung des Prompts oder der Konfiguration verändern.

9. FAQ-Kandidaten und administrativer Workflow

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 Panel.
5. Nach der Freigabe wird der Kandidat in die Standard-Produkt-FAQ übernommen.

Das ist ein sehr praktisches Arbeitsmodell, weil 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 AI-Assistenten,
• für zukünftiges Retrieval.

10. Sicherheit und Kontrolle

Das Modul wurde so vorbereitet, dass sich sein Betrieb kontrollieren lässt.

Die Konfiguration umfasst unter anderem:

• Zugriffsbeschränkungen für Gäste,
• TTL von Gesprächen,
• Anfragelimits,
• Sanitizing von Eingabedaten,
• Optionen für Diagnose-Logging,
• reCAPTCHA-Konfiguration,
• kontrollierten Umfang der an das Modell gesendeten Daten.

Das ist wichtig, denn die Implementierung von AI auf der Produktseite sollte nicht bedeuten, die Kontrolle zu verlieren über:

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

11. Für wen ist dieses Modul geeignet

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

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

Besonders gut passt es zu Shops, die Folgendes verkaufen:

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

12. Zusammenfassung

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

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

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

Dadurch wird die Produktseite zu einem Ort echter Kommunikation mit dem Kunden und nicht nur zu einer statischen Seite mit Beschreibung und Preis.