AI Product Support für Magento 2

Installation und Konfiguration

Dieses Dokument beschreibt, wie Sie das Modul AI Product Support in einem Magento-2-Shop in Betrieb nehmen und für die Nutzung vorbereiten.

Das Dokument richtet sich an Shops, die ein fertiges Modul implementieren und den AI-Chat nutzen möchten, ohne sich in technische Details der Funktionsweise auf Code-Ebene zu vertiefen.

Am besten betrachten Sie dieses Modul als Nutzungsebene. Zuerst bereitet der Shop das Wissen vor, und erst danach stellt er es Mitarbeitern oder Kunden in Form eines Chats bereit.

Was vor der Installation vorbereitet werden muss

Vor der Implementierung benötigen Sie:

• einen funktionierenden Magento-2-Shop,
• Zugriff auf den Server,
• composer,
• ein OpenAI-Konto,
• eine vorbereitete AI-Wissensdatenbank für den Shop,
• eine Internetverbindung des Servers.

Die wichtigste praktische Voraussetzung ist einfach: Das Modul wird nur dann gut antworten, wenn der Shop vorbereitete Inhalte hat, die AI nutzen kann.

Wenn der Shop bereits das Modul Kowal AI Product Feed verwendet, kann genau dieses Modul die Vorbereitung und Strukturierung der Inhalte für AI übernehmen. Auf der Seite dieses Moduls wurde dies als Aufbau einer strukturierten und aktuellen Wissensdatenbank für AI-Systeme beschrieben. AI Product Support ist der natürliche nächste Schritt, also die Nutzung dieses Wissens im Gespräch mit dem Nutzer. Quelle: Kowal AI Product Feed für OpenAI Vector Store

Installation des Moduls

Das Modul wird über composer installiert.

Beispielhafter Installationsprozess:

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

Wenn der Shop im Produktionsmodus läuft, führen Sie nach der Installation zusätzlich aus:

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

Wo sich die Konfiguration befindet

Nach der Installation finden Sie die Moduleinstellungen hier:

Stores > Configuration > Kowal AI > AI Product Support

So konfigurieren Sie das Modul

1. Chat im Adminbereich aktivieren

Aktivieren Sie im Abschnitt General:

• Enable Chat

Nach dem Speichern der Einstellung erscheint im Adminbereich der AI-Tab.

2. Entscheiden, ob der Chat im Frontend aktiviert werden soll

Wenn auch Shop-Kunden den Chat nutzen können sollen, aktivieren Sie:

• Enable Frontend Chat

Wenn das Modul nur dem Shop-Team dienen soll, lassen Sie das Frontend deaktiviert.

3. Länge der Frage festlegen

Das Feld:

• Maximum Question Length

legt die maximale Länge der Nachricht fest, die ein Nutzer senden kann. Das hilft, Ordnung zu halten und zu lange, schwer lesbare Anfragen zu begrenzen.

4. Standard-Store-View festlegen

Wenn der Shop in mehreren Sprachversionen läuft oder mehrere Store Views hat, können Sie angeben:

• Default Store View

Das erleichtert die Arbeit im Adminbereich und hilft, mit dem richtigen Kontext zu starten.

5. Manuelle Änderung des Store Views aktivieren oder deaktivieren

Das Feld:

• Allow Store Switcher

entscheidet, ob der Nutzer im Adminbereich den Store View direkt im Chat-Popup ändern kann.

Das ist nützlich, wenn ein Team mehrere Shop-Versionen betreut.

6. Technisches Logging für die Implementierungsphase aktivieren

Das Feld:

• Log Chat Requests

sollte in der Konfigurations- und Testphase aktiviert werden. Dadurch lässt sich leichter prüfen, ob das Modul korrekt funktioniert. Nach dem Produktivstart kann entschieden werden, ob das Logging aktiv bleiben soll.

Einstellungen der Verbindung mit AI

Konfigurieren Sie im Abschnitt OpenAI die grundlegenden Elemente, die für den Betrieb des Moduls erforderlich sind.

OpenAI API Key

Dies ist der Zugriffsschlüssel zum AI-Dienst. Ohne ihn ruft das Modul keine Modellliste ab, liest keine Wissensquelle aus und sendet keine Frage.

Response Model

Dies ist das Modell, das für die Erstellung der Antwort verantwortlich ist.

Die Modellliste wird aus der API geladen. Wenn nach dem Speichern des Schlüssels keine Optionen erscheinen, kann die Schaltfläche zum Aktualisieren der Modellliste verwendet werden.

Vector Store

Dies ist die ausgewählte Wissensquelle für das Modul.

Am einfachsten lässt sich das so verstehen:

• Es ist der Ort, an dem die Inhalte gespeichert sind, die der Chat beim Antworten nutzt,
• das Modul sucht genau dort nach Antworten,
• wenn Sie die falsche Quelle auswählen, werden die Antworten schwach oder unvollständig sein.

Wenn der Shop bereits über eine strukturierte, für AI vorbereitete Wissensdatenbank verfügt, wird hier genau diese Quelle angegeben.

Die Liste der Wissensquellen kann ebenfalls auf Konfigurationsebene aktualisiert werden.

Maximum File Search Results

Diese Einstellung legt fest, wie viele unterstützende Materialien das Modul bei der Vorbereitung einer einzelnen Antwort berücksichtigt.

In der Praxis beeinflusst dies:

• die Qualität der Antwort,
• die Geschwindigkeit,
• die Kosten der AI-Nutzung.

