Installations- und Konfigurationsanleitung

1. Anforderungen

Das Modul ist für Magento 2 und eine mit Composer verwaltete Installation vorgesehen.

Erforderlich sind:

• ein mit Composer verwaltetes Magento-2-Projekt,
• eine mit der verwendeten Magento-Installation kompatible PHP-Version,
• Zugriff auf Magento CLI,
• ein OpenAI API key,
• ein laufender Magento Message Queue Consumer.

Modulpaket:

kowal/module-ai-email-theme-generator

Name des Magento-Moduls:

Kowal_AiEmailThemeGenerator

2. Installation

Fügen Sie das Composer-Repository hinzu:

Die Zugangsdaten für das Composer-Repository, also die E-Mail-Adresse des Kunden und das Lizenz-Token, erhalten Sie nach dem Kauf per E-Mail. Sie sind nach der Anmeldung auf kowal.storeauch im Kundenkonto verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch das erhaltene Token. Führen Sie die Befehle im Magento-Stammverzeichnis aus.

composer config repositories.kowal composer https://repo.kowal.store

Konfigurieren Sie die Zugangsdaten für das Kowal Composer-Repository:

composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"

Installieren Sie das Modul:

composer require kowal/module-ai-email-theme-generator

Aktivieren Sie das Modul:

bin/magento module:enable Kowal_AiEmailThemeGenerator

Führen Sie das Magento-Update aus:

bin/magento setup:upgrade

Leeren Sie den Cache:

bin/magento cache:flush

Führen Sie im Produktionsmodus die im Projekt verwendeten standardmäßigen Deployment-Befehle aus, beispielsweise:

bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:flush

3. Queue Consumer

Die AI-Generierung wird asynchron über die Magento Message Queue verarbeitet.

Starten Sie den Consumer manuell:

bin/magento queue:consumers:start kowal.ai_email.generate.consumer

Konfigurieren Sie den Consumer in Produktionsumgebungen unter supervisor, systemd oder einem anderen vom Hosting verwendeten Prozessmanager.

Das Modul erstellt Aufgaben im Admin-Panel. Die Anfrage an die AI wird jedoch erst verarbeitet, wenn der Consumer läuft.

4. Administratorberechtigungen

Das Modul fügt folgende ACL-Ressourcen hinzu:

Kowal_AiEmailThemeGenerator::root
Kowal_AiEmailThemeGenerator::jobs
Kowal_AiEmailThemeGenerator::generate
Kowal_AiEmailThemeGenerator::retry
Kowal_AiEmailThemeGenerator::cancel
Kowal_AiEmailThemeGenerator::apply
Kowal_AiEmailThemeGenerator::delete
Kowal_AiEmailThemeGenerator::settings

Damit ein Administrator das Modul verwenden kann, weisen Sie die entsprechenden Ressourcen hier zu:

System > Permissions > User Roles

Gewähren Sie für vollständigen Zugriff die HauptressourceAI Email Generationsowie alle untergeordneten Ressourcen.

5. Speicherort der Konfiguration

Gehen Sie zu:

Stores > Configuration > AI Email Generation > AI Email Theme Generator

Der Konfigurationsbereich enthält die Gruppe:

General Settings

6. Konfigurationsfelder

Enabled

Typ: Yes/No

Standardwert: No

Aktiviert oder deaktiviert die Modulfunktionen.

Bei der EinstellungNokonfiguriert werden:

• sollte das Modul keine Aufgaben zur AI-Generierung erstellen,
• wird die Generierungsaktion blockiert,
• sollte der Administrator zunächst das Modul konfigurieren.

Legen SieYes, nachdem Sie den API key eingerichtet und den Queue Consumer gestartet haben.

API Provider

Typ: Select

Standardwert: OpenAI

Legt den vom Modul verwendeten AI-Anbieter fest.

Die aktuelle Implementierung unterstützt:

OpenAI

Das Feld ist vorhanden, damit künftig weitere Provider hinzugefügt werden können, ohne den Workflow des Administrators zu ändern.

OpenAI API Key

Typ: verborgenes/verschlüsseltes Feld

Speichert den für die Generierung verwendeten OpenAI API key.

