AI Personal ShopperDocs

AI Personal Shopper Dokumentation

Installationsschritte und eine vollständige Referenz zu jeder Einstellung, mit konkreten Beispielen — einschließlich der genauen Schritte, um bei jedem KI-Anbieter einen API-Schlüssel zu erhalten.

Als Markdown anzeigen

Installation

Voraussetzungen

Magento 2.4.x — getestet auf 2.4.9, kompatibel mit früheren 2.4.*-Versionen. PHP 8.1–8.5. Kompatibel sowohl mit dem Standard-Theme Luma als auch mit dem Theme Hyvä (das Chat-Widget wird in einem isolierten Shadow DOM gerendert, sieht also auf beiden identisch aus, ohne Template-Änderungen). Benötigt das kostenlose Modul codingrow/module-core, das automatisch installiert wird. Erfordert einen API-Schlüssel von mindestens einem KI-Anbieter (OpenAI, Anthropic, Google oder OpenRouter) — direkt vom Anbieter an Sie abgerechnet.

Installationsschritte

  1. Fügen Sie die Zugangsdaten, die Sie per E-Mail erhalten, in auth.json im Stammverzeichnis Ihres Magento-Projekts ein: 
    { "http-basic": { "repo.codingrow.com": { "username": "...", "password": "..." } } }
  2. composer config repositories.codingrow composer https://repo.codingrow.com
  3. composer require codingrow/module-ai-personal-shopper
  4. bin/magento module:enable Codingrow_AiPersonalShopper
  5. bin/magento setup:upgrade && bin/magento setup:di:compile
  6. Fügen Sie Ihren Lizenzschlüssel unter Admin → Stores → Configuration → Codingrow → AI Personal Shopper → License → License Key ein, speichern Sie, und führen Sie dann bin/magento cache:flush aus.

Konfiguration

Öffnen Sie Admin → Stores → Configuration → Codingrow → AI Personal Shopper. Geben Sie Ihren License Key ein, setzen Sie Enable auf Yes, wählen Sie Ihren AI Provider und fügen Sie dessen API-Schlüssel ein, und prüfen Sie dann die Capabilities.

EinstellungFunktionStandardHinweise
License KeyDer für diese Domain ausgestellte Lizenzschlüssel.—Akzeptiert einen Einzelmodul-Schlüssel oder einen Codingrow-Abo-Schlüssel. Ohne gültige Lizenz wird der Chat nicht gerendert.
EnableAktiviert das Chat-Widget im Storefront.NoErfordert eine gültige Lizenz und mindestens einen API-Schlüssel eines KI-Anbieters.
AI ProviderAnbieter, Modell und API-Schlüssel für die Unterhaltung.—Nutzen Sie Load models neben dem Feld Model, statt eine id einzutippen.
CapabilitiesSchalter: Produktsuche, Bestellstatus, Aktionen, In den Warenkorb, Spracheingabe, selbstlernende Synonyme, Tickets für menschlichen Support.—Deaktivieren Sie alles, was der Agent nicht tun soll.
Human supportSupport-E-Mail (BCC), Antwortzeit, Ticket-Präfix, automatische Schließung, Benachrichtigung bei Lösung.24-48 hoursWird nur genutzt, wenn die Capability Human support tickets aktiv ist.

Deinstallation

Setzen Sie Enable auf No und speichern Sie, um das Widget sofort auszublenden. Um das Modul vollständig zu entfernen: bin/magento module:disable Codingrow_AiPersonalShopper, dann composer remove codingrow/module-ai-personal-shopper.

Einrichtung des KI-Anbieters

Einen Anbieter wählen

Der Assistent funktioniert mit jedem der vier Anbieter — Sie bringen Ihren eigenen API-Schlüssel mit, und die KI-Nutzung wird Ihnen direkt vom gewählten Anbieter in Rechnung gestellt. OpenAI (ChatGPT/GPT) bietet die breiteste Palette; Anthropic (Claude) eignet sich gut für einen Assistenten, der sich strikt an Vorgaben halten muss; Google (Gemini) ist preislich wettbewerbsfähig und schnell; OpenRouter gibt Ihnen einen einzigen Schlüssel für Dutzende Modelle verschiedener Anbieter, praktisch zum Vergleichen von Kosten und Qualität.