Eine gute Starteinstellung ist ein mittlerer Wert, zum Beispiel 6.

Frontend-Sicherheitsmaßnahmen

Wenn der Chat auf Shop-Seite aktiv ist, sollten Sicherheitslimits direkt eingerichtet werden.

Im Abschnitt Frontend Security finden Sie:

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

Diese Einstellungen helfen, Folgendes zu begrenzen:

• zu häufiges Senden von Fragen,
• Missbrauch durch Bots,
• unnötigen Ressourcenverbrauch und Kosten.

Zusätzlicher System-Prompt

Im Abschnitt Prompting kann ergänzt werden:

• System Prompt Template

Dieses Feld ist nicht verpflichtend. In den meisten Implementierungen kann es leer bleiben und die Standardeinstellung des Moduls verwendet werden.

Eine Überschreibung ist nur dann sinnvoll, wenn der Shop einen eigenen Antwortstil oder zusätzliche Kommunikationsregeln einführen möchte.

Wie das Modul aus Nutzersicht funktioniert

Im Adminbereich

Nach dem Start des Moduls sieht der Nutzer den AI-Tab am rechten Bildschirmrand. Nach dem Anklicken öffnet sich das Chat-Panel.

Im Panel können Sie:

• eine Frage eingeben,
• eine Antwort erhalten,
• Produktkarten sehen, wenn sich die Antwort auf ein konkretes Produkt bezieht,
• ohne Neuladen der Seite arbeiten.

Im Frontend

Wenn der Chat aktiviert wurde, erscheint ein ähnlicher Tab auf Shop-Seite. Der Kunde kann eine Frage stellen, ohne die Produktseite oder das Listing zu verlassen.

Wie eine solche Implementierung zu verstehen ist

Das praktischste Modell sieht so aus:

1. der Shop strukturiert Inhalte und bereitet eine Wissensdatenbank vor,
2. der Administrator gibt diese Wissensdatenbank in der Modulkonfiguration an,
3. der Nutzer verwendet den Chat,
4. Antworten werden auf Basis der vom Shop vorbereiteten Inhalte erstellt.

Dieser Ansatz liefert bessere Ergebnisse als das Starten eines Chats ohne vorbereitete Daten.

Empfohlene Startkonfiguration

Adminbereich

• Enable Chat = Yes
• Enable Frontend Chat = abhängig vom Projekt
• Maximum Question Length = 1000
• Allow Store Switcher = Yes bei mehreren Store Views
• Log Chat Requests = Yes in der Testphase
• Maximum File Search Results = 6

Frontend

• Requests Per Minute = vorsichtiger Startwert
• Requests Per Hour = an den Shop-Traffic angepasster Wert
• Minimum Submit Delay = mindestens 1

Was nach der Implementierung zu prüfen ist

Führen Sie nach dem Speichern der Konfiguration einen einfachen Test durch:

1. prüfen Sie, ob im Adminbereich der AI-Tab erschienen ist,
2. öffnen Sie das Popup und senden Sie eine Frage,
3. stellen Sie sicher, dass die Antwort korrekt angezeigt wird,
4. prüfen Sie, ob der Produktbereich bei Fragen zu konkreten Produkten erscheint,
5. wenn das Frontend aktiviert ist, prüfen Sie die Funktion des Tabs auch im Shop.

Häufigste Probleme

Modelle oder Wissensquellen sind nicht sichtbar

Meist bedeutet das:

• kein korrekter OpenAI-Schlüssel,
• keine Internetverbindung des Servers,
• Cache nach Änderungen nicht geleert.

Der Chat antwortet zu schwach oder trifft das Thema nicht

Die häufigste Ursache ist nicht das Modul selbst, sondern die Qualität der vorbereiteten Wissensdatenbank. Wenn die Inhalte unvollständig, veraltet oder zu dürftig sind, werden auch die Antworten schwächer sein.

Bevor das Modul selbst bewertet wird, lohnt es sich daher zu prüfen:

• ob die Produktbeschreibungen sinnvoll und vollständig sind,
• ob FAQ und Dokumentation aktuell sind,
• ob die Wissensdatenbank tatsächlich die Inhalte enthält, die Nutzer benötigen,
• ob die ausgewählte Wissensquelle für den jeweiligen Shop geeignet ist.

Das Frontend blockiert den Nutzer zu schnell

Dann sollten die Limit- und Versandverzögerungseinstellungen im Abschnitt Frontend Security geprüft werden.

Kurze Implementierungs-Checkliste

1. Installieren Sie das Modul über composer.
2. Aktivieren Sie das Modul und führen Sie setup:upgrade aus.
3. Konfigurieren Sie die Verbindung mit OpenAI.
4. Wählen Sie die richtige Wissensquelle aus.
5. Aktivieren Sie den Chat im Adminbereich.
6. Aktivieren Sie optional den Chat im Frontend.
7. Legen Sie Sicherheitslimits fest.
8. Testen Sie die Funktion mit Fragen zu realen Produkten und Shop-Inhalten.

Kurzbeschreibung für den Abschnitt „Installation und Konfiguration”

Das Modul wird über composer installiert und unter Stores > Configuration > Kowal AI > AI Product Support konfiguriert. Der Administrator gibt die Zugangsdaten zu OpenAI ein, wählt das Modell sowie die Wissensquelle für den Shop aus und aktiviert anschließend den Chat im Adminbereich und optional im Frontend. Zusätzlich können Sicherheitslimits festgelegt und grundlegende Betriebsparameter des Moduls angepasst werden.