Der Wert wird von Magento mit folgender Klasse verschlüsselt:

Magento\Config\Model\Config\Backend\Encrypted

Wichtig:

• Speichern Sie den API key nicht direkt im Code,
• committen Sie keine Umgebungsschlüssel,
• beschränken Sie den Zugriff auf dieses Feld über ACL,
• verwenden Sie einen Schlüssel mit den für das Projekt geeigneten Berechtigungen.

OpenAI Model

Typ: Select

Legt das für die Generierung verwendete OpenAI-Modell fest.

Beispiel:

gpt-4.1

Die Liste wird mithilfe des konfigurierten API key dynamisch über die OpenAI Models API abgerufen. Das Modul filtert die Antwort nach GPT-Modellkennungen und speichert die Liste kurzzeitig im Cache, damit die API nicht bei jedem Öffnen der Konfiguration aufgerufen wird.

Wenn der API key noch nicht gespeichert wurde, zeigt das Feld eine Ausweichoption an und fordert den Administrator zum Speichern des Schlüssels auf.

Wenn die OpenAI API vorübergehend nicht verfügbar ist, behält das Feld nach Möglichkeit das aktuell konfigurierte Modell bei.

Verwenden Sie ein Modell, das den benötigten Eingabetyp unterstützt:

• Textgenerierung für Prompts und Vorlageninhalte,
• ein bildfähiges Modell, wenn grafische Referenzdesigns verwendet werden.

Das ausgewählte Modell beeinflusst die Ergebnisqualität, Antwortzeit und Kosten.

Request Timeout

Typ: Number

Beispiel für den Standardwert:

120

Die maximal zulässige Zeit in Sekunden für eine Anfrage an die OpenAI API.

Empfohlene Werte:

• 60für eine kurze Textgenerierung,
• 120oder mehr für eine komplexe HTML/CSS-Generierung,
• höhere Werte nur, wenn die Infrastruktur längere Aufgaben in der Warteschlange zulässt.

Das Timeout gilt für die Hintergrundverarbeitung und nicht für die Anfrage des Administrationsformulars.

Maximum Retries

Typ: Number

Beispiel für den Standardwert:

2

Legt fest, wie oft der Consumer eine fehlgeschlagene Generierungsaufgabe automatisch wiederholen kann.

Wiederholungen sind bei vorübergehenden Fehlern hilfreich, beispielsweise:

• API-Timeout,
• vorübergehender Provider-Fehler,
• Rate Limit,
• Netzwerkproblem.

Dauerhafte Fehler, beispielsweise eine falsche Konfiguration oder eine ungültige AI-Antwort, sollten in den Aufgabendetails geprüft werden.

Technical Prompt

Typ: Textarea

Dieser Prompt wird bei jedem Generierungsauftrag verwendet. Er sollte technische Regeln enthalten, die immer eingehalten werden müssen.

Beispiel:

You are an assistant generating Magento 2 email templates.
Return only JSON that matches the provided schema.
Keep Magento directives valid.
Do not invent Magento variables.
Do not add JavaScript.
Put CSS in template_styles unless inline styles are required for email compatibility.
Preserve required variables and add warnings when a requested change is risky.
When assets are provided, use only the URLs from the assets section, preserve alt text, apply target links to clickable images, use banners and icons according to their sort_order, and do not invent additional image URLs.

Verwenden Sie dieses Feld für dauerhafte Anweisungen, beispielsweise:

• Beibehaltung von Magento-Direktiven,
• Beibehaltung erforderlicher Variablen,
• Vermeidung von JavaScript,
• ausschließliche Rückgabe von JSON,
• Erstellung von mit E-Mail-Clients kompatiblem HTML,
• Verwendung von CSS im richtigen Ergebnisfeld.

Verwenden Sie dieses Feld nicht für einmalige kreative Anweisungen. Dafür dientAI Promptim Vorlagenformular.

Default User Prompt

Typ: Textarea

Dieser Prompt wird standardmäßig im AI-Bereich des Editors für E-Mail-Vorlagen angezeigt.

Beispiel:

Improve this Magento email template while keeping all required Magento variables and directives valid.