Einen OpenAI-API-Schlüssel erhalten

  1. Melden Sie sich bei platform.openai.com an.
  2. Gehen Sie zu platform.openai.com/api-keys.
  3. Klicken Sie auf Create new secret key, vergeben Sie einen Namen (z. B. „AI Personal Shopper“) und kopieren Sie ihn sofort — er wird nur einmal angezeigt.
  4. Fügen Sie ihn unter AI Provider → API Key ein, wobei Provider auf OpenAI gesetzt ist, und nutzen Sie dann Load models.

Einen Anthropic-API-Schlüssel erhalten

  1. Melden Sie sich bei console.anthropic.com an.
  2. Gehen Sie zu console.anthropic.com/settings/keys.
  3. Klicken Sie auf Create Key, vergeben Sie einen Namen und kopieren Sie den Wert.
  4. Fügen Sie ihn unter AI Provider → API Key ein, wobei Provider auf Anthropic gesetzt ist, und nutzen Sie dann Load models.

Einen Google-API-Schlüssel erhalten

  1. Melden Sie sich bei aistudio.google.com mit einem Google-Konto an.
  2. Gehen Sie zu aistudio.google.com/app/apikey.
  3. Klicken Sie auf Create API key, wählen oder erstellen Sie ein Google-Cloud-Projekt und kopieren Sie den Schlüssel.
  4. Fügen Sie ihn unter AI Provider → API Key ein, wobei Provider auf Google gesetzt ist, und nutzen Sie dann Load models.

Einen OpenRouter-API-Schlüssel erhalten

  1. Melden Sie sich bei openrouter.ai an.
  2. Gehen Sie zu openrouter.ai/keys.
  3. Klicken Sie auf Create Key, vergeben Sie einen Namen und kopieren Sie den Wert.
  4. Fügen Sie ihn unter AI Provider → API Key ein, wobei Provider auf OpenRouter gesetzt ist, und nutzen Sie dann Load models.

Load models

Sobald der API-Schlüssel eingetragen ist, klicken Sie unter dem Feld Model auf Load models: Das Modul ruft mit Ihrem Schlüssel den eigenen Modell-Listen-Endpunkt des Anbieters ab und füllt ein Dropdown mit allen Modellen, die Ihr Schlüssel tatsächlich nutzen kann — wählen Sie aus der Liste, statt eine id einzutippen. Als Fallback bleibt ein manuelles Textfeld für eine id verfügbar, die noch nicht in der Liste ist. Ein Link direkt unter dem Feld führt immer zur richtigen Seite, um den Schlüssel des aktuell gewählten Anbieters zu erhalten.

Benutzerhandbuch

Capabilities

Jede Capability ist ein eigenständiger Schalter unter AI Provider & Capabilities: Produktsuche, Abfrage des Bestellstatus, Aktionen, In den Warenkorb, Spracheingabe, selbstlernende Synonyme, Tickets für menschlichen Support. Das Deaktivieren einer Capability nimmt dem Agenten diese Fähigkeit sofort — deaktivieren Sie z. B. Human support tickets, wird der Agent nie vorschlagen, ein Ticket zu eröffnen.

Branding und Farben

Legen Sie einen Assistant name fest (wird als Name der Ansprechperson angezeigt, z. B. „Anna“) und optional ein Brand logo (feste Höhe, damit es nie verzerrt wird) oder einen Brand text mit Ihrem Firmennamen — beide werden oben links im Chat-Header angezeigt. Der Name der Ansprechperson bleibt als Unterzeile mit einem Live-Präsenzpunkt unter der Marke sichtbar, auch wenn ein Logo gesetzt ist. Accent color steuert den Öffnen-Button und die Akzente im Chat; Header/theme color (optional) färbt die Header-Leiste und die Nachrichtenblasen des Kunden — leer lassen, um die Accent color wiederzuverwenden.

Selbstlernende Synonyme

