KI-Bildanalyse

Strukturierte Produktdaten direkt aus dem Cover-Bild

Workflow

1. Bild laden & skalieren — Das Cover-Bild des Produkts wird geladen. Ist die längste Kante > 1024 px, skaliert das Plugin per GD auf max. 1024 px (JPEG, Qualität 85). Das spart Token und Zeit bei der API.
2. Produktkontext sammeln — Produktname, Produktnummer und ggf. der Shopware-Hersteller werden aus der DB gelesen. Bei Varianten wird auf das Hauptprodukt zurückgefallen.
3. Prompt aufbauen — Ein systemseitiger Prompt beschreibt die aktiven Felder, Multi-Value-Regeln, die Farbpalette und die Beschreibungslänge.
4. API-Call — Das Bild (base64) und der Prompt gehen an Anthropic oder OpenAI. Timeout 60 s, max. 2048 Output-Tokens.
5. Antwort parsen — Das zurückkommende JSON wird validiert, Farben werden auf die feste 21er-Palette normalisiert, Multi-Value-Felder in saubere Arrays zerlegt.
6. Speichern — Jedes Feld wird als Property oder Custom Field abgelegt, Meta-Titel und Meta-Beschreibung optional direkt ins Produkt geschrieben.

Anbieter & Modelle

DasBild unterstützt zwei KI-Vision-Anbieter. Der Provider wird in der Plugin-Konfiguration gewählt; der API-Key liegt als Passwort-Feld vor und wird nicht im Admin ausgegeben.

Neben Provider und Key bietet der Konfigurationsbereich zwei Convenience-Komponenten:

• API Key erstellen — Direktlinks zu den Konsolen-Seiten beider Anbieter.
• API Key testen — Sendet einen minimalen Probe-Request (max_tokens: 5) und gibt sprechende Fehlermeldungen aus (ungültiger Key, kein Guthaben, Modell nicht gefunden …).

Standard-Felder

Ohne eigene Konfiguration liefert die KI folgende 12 Felder. Alle lassen sich einzeln über Aktive KI-Felder ein- und ausschalten:

Jedes KI-Ergebnis enthält pro Feld zusätzlich ein confidence-Flag mit den Werten sicher oder unsicher — bei manueller Bearbeitung im Admin wird es auf manuell gesetzt.

Eigene KI-Felder

Die Standard-Felder sind für Design- und Vintage-Shops gedacht. Für andere Branchen (Fashion, Lebensmittel, Technik, Spielzeug…) können Sie eigene Felder definieren — eine Zeile pro Feld, Pipe-getrennt:

field_key | DE Label | EN Label | multi (ja/nein) | Prompt-Hinweis

Beispiel Fashion-Shop:

marke    | Marke   | Brand    | nein | Markenname, z.B. "Nike", "Adidas"
material | Material | Material | ja   | Materialien als Array
anlass   | Anlass  | Occasion | ja   | Anlässe, z.B. ["Business","Freizeit"]
schnitt  | Schnitt | Cut      | nein | Passform, z.B. "slim", "regular", "oversized"

Produktbeschreibung

Wenn das Feld beschreibung aktiv ist, generiert die KI einen verkaufsorientierten Produkttext. Die Länge steuert die Konfigurationsoption Beschreibungslänge:

Der Prompt weist die KI explizit an, das Produkt zu beschreiben, nicht das Bild — „Das Bild zeigt …“, „Zu sehen ist …“ o.ä. werden vermieden. Die Beschreibung landet im Custom Field ki_beschreibung.

SEO: Meta-Titel & Meta-Beschreibung

Zwei Schalter in der Plugin-Konfiguration steuern das SEO-Verhalten:

Produktkontext – warum die KI auch Text bekommt

Viele Hersteller haben kein sichtbares Logo auf dem Produkt (z.B. „Grundig Audiorama 9000“). Damit die KI den Hersteller trotzdem erkennt, bekommt sie zusätzlich zum Bild drei Zusatz-Informationen:

• Produktname — aus Shopware (Übersetzung bevorzugt)
• Produktnummer — aus Shopware
• Shopware-Hersteller — aus der Manufacturer-Zuordnung

Wo wird was gespeichert

Admin-Oberfläche

DasBild integriert sich an zwei Stellen in der Shopware-Administration:

• Kataloge → Farberkennung — Übersichtsseite mit Einzel- und Batch-Analyse, Modell-Info und Statusanzeige.
• Produktdetailseite — Zusätzlicher „KI-Button“ (sven-das-bild-ki-button), der eine Vorschau oder direkte Analyse des aktuellen Produkts auslöst. Die API-Endpunkte:
  • POST /api/_action/sven-das-bild/ki-preview — Vorschau, speichert nichts
  • POST /api/_action/sven-das-bild/ki-analyze-product — Vollanalyse mit Speicherung
  • POST /api/_action/sven-das-bild/ki-update-fields — Einzelne Felder selektiv übernehmen / überschreiben
  • POST /api/_action/sven-das-bild/ki-update-status — Status auf approved / rejected setzen
  • GET|POST /api/_action/sven-das-bild/ki-fields — aktuelle Feld-Definition inkl. Farbpalette für das Frontend
  • POST /api/sven-das-bild/test-api-key — API-Key & Modell testen

Review-Workflow

Die KI-Analyse ist auf review-freundlich ausgelegt:

1. Batch-Lauf per CLI schreibt alle Felder und setzt ki_status = pending.
2. Redakteur:in sichtet im Admin Produkt für Produkt die Vorschläge, passt einzelne Felder an (ki-update-fields) und markiert als approved oder rejected.
3. Manuelle Änderungen werden in ki_result_json mit confidence: "manuell" markiert und bleiben bei einer erneuten KI-Analyse erhalten, solange man nicht bewusst mit --force überschreibt.
4. Storefront nutzt die Properties wie jede andere — sofort filterbar, ohne Theme-Änderungen.