Der Administrator kann ihn ändern, bevor eine Generierungsaufgabe erstellt wird.

Verwenden Sie dieses Feld, um eine praktische Standardanweisung für typische Generierungsaufgaben festzulegen.

Allowed Design File Types

Typ: Text

Beispiel für den Standardwert:

png,jpg,jpeg,webp,html,htm,txt

Eine durch Kommas getrennte Liste zulässiger Dateierweiterungen für das optionale Referenzdesign.

Unterstützte Beispiele:

• png
• jpg
• jpeg
• webp
• html
• htm
• txt

Verwenden Sie in der Produktion eine möglichst restriktive Liste. Lassen Sie keine Dateitypen zu, die für den Prozess nicht benötigt werden.

Maximum Design File Size

Typ: Number

Beispiel für den Standardwert:

5242880

Maximale Größe der Referenzdatei in Byte.

Beispiele:

• 1048576= 1 MB
• 5242880= 5 MB
• 10485760= 10 MB

Große Dateien erhöhen die Payload-Größe und können die Generierung verlangsamen oder die Limits des Providers überschreiten.

Automatically Apply Result

Typ: Yes/No

Standardwert: No

Legt fest, ob ein gültiges AI-Ergebnis die nativen Felder der Magento-Vorlage sofort überschreiben soll.

Bei der EinstellungYesspeichert der Consumer das generierte Ergebnis in:

• Template Name
• Template Subject
• Template Content
• Template Styles

Bei der EinstellungNowird das Ergebnis in der Aufgabe gespeichert und kann vom Administrator vor der manuellen Übernahme geprüft werden.

Empfohlene Produktionseinstellung:

No

Die manuelle Freigabe ist sicherer, da das AI-Ergebnis technisch korrekt sein kann, aber dennoch eine Prüfung hinsichtlich Marke, rechtlicher Anforderungen oder Layout erfordert.

Keep Request and Response Payloads

Typ: Yes/No

Standardwert: Yes

Legt fest, ob das Modul die vollständigen Request- und Response-Payloads im Aufgabendatensatz speichert.

Wenn die Option aktiviert ist, können die Aufgabendetails Folgendes anzeigen:

• den an die AI gesendeten Snapshot der Vorlage,
• verfügbare Variablen,
• Prompts,
• Metadaten des Referenzdesigns,
• die AI-Antwort.

Dies ist beim Debugging und bei Audits hilfreich.

Prüfen Sie in Produktionsumgebungen die Datenschutzanforderungen, bevor Sie diese Option aktivieren. Das Modul sollte keine realen Kundendaten an die AI senden, die Payloads können jedoch weiterhin geschäftlich sensible Vorlageninhalte enthalten.

Retention Days

Typ: Number

Beispiel für den Standardwert:

30

Legt fest, wie lange alte Aufgaben aufbewahrt werden sollen.

Dieser Wert dokumentiert die vorgesehene Aufbewahrungsrichtlinie. Das Projekt kann ihn verwenden, um eine regelmäßige Bereinigung gemäß den betrieblichen Anforderungen zu implementieren.

7. Beispiel: Generierung der Vorlage New Order Confirmation for Guest

Dieses Beispiel beschreibt den vollständigen Prozess zur Generierung einer verbesserten Magento-E-Mail-Vorlage für:

New Order Confirmation for Guest

Schritt 1: Modul konfigurieren

Gehen Sie zu:

Stores > Configuration > AI Email Generation > AI Email Theme Generator

Legen Sie fest:

Enabled = Yes
API Provider = OpenAI
OpenAI API Key = <your OpenAI API key>
OpenAI Model = gpt-4.1
Request Timeout = 120
Maximum Retries = 2
Automatically Apply Result = No
Keep Request and Response Payloads = Yes

Speichern Sie die Konfiguration und leeren Sie den Cache, falls Magento Sie dazu auffordert.

Schritt 2: Queue Consumer starten

Führen Sie Folgendes aus:

bin/magento queue:consumers:start kowal.ai_email.generate.consumer

Während der Tests sollte der Prozess kontinuierlich laufen.

Schritt 3: Native Magento-Vorlage erstellen

