CLI-Befehle

KI-Analyse und Reset per Kommandozeile steuern

sven:das-bild:ki-analyze

Der Haupt-Befehl. Startet die KI-Vision-Analyse und kann wahlweise alle aktiven Produkte, eine bestimmte Kategorie oder ein einzelnes Produkt verarbeiten.

bin/console sven:das-bild:ki-analyze [OPTIONS]

Ohne Parameter werden alle aktiven Produkte des Shops analysiert. Bereits analysierte Produkte (erkennbar an ki_generated_at) werden standardmäßig übersprungen — das Re-Run ist also idempotent.

Optionen im Detail

Option	Kurz	Beschreibung
`--product-id`	`-p`	Einzelprodukt-Analyse. Akzeptiert UUID oder Produktnummer.
`--category-id`	—	Nur Produkte dieser Kategorie (UUID).
`--category-name`	`-c`	Nur Produkte dieser Kategorie (Name, sucht in allen Sprachen).
`--include-children`	—	Unterkategorien einbeziehen (nur in Kombination mit `--category-*` sinnvoll).
`--dry-run`	—	Nur analysieren, nichts speichern — für Vorschau und Kosten-Schätzung.
`--force`	`-f`	Bereits analysierte Produkte erneut verarbeiten (überschreibt `ki_generated_at`-Check).
`--delay`	`-d`	Verzögerung zwischen API-Calls in Millisekunden. Standard `500`. Schützt vor Rate-Limits.

Typische Beispiele

Einzelnes Produkt analysieren (Vorschau)

bin/console sven:das-bild:ki-analyze -p SW10001 --dry-run

Zeigt das KI-Ergebnis im Terminal, schreibt aber nichts in die Datenbank. Perfekt zum Testen des Prompts nach Config-Änderungen.

Einzelnes Produkt speichern

bin/console sven:das-bild:ki-analyze -p SW10001

Alle Produkte einer Kategorie

bin/console sven:das-bild:ki-analyze -c "Möbel"

Kategorie inkl. Unterkategorien, mit 1-Sekunde-Pause

bin/console sven:das-bild:ki-analyze -c "Vintage" --include-children --delay 1000

Komplett-Re-Run mit Überschreiben

bin/console sven:das-bild:ki-analyze --force

Vorschau für den ganzen Shop (nur Request-Anzahl prüfen)

bin/console sven:das-bild:ki-analyze --dry-run

ⓘ

Was wird übersprungen?

Produkte ohne Cover-Bild (weder eigenes noch vom Parent)
Produkte mit gesetztem ki_generated_at — außer --force ist aktiv
Inaktive Produkte (Filter active = true)

Der Progress-Bar zeigt live an, was gerade passiert („Übersprungen (bereits analysiert): …“ etc.).

sven:das-bild:reset

Entfernt alle vom Plugin angelegten Property-Groups (Farben und alle KI-Textfelder wie Designer, Material, Stil …) inklusive aller Optionen und Produkt-Zuweisungen.

bin/console sven:das-bild:reset

Der Befehl fragt interaktiv nach einer Bestätigung und gibt am Ende die Anzahl der entfernten Property-Optionen aus.

⚠

Achtung: Der Reset entfernt auch Gruppen aus früheren Plugin-Versionen (z.B. „Bildfarben“) und abgemeldete Custom-Field-Keys, die per Konfiguration einmal aktiv waren. Die Custom Fields am Produkt (ki_beschreibung, ki_status, ki_generated_at, ki_result_json) bleiben erhalten.

Workflow bei Neukonfiguration

Wenn Sie eigene Felder definieren, Felder umbenennen oder den Anbieter wechseln, empfiehlt sich:

Einstellungen anpassen — Provider, Key, aktive Felder, eigene Felder, SEO-Schalter. Zur Konfiguration →

Test mit Dry-Run — Ein Produkt ohne Speicherung prüfen:

bin/console sven:das-bild:ki-analyze -p SW10001 --dry-run

Alte Property-Gruppen aufräumen (nur wenn Feld-Set sich geändert hat):
```
bin/console sven:das-bild:reset
```

Neue Analyse starten:

bin/console sven:das-bild:ki-analyze --force

Cache leeren — damit Storefront-Filter aktualisiert werden:
```
bin/console cache:clear
```

✓

Tipp: Bei großen Katalogen lohnt es sich, zuerst eine Pilot-Kategorie zu analysieren (-c "Pilot" --delay 1000), die Ergebnisse im Admin zu reviewen, und erst danach den Gesamt-Lauf zu starten.

← Farbpalette Weiter: FAQ →