AI-Konfiguration

(OpenAI)

Das Blog-Plugin bietet eine optionale Integration der OpenAI-API, um automatisch Titel, Beschreibungen und SEO-Metadaten für Blog-Artikel zu generieren.

⚠️ Hinweis:

Die Inhalte werden automatisiert durch eine externe KI-Funktion von OpenAI generiert und stammen nicht von unserem Blog Plugi.

Wir übernehmen keine Gewährleistung für Richtigkeit, Vollständigkeit, Rechtmäßigkeit oder Eignung der erzeugten Texte.

Bitte prüfen Sie die Ergebnisse sorgfältig, bevor Sie diese veröffentlichen.

Konfiguration

Feld	Beschreibung	Beispiel / Standard
OpenAI API Key	Ihr persönlicher API-Key von OpenAI. Ohne diesen ist die Funktion nicht nutzbar. Generieren Sie den Key unter: https://platform.openai.com/account/api-keys	(leer)
API Base	Die API-Basis-URL von OpenAI. Standard: api.openai.com/v1	api.openai.com/v1
Model (Modell)	Auswahl des zu verwendenden OpenAI-Modells. - GPT-4o mini: schnell, günstig - GPT-4o: präziser - GPT-4 Turbo: leistungsfähig	gpt-4o-mini
Tonality (Tonalität)	Schreibstil der Texte. - Informativ: neutral, sachlich - Werblich: verkaufsorientiert - Locker: umgangssprachlich - Seriös: formell - SEO-freundlich: für Suchmaschinen optimiert	informativ
Max. Zeichen (Titel)	Maximale Länge des Blog-Titels (name).	70
Max. Zeichen (Subtitle)	Maximale Länge des Untertitels (subtitle).	90
Max. Zeichen (ShortDescription)	Maximale Länge der Kurzbeschreibung (shortDescription).	160
Max. Zeichen (Description)	Maximale Länge der Hauptbeschreibung (description).	300
Max. Zeichen (MetaTitle)	Maximale Länge des SEO-Titels (metaTitle).	70
Max. Zeichen (MetaDescription)	Maximale Länge der SEO-Beschreibung (metaDescription).	160
Strict JSON (Structured Outputs)	Erzwingt, dass die KI strikt im JSON-Format nach dem definierten Schema antwortet (empfohlen). Kann bei älteren Modellen deaktiviert werden.	true
Feld-Erklärungen	Für jedes Feld (Titel, Subtitle, ShortDescription, Description, MetaTitle, MetaDescription) kann eine eigene Prompt-Erklärung gepflegt werden. Diese wird in den KI-Prompt eingebunden, sodass der Schreibstil anpassbar ist.

Empfehlung

• Verwenden Sie gpt-4o-mini für schnelle und kostengünstige Ergebnisse.

• Aktivieren Sie Strict JSON, um saubere, maschinenlesbare Antworten zu erhalten.

• Passen Sie die Feld-Erklärungen in der Plugin-Config an, wenn Sie den Schreibstil für bestimmte Felder beeinflussen möchten.

• Prüfen Sie die generierten Texte vor Veröffentlichung stets sorgfältig.

---

Einrichtung der KI-Funktion (OpenAI)

Bevor Sie die KI-Funktion nutzen können, müssen Sie die Plugin-Konfiguration vollständig ausfüllen.

Da Shopware die Default-Werte nicht automatisch speichert, müssen alle Felder manuell eingetragen werden.

⚠️ Wichtiger Hinweis

Die generierten Inhalte stammen von einer externen KI-Funktion (OpenAI) und nicht von unserem Blog Plugin.

Wir übernehmen keine Gewährleistung für Verfügbarkeit, Richtigkeit oder Eignung der erzeugten Texte.

Bitte prüfen Sie die Ergebnisse sorgfältig, bevor Sie diese veröffentlichen.

---

Checkliste: Pflicht-Einstellungen

• OpenAI API Key

  Generieren unter: https://platform.openai.com/account/api-keys

  Ohne Key funktioniert die KI nicht.

• API Base

  Standardwert: https://api.openai.com/v1 (ohne https://)

• Model (Modell)

  Auswahlmöglichkeiten:

  • gpt-4o-mini → schnell, günstig ✅ Empfohlen

  • gpt-4o → präziser

  • gpt-4-turbo → leistungsfähig

• Tonality (Tonalität)

  Schreibstil-Auswahl:

  • informativ → neutral, sachlich ✅ Empfohlen

  • werblich → verkaufsorientiert

  • locker → umgangssprachlich

  • seriös → formell

  • seo → SEO-freundlich

• Zeichenlimits

  Empfohlene Standardwerte:

Feld	Wert (Zeichen)	Erklärung
Titel (maxLen)	70	Titel/Name: prägnant und thematisch passend
Subtitle (maxSubLen)	90	Subtitle: ergänzend, informativ
ShortDescription (shortDescMax)	160	ShortDescription: kurzes Teaser-Snippet
Description (descMax)	300	Description: prägnanter Teaser-/Meta-Text
MetaTitle (maxMetaTitleLen)	70	MetaTitle: SEO-orientiert, natürlich klingend
MetaDescription (metaDescMax)	160	MetaDescription: SEO-orientiert, natürlich klingend

• Strict JSON (Structured Outputs)

  Empfohlener Wert: true / Aktiviert Erzwingt saubere JSON-Ausgaben nach Schema. Falls Probleme auftreten: false.

• Feld-Erklärungen (Prompt Guidance)

  Standardwerte, die im Prompt an die KI übergeben werden:

  • Titel → „Titel/Name: prägnant und thematisch passend.“

  • Subtitle → „Subtitle: ergänzend, informativ.“

  • ShortDescription → „ShortDescription: kurzes Teaser-Snippet.“

  • Description → „Description: prägnanter Teaser-/Meta-Text.“

  • MetaTitle → „MetaTitle: SEO-orientiert, natürlich klingend.“

  • MetaDescription → „MetaDescription: SEO-orientiert, natürlich klingend.“

✅ Sobald alle Punkte dieser Liste ausgefüllt sind, ist die KI-Funktion einsatzbereit.