Gehen Sie zu:

Marketing > Communications > Email Templates

Klicken Sie auf:

Add New Template

Wählen Sie im FeldTemplate :

New Order Confirmation for Guest

Klicken Sie auf:

Load Template

Magento füllt die nativen Felder aus:

• Template Subject
• Template Content
• Template Styles

Legen Sie einen Vorlagennamen fest, beispielsweise:

New Order Confirmation for Guest - AI Draft

Speichern Sie die Vorlage.

Der AI-Generierungsprozess erfordert eine gespeicherte Vorlage, da die Aufgabe eine dauerhaftetemplate_id.

Schritt 4: AI Prompt ausfüllen

Öffnen Sie die Vorlage nach dem Speichern bei Bedarf erneut. Der standardmäßige Magento-Editor für E-Mail-Vorlagen enthält den BereichAI Email Generation.

Wählen Sie im FeldAI Prompt eine geschäftliche Anweisung ein, beispielsweise:

Create a modern, clean transactional email for a premium fashion store.
Keep all Magento order variables and directives valid.
Improve the subject line and make the content easier to scan.
Add a clear order summary section, shipping information section, and customer support footer.
Use neutral colors, simple spacing, and email-client-safe HTML.

Bedeutung dieses Feldes:

• beschreibt das erwartete Geschäftsergebnis,
• gilt nur für die jeweilige Generierungsaufgabe,
• kann Anweisungen zu Marke, Kommunikationston, Layout oder Inhalt enthalten,
• sollte weder API-Daten noch reale Kundendaten enthalten.

Schritt 5: Optional Design Reference hinzufügen

Verwenden SieDesign Reference, wenn die generierte E-Mail einer bestimmten visuellen Richtung folgen soll.

Beispieldateien:

• order-email-reference.png
• brand-email-layout.webp
• email-layout.html
• design-notes.txt

Bedeutung dieses Feldes:

• liefert der AI zusätzlichen visuellen oder strukturellen Kontext,
• hilft bei der Anpassung der Vorlage an ein Grafikdesign,
• ist optional,
• muss die Limits für Dateierweiterungen und Dateigröße erfüllen.

Wenn kein Referenzdesign hinzugefügt wird, verwendet die AI nur den Vorlageninhalt, die Variablen, den technischen Prompt und den Benutzer-Prompt.

Schritt 6: Optional Error Screenshot hinzufügen

Verwenden SieError Screenshot, wenn Sie der AI ein aktuelles Problem mit Rendering, Layout oder Vorlagenvalidierung zeigen möchten.

Beispiele:

• Screenshot eines falsch ausgerichteten Headers,
• Screenshot eines Bannerproblems,
• E-Mail-Vorschau mit fehlerhaften Abständen,
• Screenshot aus einem E-Mail-Client, der ein Problem mit der responsiven Darstellung zeigt,
• Screenshot einer Fehlermeldung aus einem Testtool.

Dieses Feld wird als separater JSON-Abschnitt an die AI übermittelt:

{
  "error_screenshot": {
    "type": "image",
    "filename": "email-rendering-error.png",
    "mime_type": "image/png",
    "content_base64": "...",
    "purpose": "current_error_context",
    "description": "Screenshot showing current rendering, layout, visual, or validation errors. Use it to understand what should be fixed. This is not a design reference."
  }
}

Bedeutung dieses Feldes:

• zeigt der AI den aktuellen Fehler, der behoben werden soll,
• ist kein Grafikdesign und keine Vorlage für das gewünschte Erscheinungsbild,
• hilft der AI zu verstehen, was derzeit nicht funktioniert,
• sollte zusammen mit einer klaren Problembeschreibung imAI Prompt.

Beispiel-Prompt:

Use the attached error screenshot only to understand the current rendering issue.
Fix the spacing problem visible in the screenshot while preserving Magento variables.
Do not treat the screenshot as the target design.

Schritt 7: Strukturierte AI Assets hinzufügen

Der Editor enthält den BereichAI Assets. Diese Ressourcen werden zusammen mit der Magento-Vorlage gespeichert und als gruppierte Frontend-Medien-URLs an die AI übermittelt.