Ist sie aktiviert (Capabilities → Self-learning synonyms), speichert der Agent eine Zuordnung, sobald das Suchwort eines Kunden nicht direkt zum Katalog passt, ein späterer Versuch aber schon — regionale Bezeichnungen, Dialekt, Tippfehler, Synonyme. Prüfen und bearbeiten Sie das Register unter Codingrow → AI Personal Shopper → Synonyms: eine paginierte, inline bearbeitbare Tabelle. Nutzen Sie Export CSV / Import CSV, um es zu sichern, in großen Mengen zu bearbeiten oder zwischen Umgebungen zu verschieben. Der Button Inject into site search überträgt das gesamte Register in die nativen Search Synonyms von Magento, sodass auch die Suchleiste der Website davon profitiert — nicht nur der Chat. Der Agent liest zudem Ihre manuell gepflegten nativen Search Synonyms, sodass sich beide Systeme gegenseitig verstärken.

Tipp: Die meisten verlorenen Umsätze entstehen durch ein falsches Suchwort, nicht durch ein fehlendes Produkt — das Register wird mit jeder Unterhaltung besser.

Tickets für menschlichen Support

Ist sie aktiviert (Capabilities → Human support tickets), schlägt der Agent vor, ein Ticket zu eröffnen, wenn ein Kunde einen Menschen braucht und die Unterhaltung allein das Problem nicht löst. Er fragt nach der E-Mail (Pflichtfeld) und, falls hilfreich, nach der Bestellnummer und einem Telefon-/WhatsApp-Kontakt, vergibt dann eine Ticketnummer und sendet dem Kunden die vollständige Transkription per E-Mail, mit BCC an die unter Human support → Support email (BCC) hinterlegte Adresse (bleibt diese leer, geht die E-Mail nur an den Kunden). Der dem Kunden angezeigte Antwortzeit-Text stammt aus Human support → Response time. Tickets erscheinen im Tab Tickets & Support: eine Tabelle mit View, die Kontaktdaten und vollständige Transkription öffnet, einer Aktion zum Als-gelöst-Markieren (mit optionaler Benachrichtigungs-E-Mail) und automatischer Schließung nach der konfigurierten Anzahl an Tagen. Der Agent klassifiziert außerdem Unterhaltungen, die ein Website-Problem melden, als Bug report, sodass Probleme Ihr Team erreichen, ohne dass ein Support-Ticket nötig ist.

EinstellungFunktionStandard
Support email (BCC)Adresse, die eine BCC-Kopie jeder Ticket-Transkriptions-E-Mail erhält.— (nur Kunde, wenn leer)
Response timeText, der dem Kunden bei Eröffnung eines Tickets angezeigt wird.24-48 hours
Ticket number prefixPräfix bei der Vergabe von Ticketnummern.—
Auto-close after (days)Tickets ohne Aktivität werden nach dieser Anzahl an Tagen automatisch geschlossen.—
Notify customer on resolveSendet dem Kunden eine E-Mail, wenn ein Ticket im Admin als gelöst markiert wird.Off

Unterhaltungen lesen

Codingrow → AI Personal Shopper → Conversations listet jede Unterhaltung, automatisch klassifiziert als Shopping, Support, Bug report, Possible spam oder Other, paginiert und nach Typ filterbar. Die Aktion View öffnet den vollständigen Thread — jede Nachricht von Kunde und Assistent, einschließlich der in jeder Runde vorgeschlagenen Produktkarten — schreibgeschützt. Unterhaltungen können einzeln oder in Massen gelöscht werden; ältere Unterhaltungen jenseits der konfigurierten Aufbewahrungsdauer werden durch eine tägliche Aufgabe entfernt (Bug-Reports sind von der automatischen Bereinigung ausgenommen).

Lizenz

Die Lizenz wird für eine Domain ausgestellt und kann ein Einzelmodul-Schlüssel (AI Personal Shopper) oder ein Codingrow-Abo-Schlüssel (alle Module) sein. Ohne gültige Lizenz wird das Chat-Widget nicht gerendert. Updates sind innerhalb derselben Hauptversion enthalten.