AI Product Support für Magento 2

Installation und Konfiguration

Dieses Dokument beschreibt, wie das ModulAI Product Supportin einem Magento 2-Shop gestartet und für den Einsatz vorbereitet wird.

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, erst danach wird es Mitarbeitern oder Kunden in Form eines Chats bereitgestellt.

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 liefert nur dann gute Antworten, wenn der Shop Inhalte vorbereitet hat, auf die die AI zugreifen kann.

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

Installation des Moduls

Das Modul wird übercomposer.

Beispielhafter Installationsprozess:

composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
composer require kowal/module-ai-product-support
bin/magento module:enable Kowal_AiProductSupport
bin/magento setup:upgrade
bin/magento cache:clean

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

bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/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 Admin-Panel aktivieren

Stellen Sie im AbschnittGeneral:

• Enable Chat

Nach dem Speichern der Einstellung erscheint im Admin-Panel der Tab AI.

2. Entscheiden Sie, 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 Benutzer senden kann. Das hilft, die Übersicht zu bewahren und zu lange, unleserliche Anfragen zu begrenzen.

4. Standard-Shop-Ansicht festlegen

Wenn der Shop in mehreren Sprachversionen betrieben wird oder mehrere Shop-Ansichten hat, können Sie Folgendes angeben:

• Default Store View

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

5. Manuelles Wechseln der Shop-Ansicht aktivieren oder deaktivieren

Das Feld:

• Allow Store Switcher

entscheidet, ob der Benutzer des Panels die Shop-Ansicht direkt im Chat-Popup ändern kann.

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

6. Technisches Logging für die Dauer der Implementierung 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 AI-Verbindung

Stellen Sie im AbschnittOpenAIdie grundlegenden Elemente, die für den Betrieb des Moduls erforderlich sind.

OpenAI API Key

Dies ist der Zugriffsschlüssel für den 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 Antworten 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, fallen die Antworten schwach oder unvollständig aus.

Wenn der Shop bereits über eine strukturierte Wissensdatenbank verfügt, die für AI vorbereitet wurde, wird genau diese Quelle hier ausgewählt.

Die Liste der Wissensquellen kann ebenfalls über die Konfiguration 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 wirkt sich das aus auf:

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

Ein guter Startwert ist ein mittlerer Wert, zum Beispiel6.

Frontend-Sicherheit

Wenn der Chat auf Shop-Seite aktiv ist, sollten Sie direkt Sicherheitslimits festlegen.

Stellen Sie im AbschnittFrontend Securityfinden 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 unnötige Kosten.

Zusätzlicher System-Prompt

Stellen Sie im AbschnittPromptingkann Folgendes ergänzt werden:

• System Prompt Template

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

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

Wie das Modul aus Benutzersicht funktioniert

Im Admin-Panel

Nach dem Start des Moduls sieht der Benutzer am rechten Bildschirmrand den Tab AI. 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 bestimmtes Produkt bezieht,
• arbeiten, ohne die Seite neu zu laden.

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 man eine solche Implementierung betrachten sollte

Das praktischste Modell sieht so aus:

1. Der Shop strukturiert die Inhalte und bereitet die Wissensdatenbank vor,
2. der Administrator wählt diese Wissensdatenbank in der Modulkonfiguration aus,
3. der Benutzer verwendet den Chat,
4. die Antworten werden auf Basis der vom Shop vorbereiteten Inhalte erstellt.

Dieser Ansatz liefert ein besseres Ergebnis als das Starten des Chats ohne vorbereitete Daten.

Empfohlene Startkonfiguration

Admin-Panel

• Enable Chat=Yes
• Enable Frontend Chat= je nach Projekt
• Maximum Question Length=1000
• Allow Store Switcher=Yesbei mehreren Shop-Ansichten
• Log Chat Requests=Yesin 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= mindestens1

Was nach der Implementierung geprüft werden sollte

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

1. Prüfen Sie, ob im Admin-Panel der Tab AI 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äufige Probleme

Modelle oder Wissensquellen sind nicht sichtbar

Meist bedeutet das:

• kein korrekter OpenAI-Schlüssel,
• keine Internetverbindung des Servers,
• Cache wurde 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 knapp sind, fallen auch die Antworten schwächer aus.

Bevor Sie das Modul selbst bewerten, sollten Sie daher 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 Benutzer benötigen,
• ob die ausgewählte Wissensquelle für den jeweiligen Shop geeignet ist.

Das Frontend blockiert den Benutzer zu schnell

Dann sollten die Einstellungen für Limits und Sendeverzögerung im AbschnittFrontend Security.

Kurze Implementierungs-Checkliste

1. Installieren Sie das Modul übercomposer.
2. Aktivieren Sie das Modul und führen Siesetup:upgrade.
3. Konfigurieren Sie die Verbindung mit OpenAI.
4. Wählen Sie die richtige Wissensquelle aus.
5. Aktivieren Sie den Chat im Admin-Bereich.
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.

Kurze Beschreibung für den Abschnitt „Installation und Konfiguration“

Das Modul wird übercomposerinstalliert und unterStores > Configuration > Kowal AI > AI Product Supportkonfiguriert. 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 Admin-Panel und optional im Frontend. Zusätzlich können Sicherheitslimits festgelegt und grundlegende Betriebsparameter des Moduls angepasst werden.