Verfügbare Ressourcengruppen:

Jede Ressource kann Folgendes enthalten:

Klicken Sie für Banner und Symbole auf:

Add Banner
Add Icon

Das Modul speichert die hochgeladenen Ressourcen im Magento-Medienspeicher und übermittelt der AI öffentliche Frontend-URLs in folgender Struktur:

{
  "assets": {
    "logo": {
      "label": "Brand logo",
      "url": "https://example.com/media/ai_email_theme_generator/template_12/logo/logo.png",
      "alt": "Brand logo",
      "link": "https://example.com/",
      "sort_order": 0
    },
    "header_image": {
      "label": "Spring campaign header",
      "url": "https://example.com/media/ai_email_theme_generator/template_12/header/header.jpg",
      "alt": "Spring collection",
      "link": "https://example.com/spring",
      "sort_order": 0
    },
    "banners": [
      {
        "label": "Main promotion",
        "url": "https://example.com/media/ai_email_theme_generator/template_12/banner/banner.jpg",
        "alt": "20% off new collection",
        "link": "https://example.com/new",
        "sort_order": 10
      }
    ],
    "icons": [
      {
        "label": "Free delivery",
        "url": "https://example.com/media/ai_email_theme_generator/template_12/icon/delivery.png",
        "alt": "Free delivery",
        "link": "https://example.com/delivery",
        "sort_order": 10
      }
    ]
  }
}

Verweisen Sie in Prompts direkt auf diese Gruppen. Beispiel:

Use the uploaded logo as the main brand mark.
Use the header image at the top of the email.
Place banners below the order summary using their sort order.
Use icons in a benefits row and link each icon to its target URL.
Always preserve alt text.

Schritt 8: Generierung nach dem Speichern auswählen

Aktivieren Sie:

Generate with AI after saving

Bedeutung dieses Feldes:

• Magento speichert die Vorlage zunächst über die standardmäßige native Speicheraktion,
• nach erfolgreichem Speichern erstellt das Modul eine AI-Generierungsaufgabe,
• das hochgeladene Referenzdesign wird der Aufgabe hinzugefügt,
• die Aufgabe wird asynchron durch den Queue Consumer verarbeitet.

Wenn das Kontrollkästchen nicht aktiviert ist, funktioniert das Speichern der Vorlage genau wie das standardmäßige Speichern in Magento und es wird keine AI-Aufgabe erstellt.

Schritt 9: Vorlage speichern

Klicken Sie auf die standardmäßige Magento-Schaltfläche:

Save Template

Nach dem Speichern der Vorlage erstellt das Modul eine Generierungsaufgabe.

Zu diesem Zeitpunkt:

• ist das native Speichern der Vorlage abgeschlossen,
• beginnt der Aufgabenstatus mitpending,
• verarbeitet der Queue Consumer die Aufgabe im Hintergrund.

Schritt 10: Aufgabe prüfen

Gehen Sie zu:

Marketing > Communications > AI Email Generation Jobs

Öffnen Sie die erstellte Aufgabe.

Wichtigste Felder:

Typische Statuswerte:

Schritt 11: Ergebnis übernehmen

WennAutomatically Apply Result = Noeingestellt ist, wird das Ergebnis nicht automatisch in der Magento-Vorlage gespeichert.

Prüfen Sie:

• Template Name
• Template Subject
• Template Content
• Template Styles
• Warnings
• Request Payload
• Response Payload

Wenn das Ergebnis korrekt ist, klicken Sie auf:

Apply Result

Das Modul speichert die generierten Werte in den nativen Feldern der Magento-Vorlage.

Schritt 12: Native E-Mail-Vorlage prüfen

Kehren Sie zurück zu:

Marketing > Communications > Email Templates

Öffnen Sie die Vorlage und prüfen Sie, ob:

• Template Name aktualisiert wurde,
• Template Subject aktualisiert wurde,
• Template Content das erwartete HTML und die Magento-Direktiven enthält,
• Template Styles das erwartete CSS enthält,
• erforderliche Magento-Variablen nicht entfernt wurden.

