# 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: | (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: Ohne Key funktioniert die KI nicht. * API Base Standardwert: (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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.pixeleyes.de/anleitungen-instructions/deutsch/dokumentation-unserer-shopware-6-plugins/blog-fur-shopware-6/ai-konfiguration.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.