Senden Sie eine Testnachricht oder führen Sie gemäß dem standardmäßigen QA-Prozess des Projekts einen Test-Bestellablauf durch.

Schritt 13: Weitere Korrektur an die AI senden

Nach der Übernahme des Ergebnisses überApply Resultwird die aktuelle Version der Vorlage in den nativen Magento-Feldern gespeichert. Dadurch basiert der nächste AI-Auftrag auf dieser Version und nicht auf der ursprünglichen Vorlage.

Sie können dieselbe Vorlage wiederholt optimieren:

1. Übernehmen Sie das AI-Ergebnis überApply Result.
2. Öffnen Sie die Vorlage erneut unterMarketing > Communications > Email Templates.
3. Geben Sie einen neuen Prompt ein, der eine konkrete Korrektur beschreibt.
4. Fügen Sie bei einem visuellen Problem einenError Screenshot.
5. Aktivieren SieGenerate with AI after saving.
6. Speichern Sie die Vorlage.
7. Prüfen Sie die neue Aufgabe und übernehmen Sie das Ergebnis, wenn es korrekt ist.

Behandeln Sie bei weiteren Korrekturen denAI Promptals Beschreibung der Änderung an der aktuellen Version. Geben Sie am besten Folgendes an:

• was derzeit fehlerhaft ist,
• welches Ergebnis erreicht werden soll,
• welche Elemente die AI nicht ändern darf,
• ob der beigefügteError Screenshoteinen Renderingfehler, das visuelle Layout, ein Problem mit der responsiven Darstellung oder eine Validierungsmeldung zeigt.

Beispiel-Prompt für eine weitere Korrektur:

Use the current saved template as the base.
Fix the spacing issue visible in the attached error screenshot.
Keep the current header layout, all Magento variables, and the existing Template Styles structure.
Do not redesign the whole email.

Dieser Workflow ist hilfreich, wenn die erste Version dem erwarteten Ergebnis bereits nahekommt, aber Details wie Abstände, responsive Darstellung, Sichtbarkeit von Bannern, Position des Logos oder Schaltflächenstile optimiert werden müssen.

Sie können diesen Zyklus beliebig oft wiederholen. Jede neue Aufgabe erstellt einen separaten Eintrag im Verlauf. Dadurch können Sie zu früheren Prompts, Payloads und AI-Antworten zurückkehren und prüfen, welche Anweisung zu einer bestimmten Änderung geführt hat.

8. Bedeutung der Felder im AI-Payload

Das Modul sendet einen strukturierten Payload an die AI. Die wichtigsten Abschnitte sind:

template

Enthält den aktuellen Zustand der Magento-Vorlage:

• Vorlagen-ID,
• Vorlagenname,
• subject,
• content,
• styles,
• ursprünglicher Vorlagencode.

Die AI verwendet diesen Abschnitt als Ausgangsmaterial für die Generierung.

Wichtig: Wenn zuvor ein AI-Ergebnis überApply Resultübernommen wurde, enthält der Abschnitttemplatebereits diese aktualisierte Version. Dadurch kann die nächste Generierung als Korrektur der aktuellen Vorlage ausgeführt werden.

variables

Enthält die in der Vorlage erkannten Magento-Variablen und -Direktiven.

Die AI sollte diese Werte beibehalten und keine nicht unterstützten Variablen erfinden.

prompts

Enthält:

• technical– den globalen technischen Prompt aus der Konfiguration,
• user– den im Vorlageneditor eingegebenen Prompt.

Der technische Prompt schützt die Magento-spezifische Struktur. Der Benutzer-Prompt beschreibt das erwartete Ergebnis für eine einzelne Vorlage.

design_reference

Enthält optionale Metadaten und den Inhalt des hochgeladenen Referenzdesigns.

Der Abschnitt ist leer, wenn keine Referenzdatei hochgeladen wurde.

error_screenshot

Enthält einen optionalen Screenshot, der aktuelle Rendering-, Layout-, Darstellungs- oder Validierungsfehler zeigt.

Dieser Abschnitt enthält die Beschreibungenpurposeunddescription, damit die AI weiß, dass die Datei zum Verständnis des Problems dient und keine Vorlage für das gewünschte Design ist.

Der Abschnitt ist leer, wenn kein Screenshot hochgeladen wurde.

Bei weiteren Korrekturen empfiehlt es sich,error_screenshotzusammen mit einem präzisen Prompt zu verwenden, der angibt, was korrigiert und was nicht geändert werden soll. Dadurch kann die AI ein konkretes Problem beheben, ohne die gesamte Vorlage neu zu gestalten.

Beispiel: Nach der Übernahme des ersten AI-Ergebnisses stellt der Administrator fest, dass das Banner in Gmail den Bereich mit der Bestellübersicht überlagert. Im nächsten Auftrag fügt er einen Screenshot dieser Ansicht hinzu und gibt einen Prompt ein, der ausschließlich die Korrektur der Abstände und der Bannerbreite verlangt. Der Payload enthält weiterhin den aktuellenTemplate ContentundTemplate Styles, sodass die AI mit der zuletzt gespeicherten Version arbeitet.

assets

Enthält die für die Vorlage gespeicherten strukturierten Grafikressourcen:

• Logo,
• Headergrafik,
• Banner,
• Symbole.

Jede Ressource enthält eine öffentliche Medien-URL, label, alt text, target URL, sort order und filename.

Die AI sollte diese URLs beim Erstellen des HTML-Codes verwenden und keine zusätzlichen Bildadressen erfinden.

store_context

Enthält grundlegende Informationen zum Shop, beispielsweise:

• store ID,
• locale,
• base URL.

Die AI kann diese Informationen verwenden, um Sprache und Kontext zu verstehen, sollte jedoch keine realen Kunden- oder Bestelldaten erhalten.

9. Fehlerbehebung

Die Aufgabe bleibt im Status pending

Wahrscheinlichste Ursache:

• Der Queue Consumer läuft nicht.

Prüfen Sie:

bin/magento queue:consumers:start kowal.ai_email.generate.consumer

Die Konfigurationsseite zeigt access denied an

Prüfen Sie die ACL-Berechtigungen für:

Kowal_AiEmailThemeGenerator::settings

Melden Sie sich nach einer Änderung der Administratorberechtigungen ab und erneut an.

Die Generierung schlägt wegen eines fehlenden API key fehl

Prüfen Sie:

OpenAI API Key

Stellen Sie sicher, dass das Modul aktiviert ist und die Konfiguration im richtigen Scope gespeichert wurde.

Das AI-Ergebnis hat den Status completed, die Vorlage wurde jedoch nicht aktualisiert

Prüfen Sie:

Automatically Apply Result

Wenn die Option aufNoeingestellt ist, öffnen Sie die Aufgabe und klicken Sie auf:

Apply Result

Die nächste Korrektur berücksichtigt das vorherige Ergebnis nicht

Prüfen Sie, ob das vorherige Ergebnis über folgende Aktion übernommen wurde:

Apply Result

Die nächste Generierung basiert auf der aktuell gespeicherten Magento-Vorlage. Wenn das Ergebnis der Aufgabe den Statuscompletedbesitzt, aber nicht übernommen wurde, basiert die nächste Aufgabe weiterhin auf der älteren Version der Vorlage.

Die AI-Antwort wurde abgelehnt

Das Modul validiert das zurückgegebene JSON. Es kann das Ergebnis ablehnen, wenn:

• erforderliche Felder fehlen,
• erforderliche Felder falsche Typen besitzen,
• Vorlagenname, subject oder content leer sind,
• content einscript,
• das Ergebnis kein gültiges JSON ist.

Prüfen Sie die Fehlermeldung in der Aufgabe und wiederholen Sie die Generierung mit einem klareren Prompt.

10. Empfohlene Produktionseinstellungen

Empfohlene Ausgangswerte:

Enabled = Yes
Request Timeout = 120
Maximum Retries = 2
Automatically Apply Result = No
Keep Request and Response Payloads = Yes for testing, No or limited retention for production
Retention Days = 30

Übernehmen Sie Ergebnisse manuell, bis das Team sicher ist, dass die Prompts, das ausgewählte Modell und die Validierungsregeln konsistente Vorlagen liefern.