Topdata Topdata Docs

TopdataEnhancedSearchSW6

Topdata Enhanced Search SW6 Benutzerhandbuch

Überblick

Topdata Enhanced Search SW6 ersetzt die einfache Suchergebnisliste im Storefront durch ein Such-Overlay, das schon wĂ€hrend der Eingabe antwortet. Das Overlay gruppiert die Treffer in Produkte, Kategorien, Hersteller, Verbrauchsmaterial-GerĂ€te und kuratierte SuchvorschlĂ€ge und zeigt zu jedem Vorschlag, wie viele Produkte er finden wĂŒrde.

DarĂŒber hinaus liefert das Plugin die Werkzeuge, die fĂŒr eine hohe SuchqualitĂ€t nötig sind: Es protokolliert, wonach Ihre Kunden tatsĂ€chlich suchen, gewinnt wiederkehrende Phrasen aus Ihren Produkttiteln, schlĂ€gt Synonyme fĂŒr Begriffe ohne Treffer vor und lĂ€sst Sie diese VorschlĂ€ge im Administration genehmigen oder verwerfen.

Hauptmerkmale

  • Such-Overlay mit konfigurierbaren Bereichen: Produkte, Kategorien, Hersteller, Verbrauchsmaterial-GerĂ€te, SuchvorschlĂ€ge und letzte Suchanfragen
  • SuchvorschlĂ€ge aus Produkttiteln — Phrasen, die mehrere Produkte teilen, werden zu VorschlĂ€gen und erhalten eine zwischengespeicherte Produktanzahl
  • Synonyme mit Boost-Stufe je Regel, pflegbar im Administration oder per Text-/CSV-Import und -Export
  • Synonym-VorschlĂ€ge aus Ihrer eigenen Suchanalyse: titel-geminte Phrasen, PrĂ€fix-Familien von Hersteller-Artikelnummern (z. B. TN 247 → TN-247), eine LLM-Strategie und eine Thesaurus-Strategie
  • Optionale KI-Bewertung (Jev), die VorschlĂ€ge vorab als genehmigt, ungewiss oder verworfen einstuft — zuerst im Kalibrierungsmodus, aktiv erst nach dem Umschalten
  • Suchanalysen je Storefront-Sprache, mit Suchprotokoll, stĂŒndlicher Statistik, Erkennung von Störbegriffen und CSV-Export
  • Suchausschluss nach Kategorie sowie eine Filter-Map, die bestimmte Produkte aus den Ergebnissen zu einem Suchbegriff entfernt
  • Theme-fĂ€hig: Alle Farben sind CSS-Custom-Properties, ein Theme kann das Overlay daher ohne Plugin-Änderung umgestalten

Einstieg

  1. Richten Sie das Plugin nach dem Installationshandbuch ein und bauen Sie den Suchindex neu auf.
  2. Passen Sie das Overlay ĂŒber den Einstellungsleitfaden an.
  3. Erfahren Sie in der Bedienungsanleitung, wie Kunden die Suche nutzen und wie Sie Synonyme pflegen.
  4. Wenn etwas nicht wie erwartet funktioniert, sehen Sie in der FAQ & Fehlerbehebung nach.

Support

FĂŒr zusĂ€tzlichen Support wenden Sie sich bitte an unser technisches Support-Team oder besuchen Sie unser Support-Portal.

Topdata Enhanced Search SW6 Installationshandbuch

Systemanforderungen

  • Shopware 6.7 (mit Elasticsearch/OpenSearch, wie von Shopware selbst vorausgesetzt)
  • PHP-Version gemĂ€ĂŸ den Anforderungen von Shopware 6.7 sowie die Erweiterung ext-pdo
  • Die Plugins topdata/topdata-foundation-sw6 (>= 1.6.0) und topdata/topdata-top-finder-pro (>= 8.4.0)

Installationsschritte

1. Installation ĂŒber Composer

composer require topdata/enhanced-search-sw6

Die benötigten Topdata-Plugins werden automatisch mit installiert.

2. Aktivieren des Plugins

Option A: Über das Shopware-Admin-Panel

  1. Melden Sie sich in Ihrem Shopware-Admin-Panel an.
  2. Wechseln Sie zu Erweiterungen > Meine Erweiterungen.
  3. Suchen Sie “Topdata Enhanced Search SW6” in der Liste.
  4. Klicken Sie auf Aktivieren.

Option B: Über die Befehlszeile

bin/console plugin:install --activate TopdataEnhancedSearchSW6

3. Suchindex neu aufbauen

Das Plugin erweitert die Index-Definition von Shopware, daher ist nach der Installation ein vollstÀndiger Neuaufbau des Suchindex erforderlich:

bin/console es:index

Bei einem großen Katalog kann dies mehrere Minuten dauern. Der Schritt darf nicht ĂŒbersprungen werden — ohne Neuaufbau sind die Suchregeln des Plugins nicht aktiv.

4. Cache leeren

bin/console cache:clear

ÜberprĂŒfung

  • Öffnen Sie den Storefront und geben Sie mindestens zwei Zeichen in das Suchfeld ein: Das Such-Overlay öffnet sich unterhalb des Suchfeldes mit mindestens einem Bereich.
  • Öffnen Sie im Administration Topdata Enhanced Search: Die Seiten Synonyme, SuchvorschlĂ€ge, Suchprotokoll und Suchstatistik stehen zur VerfĂŒgung.

Optional: KI-Funktionen

Die Strategien mit einem Sprachmodell und die KI-Bewertung der Synonym-VorschlĂ€ge benötigen zusĂ€tzlich das Plugin topdata/llm-connect-sw6 mit einem dort hinterlegten API-Zugang. Der Status wird in den Plugin-Einstellungen angezeigt (Synonym-VorschlĂ€ge > LLM-Provider-Status). Ohne dieses Plugin werden die LLM-Strategien ĂŒbersprungen, alles Weitere funktioniert weiterhin.

Fehlerbehebung

Das Such-Overlay erscheint nicht

  • PrĂŒfen Sie, ob das Plugin aktiv ist: bin/console plugin:list.
  • Bauen Sie den Index neu auf: bin/console es:index.
  • PrĂŒfen Sie, ob Ihr Theme nicht das originale Suchformular entfernt — das Overlay bindet sich an das Suchfeld im Storefront.

Viele Suchbegriffe liefern direkt nach der Installation kein Ergebnis

KĂŒrzlich aktivierte Produkte fehlen im Index, bis er neu aufgebaut wurde. FĂŒhren Sie bin/console es:index aus.

Die Installation schlÀgt wegen einer fehlenden Tabelle fehl

Die Migrationen legen die eigenen Tabellen des Plugins an (tdes_*). Entfernen Sie diese niemals manuell. Wurde eine Installation unterbrochen, deaktivieren Sie das Plugin, aktivieren Sie es erneut und leeren Sie anschließend den Cache.

Topdata Enhanced Search SW6 Einstellungsleitfaden

Dieser Leitfaden listet alle Konfigurationsoptionen des Plugins, gruppiert nach den Karten der Plugin-Einstellungen (Topdata Enhanced Search > Einstellungen). In der ersten Spalte steht der rohe KonfigurationsschlĂŒssel, sodass Sie den Wert alternativ auch in der config.php setzen können.

Topdata

Die erste Karte zeigt nur das Topdata-Banner mit einem Link auf dieses Handbuch. Sie enthÀlt keine eigenen Einstellungen.

Layout

Legt fest, wie viele EintrÀge jeder Bereich des Overlays anzeigt und wie die Bereiche angeordnet sind.

SettingDefaultDescription
searchLayoutvertical-accordionSuchlayout
maxProducts5Max. Produkte
maxCategories5Max. Kategorien
maxManufacturers3Max. Hersteller
emptyBrandHandlingshow_allMarken ohne Produkte — Leere Marken (0 aktive, nach Kategorie-Ausschluss zĂ€hlbare Produkte) im Marken-Vorschlag der Suche ausblenden oder ausgrauen.
maxConsumables3Max. Verbrauchsmaterial-GerÀte
maxSuggestions5Max. SuchvorschlÀge

Visibility

Schaltet einzelne Bereiche des Overlays ein oder aus und konfiguriert die Produktkarten.

SettingDefaultDescription
showProductsSectiontrueProdukte anzeigen
skuDisplayModehideSKU-Anzeige
enableTermHighlightingtrueSuchbegriff-Hervorhebung aktivieren
showCategoriesSectiontrueKategorien anzeigen
showManufacturersSectiontrueHersteller anzeigen
showConsumablesSectiontrueVerbrauchsmaterial anzeigen
showSearchHistorySectiontrueLetzte Suchanfragen anzeigen
showSuggestionsSectiontrueSuchvorschlÀge anzeigen

Hinweise

skuDisplayMode — Steuert, ob und wie die Artikelnummer (SKU) in den Produktkarten des Such-Overlays angezeigt wird. “Eigene Zeile” zeigt die SKU unter Name/Untertitel, “Vor/Nach der Untertitel-Zeile” fĂŒgt sie in die vorhandene Untertitel-Zeile ein. Die Farbe ist ĂŒber die CSS-Klasse “tdes-product-list__sku” anpassbar. enableTermHighlighting — Hebt den eingegebenen Suchbegriff in den Treffern des Such-Overlays hervor (Produktnamen, Untertitel, SKUs, Vorschlags-/Kategorie-/Herstellernamen und Kategorie-Breadcrumbs). Die Farbe ist ĂŒber die CSS-Variablen “—tdes-color-highlight-*” bzw. die Klasse “tdes-highlight” theme-bar.

Suchausschluss

Blendet Produkte aus der Storefront-Suche aus.

SettingDefaultDescription
excludedCategories—Von der Suche ausgeschlossene Kategorien — Produkte, die diesen Kategorien zugeordnet sind, werden nicht ĂŒber die Storefront-Suche gefunden.
excludeOnlyMainCategoryfalseNur Produkte ausschließen, deren Hauptkategorie ausgeschlossen ist

Hinweise

excludeOnlyMainCategory — Wenn aktiviert, wird ein Produkt nur dann aus der Suche ausgeblendet, wenn eine ausgeschlossene Kategorie seine Hauptkategorie ist. Produkte, die einer ausgeschlossenen Kategorie nur als Nebenkategorie zugeordnet sind, bleiben auffindbar.

Suchverhalten

Stellt ein, wie tolerant die Produktsuche gegenĂŒber Schreibweisen ist.

SettingDefaultDescription
disableFuzzySearchfalseFuzzy-Suche deaktivieren

Hinweise

disableFuzzySearch — Deaktiviert den Fuzziness-Parameter (AUTO:3,8) in Produkt-Suchanfragen. Verhindert Fast-Treffer (z. B. “Toiletten” matcht “Tabletten”), entfernt aber auch die Fuzzy-Tippfehlertoleranz. Exakte, PrĂ€fix- und Edge-Ngram-Treffer bleiben aktiv.

Kategorie-VorschlÀge

Konfiguriert die Darstellung der passenden Kategorien im Overlay.

SettingDefaultDescription
categorySuggestLayoutaboveAnzeige-Layout der Kategorien in der Suchvorschau — WĂ€hlen Sie, ob passende Kategorien ĂŒber den Produkten oder links daneben angezeigt werden.
categorySuggestLimit8Maximale Anzahl Kategorie-VorschlĂ€ge — Wie viele passende Kategorien in der Suchvorschau angezeigt werden.
categoryBreadcrumbHideRoottrueRoot-Kategorie im Breadcrumb ausblenden — Entfernt das erste (Root-)Element aus den Kategorie-Breadcrumbs im Such-Overlay, z. B. “Hygiene â€ș PapierhandtĂŒcher & Spender” statt “Focus Shop â€ș Hygiene â€ș PapierhandtĂŒcher & Spender”.
categoryBreadcrumbMaxParts3Maximale Breadcrumb-Teile vor mittiger KĂŒrzung — Hat ein Kategorie-Breadcrumb mehr als diese Anzahl durch ” â€ș ” getrennter Teile, zeigt das Such-Overlay nur den ersten und letzten Teil, verbunden mit ” 
 ”.

Suchanalysen

Steuert, ob Suchbegriffe protokolliert und konsolidiert werden.

SettingDefaultDescription
enabledtrueSuchbegriff-Logging aktivieren
autoConsolidatetrueAutomatische Konsolidierung ĂŒber geplante Aufgabe aktivieren — Konsolidiert die rohen Suchprotokoll-EintrĂ€ge stĂŒndlich in die Suchstatistik-Tabelle. Wenn deaktiviert, können Sie weiterhin “topdata:enhanced-search:consolidate-search-logs” manuell ausfĂŒhren.

Synonym-VorschlÀge

Kosten und Verhalten der automatischen Synonym-Vorschlagsstrategien.

SettingDefaultDescription
maxSuggestionsPerRun50Max VorschlĂ€ge pro Durchlauf — Sicherheitslimit fĂŒr gespeicherte VorschlĂ€ge pro Durchlauf. Kandidatenbegriffe ohne Vorschlag verbrauchen kein Kontingent.
maxTermsPerRun10Begriffe pro Strategie und Durchlauf (FenstergrĂ¶ĂŸe)
fuzzyMaxEditsShort2Max Levenshtein-Änderungen (kurze Begriffe <=6 Zeichen)
fuzzyMaxEditsLong3Max Levenshtein-Änderungen (lange Begriffe >6 Zeichen)
highZeroCountThreshold3Schwellenwert fĂŒr hohe Null-Ergebnisse
enabledStrategiesTITLE_MINED,MPN_PREFIX_FAMILY,LLM,THESAURUS_THEN_LLM_FILTERAktivierte Vorschlags-Strategien (in AusfĂŒhrungsreihenfolge)
mpnPrefixFamilyMinMembers2Min. Varianten fĂŒr eine MPN-PrĂ€fix-Familie
llmProviderNotice—LLM-Provider-Status
llmModelIdentifier—LLM-Modell
llmBatchSize5LLM Batch-GrĂ¶ĂŸe (Begriffe pro Aufruf) — Wie viele Null-Ergebnis-Begriffe pro Chat-Request an das LLM gesendet werden.
llmPoolSize50LLM Ziel-Pool-GrĂ¶ĂŸe — Wie viele erfolgreiche Begriffe derselben Sprache dem LLM als gĂŒltige Ziel-Kandidaten angeboten werden.

Hinweise

maxTermsPerRun — Jeder Durchlauf verarbeitet die Vereinigung der N meistgesuchten offenen Begriffe, die jede aktivierte Strategie beisteuert (pro Lauf ĂŒberschreibbar mit —max-terms). Dies ist der wichtigste Kostenfaktor: Die Laufzeit wird von der teuersten aktivierten Strategie bestimmt. enabledStrategies — Kommagetrennte Liste der Strategie-Keys in AUSFÜHRUNGSREIHENFOLGE, gĂŒnstigste zuerst: TITLE_MINED, MPN_PREFIX_FAMILY, HEURISTIC, LLM, THESAURUS_THEN_LLM_FILTER. Die Reihenfolge bestimmt, welche Strategie zuerst lĂ€uft — es gibt keine versteckte PrioritĂ€t. TITLE_MINED bildet Null-Ergebnis-Begriffe auf titel-geminte Katalog-Phrasen ab und ist gĂŒnstig; zuerst search-suggestion:generate-from-titles ausfĂŒhren. MPN_PREFIX_FAMILY erkennt PrĂ€fix-Familien von Kartuschen/Tonern in den Hersteller-Artikelnummern und schlĂ€gt kanonische Basis-Synonyme vor (z. B. “TN 247” -> “TN-247”). Die HEURISTIC-Strategie nutzt Levenshtein-AbstĂ€nde und produziert oft semantisch falsche VorschlĂ€ge — nur aktivieren, wenn die Markierung von Begriffen mit vielen Null-Ergebnissen benötigt wird. LLM bildet Null-Ergebnis-Begriffe auf erfolgreiche Begriffe ab; THESAURUS_THEN_LLM_FILTER ist die teuerste (LLM-kuratierte Thesaurus-)Strategie und sollte zuletzt laufen. mpnPrefixFamilyMinMembers — Mindestanzahl an Hersteller-Artikelnummern mit gemeinsamer PrĂ€fix-Basis, bevor die MPN_PREFIX_FAMILY-Strategie sie als Familie behandelt, z. B. TN-247, TN-247M, TN-247BK = 3. Familien verwandeln Null-Ergebnis-Suchen mit Formatierungsvarianten (“TN 247”) in Synonym-VorschlĂ€ge fĂŒr die kanonische Basis (“TN-247”). llmModelIdentifier — Chat-Modell fĂŒr die Strategien “LLM” und externe API. AuswĂ€hlbar sind nur Chat-Modelle. Leer lassen, um ĂŒber die LLM-Router-Purpose-Kette aufzulösen. Gespeichert wird ein Verweis auf das LLM-Connect-Modell; der Provider wird daraus abgeleitet und kann daher nicht verwechselt werden.

SuchvorschlÀge aus Produkttiteln

Regeln fĂŒr das Gewinnen wiederkehrender Phrasen aus Ihren Produkttiteln.

SettingDefaultDescription
suggestionMiningMinProducts3Mindestanzahl Produkte pro Phrase — Eine Titel-Phrase wird nur dann zum Suchvorschlag, wenn sie von mindestens so vielen verschiedenen aktiven Produkten geteilt wird. Pro Lauf ĂŒberschreibbar mit —min-products.
suggestionMiningMaxWords4Maximale Wörter pro Phrase — Es werden nur Titel-Phrasen bis zu dieser Anzahl kanonischer Tokens berĂŒcksichtigt (Maße zĂ€hlen als ein Token, z. B. “120x60x60”). Pro Lauf ĂŒberschreibbar mit —max-words.
suggestionMiningIncludeMidTitletruePhrasen aus dem gesamten Titel einbeziehen
suggestionMiningLimit0Sicherheitslimit pro Sprachgruppe (0 = kein Limit) — Optionales Sicherheitslimit, sortiert nach der Anzahl der Produkte, die sich die Phrase teilen. Bei 0 entscheidet allein die Regel “Mindestanzahl Produkte pro Phrase”. Pro Lauf ĂŒberschreibbar mit —limit (0 = kein Limit).
suggestionMiningLanguage—Sprachfilter (leer = alle) — BeschrĂ€nkt die Generierung auf eine Storefront-Sprachgruppe. de und gsw sind dieselbe Gruppe. Pro Lauf ĂŒberschreibbar mit —language.
suggestionMiningTargetQueryorder=topsellerQuery-String fĂŒr generierte Such-URLs — Wird beim Klick auf einen generierten Vorschlag an /search?search= angehĂ€ngt, z. B. order=topseller. Leer lassen fĂŒr kein Suffix.

Hinweise

suggestionMiningIncludeMidTitle — Es werden auch mehrwortige Phrasen ĂŒberall im Produkttitel erfasst, z. B. “WC-Papier” aus “HAKLE WC-Papier 
”. Einzelne Wörter werden nur am Titelanfang erfasst. Ausschalten stellt das reine PrĂ€fix-Mining wieder her. Pro Lauf ĂŒberschreibbar mit —prefix-only.

Synonym-VorschlÀge banding (Jev)

Optionale KI-Vorklassifizierung offener Synonym-VorschlÀge. Benötigt topdata/llm-connect-sw6.

SettingDefaultDescription
bandingModeoffBanding-Modus
bandingModelIdentifier—Jev-Modell
bandingBatchSize20VorschlĂ€ge pro Jev-Request — Wie viele VorschlĂ€ge in einen Decisions-Request gepackt werden (ein State-Array, ein noul- + Score-Fragenpaar pro Vorschlag).
bandingAutoNoulMin0.9Automatisch genehmigen: min. noul-Wahrscheinlichkeit
bandingAutoScoreMin2.6Automatisch genehmigen: min. Relevanz-Score
bandingDiscardNoulMax0.2Verwerfen: max. noul-Wahrscheinlichkeit
bandingDiscardScoreMax1.5Verwerfen: max. Relevanz-Score
bandingMinProducts1Min. Produkte fĂŒr automatische Genehmigung

Hinweise

bandingMode — off: keine Wirkung. shadow: Jev bewertet jeden offenen Vorschlag und speichert das KI-Votum (AI_APPROVED / AI_UNCERTAIN / AI_DISCARDED) zur Kalibrierung, ohne zu handeln. active: genehmigt AI_APPROVED-Voten zusĂ€tzlich automatisch in tdes_synonym und verwirft AI_DISCARDED-Voten. shadow ist der einmalige Kalibrierungsmodus: eine kleine Stichprobe bewerten, die Voten im Admin prĂŒfen, Schwellwerte anpassen, dann mit —reband erneut laufen lassen und auf active umstellen. Erfordert topdata/llm-connect-sw6 mit dem Jev-Client und einen OpenRouter-API-Key beim Provider “jev”. Nach der Generierung topdata:enhanced-search:synonym-suggestions:band ausfĂŒhren. bandingModelIdentifier — Entscheidungsmodell, mit dem Synonym-VorschlĂ€ge bewertet werden. AuswĂ€hlbar sind nur Entscheidungsmodelle (gemĂ€ĂŸ Modellkatalog des Providers). Gespeichert wird ein Verweis auf das LLM-Connect-Modell; der Provider wird daraus abgeleitet und kann daher nicht verwechselt werden. bandingAutoScoreMin — Der Relevanz-Score ist eine 0-3-Skala (irrelevant / schwach / gut / exakt). 2.6 akzeptiert zusĂ€tzlich starke Wortvarianten (z. B. Singular/Plural) und regionale Varianten — nur weiter senken, wenn diese als Synonyme akzeptiert werden sollen. bandingMinProducts — Ist das Ziel eine titel-geminte Phrase mit bekannter gecachter Produktanzahl, erfordert die automatische Genehmigung mindestens so viele Produkte; eine bekannte Anzahl von 0 verwirft immer. Ziele ohne bekannte Anzahl entscheidet Jev allein.

Debug

Diagnoseausgaben zur Fehlerbehebung.

SettingDefaultDescription
showSearchDurationfalseSuchdauer anzeigen (ms)

Support

FĂŒr zusĂ€tzlichen Support wenden Sie sich bitte an unser technisches Support-Team oder besuchen Sie unseren Support-Portal.

Topdata Enhanced Search SW6 Bedienungsanleitung

Was Kunden sehen

Sobald ein Kunde im Suchfeld des Storefronts tippt, öffnet sich das Such-Overlay und gruppiert die Treffer in Bereiche. Welche Bereiche erscheinen und wie viele EintrÀge sie enthalten, steuern Sie in den Plugin-Einstellungen (siehe Einstellungsleitfaden).

BereichInhalt
SuchvorschlÀgeKuratierte Phrasen aus Ihrem Katalog mit Produktanzahl, z. B. WC-Papier (12 Artikel)
ProduktePassende Produkte mit Name, Untertitel und — falls aktiviert — der Artikelnummer
KategorienPassende Kategorien, wahlweise ĂŒber den Produkten oder daneben
HerstellerMarken, jeweils mit der Anzahl ihrer aktiven Produkte
Verbrauchsmaterial-GerÀteGerÀte, zu denen die passenden Verbrauchsmaterialien gehören
Letzte SuchanfragenWonach dieser Kunde zuvor gesucht hat

Der Suchbegriff wird in Namen, Untertiteln, Artikelnummern und Breadcrumbs hervorgehoben. Die Farben sind CSS-Custom-Properties, ein Theme kann das Overlay daher in der eigenen base.scss umgestalten:

.tdes-overlay {
    --tdes-color-accent: #e96354;
    --tdes-color-highlight-bg: #f2d0c8;
}

Der Link „Alle N Ergebnisse anzeigen” bei einem Vorschlag öffnet die Vorschlags-Seite (/suggestion-search?search=<Begriff>) mit allen passenden VorschlĂ€gen, je mit Ziel-URL und Produktanzahl.

SuchqualitÀt pflegen

Das Plugin erfasst, wonach Ihre Kunden suchen, und leitet daraus VorschlĂ€ge und Synonyme ab. Der Ablauf besteht aus vier Schritten und ist fĂŒr den planmĂ€ĂŸigen Betrieb gedacht.

Schritt 1 — Suchanalysen sammeln lassen

Es ist nichts zu tun: Solange enabled (Suchanalysen) aktiv ist, wird jede Storefront-Suche sprachbezogen protokolliert. Eine geplante Aufgabe konsolidiert das Rohprotokoll stĂŒndlich in die Statistik. Falls Sie autoConsolidate deaktiviert haben, fĂŒhren Sie die Konsolidierung manuell aus:

bin/console topdata:enhanced-search:consolidate-search-logs

Werten Sie die Daten im Administration unter Topdata Enhanced Search > Suchstatistik aus. Die Seite Suchprotokoll zeigt die Rohdaten. Begriffe, aus denen nie ein sinnvolles Synonym entstehen kann — reine Zahlen wie SKU oder EAN, vollstĂ€ndige Markennamen, FĂŒllwörter, sehr kurze Begriffe — werden als Störbegriffe markiert und gelangen nie in den Vorschlags-Workflow.

Schritt 2 — SuchvorschlĂ€ge aus Produkttiteln gewinnen

Wiederkehrende Phrasen in Ihren Produkttiteln werden zu VorschlÀgen:

bin/console topdata:enhanced-search:search-suggestion:generate-from-titles

Wichtige Optionen:

OptionWirkung
--languageLauf auf eine Storefront-Sprache beschrÀnken (de und gsw sind dieselbe Gruppe)
--min-productsMindestanzahl der Produkte, die eine Phrase teilen mĂŒssen, ĂŒberschreiben
--max-wordsMaximale PhrasenlĂ€nge ĂŒberschreiben
--limitObergrenze der VorschlÀge pro Sprachgruppe (0 = kein Limit)
--prefix-onlyNur TitelprĂ€fixe berĂŒcksichtigen (ĂŒberschreibt suggestionMiningIncludeMidTitle)
--skip-countsDie zwischengespeicherten Produktanzahlen nicht aktualisieren

Phrasen, die von weniger Produkten geteilt werden als suggestionMiningMinProducts vorgeben, werden ignoriert. Eine Phrase mit bekannter Produktanzahl 0 wird ĂŒbersprungen. FĂŒhren Sie diesen Schritt vor der Synonym-Generierung in Schritt 3 aus — der titel-geminte Vorrat ist eine deren Eingangsquellen.

Die Ergebnisse pflegen Sie unter Topdata Enhanced Search > SuchvorschlÀge.

Schritt 3 — Synonym-VorschlĂ€ge generieren

Begriffe ohne Treffer sind die interessanten. Das Plugin bildet sie auf Begriffe ab, die Treffer hatten:

bin/console topdata:enhanced-search:synonym-suggestion:generate

Die Strategien laufen in der in enabledStrategies konfigurierten Reihenfolge, gĂŒnstigste zuerst:

StrategieWirkung
TITLE_MINEDBildet einen Null-Ergebnis-Begriff auf eine aus Produkttiteln gewonnene Phrase ab
MPN_PREFIX_FAMILYErkennt Kartuschen-/Toner-Familien mit gemeinsamer PrĂ€fix-Basis der Hersteller-Artikelnummer und schlĂ€gt die kanonische Basis vor (TN 247 → TN-247)
HEURISTICLevenshtein-Abgleich; gĂŒnstig, aber hĂ€ufig semantisch falsch — nur aktivieren, wenn Sie Begriffe mit vielen Null-Ergebnissen markieren möchten
LLMLĂ€sst ein Sprachmodell Null-Ergebnis-Begriffe auf erfolgreiche abbilden
THESAURUS_THEN_LLM_FILTERThesaurus-Kandidaten, von einem LLM auf den produktrelevanten Teil eingegrenzt; die teuerste Strategie, zuletzt ausfĂŒhren

Optionen: --strategy (nur eine Strategie), --language, --max-terms (FenstergrĂ¶ĂŸe), --limit (Obergrenze gespeicherter VorschlĂ€ge), --reset-processed (bereits verarbeitete Begriffe erneut prĂŒfen), --debug, --allow-disabled-strategy.

maxTermsPerRun und maxSuggestionsPerRun sind die wichtigsten Kostenregler: Die Laufzeit wird von der teuersten aktivierten Strategie bestimmt. Jeder Lauf meldet, wie viele Begriffe er als verarbeitet markiert hat — spĂ€tere LĂ€ufe ĂŒberspringen diese, statt sie erneut zu bezahlen.

Die VorschlÀge warten auf Ihre Freigabe im Administration unter Topdata Enhanced Search > Synonym-VorschlÀge. Mit der Freigabe wird das Synonym geschrieben; es wird nach bin/console es:index durchsuchbar.

Schritt 4 — Optional: VorschlĂ€ge von KI vorklassifizieren lassen

Ist topdata/llm-connect-sw6 vorhanden, kann das Entscheidungsmodell Jev jeden offenen Vorschlag bewerten, bevor Sie ihn sehen. Beginnen Sie im Kalibrierungsmodus:

  1. Setzen Sie bandingMode auf shadow.

  2. Bewertung ausfĂŒhren:

    bin/console topdata:enhanced-search:synonym-suggestions:band --limit 50

    Der Lauf endet mit drei Tabellen — genehmigt / verworfen / unentschieden — je Zeile mit noul-Wahrscheinlichkeit, Relevanz-Score, Produktanzahl und einer Notiz. Im Modus shadow lauten die Überschriften „Would be 
”: Die Voten werden gespeichert, aber es wird nichts in die Synonyme geschrieben.

  3. Passen Sie bandingAutoScoreMin / bandingAutoNoulMin (und die Verwerfungs-Schwellen) an das an, was Sie als gutes Synonym betrachten. Der Bericht nennt, wie viele Zeilen ein niedrigerer Score-Schwellenwert genehmigen wĂŒrde.

  4. Wenn die Kalibrierung stimmt, erneut mit --reband ausfĂŒhren — das bewertet alles neu, was die KI entschieden hat, und legt ungewisse Zeilen zurĂŒck in Ihre Warteschlange — und bandingMode anschließend auf active stellen.

Im Modus active werden AI_APPROVED-Zeilen automatisch in die Synonyme geschrieben und AI_DISCARDED-Zeilen geschlossen. Zwei harte Regeln gelten immer: Ein Ziel mit bekannter Produktanzahl 0 wird verworfen, und ein Ziel unterhalb von bandingMinProducts kann nie genehmigt werden. Jeder Fehler im KI-Aufruf fĂŒhrt zum offenen Ausgang — die Zeilen bleiben einfach offen. Optionen: --dry-run, --limit, --language, --type, --reband.

Beachten Sie, dass der Relevanz-Score eine Bewertung und keine Messung ist: Erneutes Bewerten derselben Zeile kann den Score leicht verschieben. Beurteilen Sie einen Schwellenwert daher an einem vollstÀndigen Lauf, nicht an einer einzelnen Zeile.

Synonyme im Alltag pflegen

Unter Topdata Enhanced Search > Synonyme pflegen Sie die aktiven Synonymregeln. Jede Regel hat einen Suchbegriff, einen oder mehrere Zielbegriffe, einen Geltungsbereich (alle Sprachen oder eine einzelne) und eine Boost-Stufe (NONE, LOW, MEDIUM, HIGH), die die Zielbegriffe in der Trefferbewertung hochwertet.

  • Das Bearbeiten oder HinzufĂŒgen einer Regel erfordert anschließend bin/console es:index.
  • Eine Änderung der Boost-Stufe wirkt sofort, ohne Neuaufbau des Index.
  • Export und Import sind asymmetrisch und quellenerhaltend (term => term, targets), damit ein Produkt, das den Quellbegriff wörtlich enthĂ€lt, seine normalen Treffer behĂ€lt:
# aktuelle Regeln sichern
bin/console topdata:enhanced-search:synonym:export --output synonyms-backup.txt

# Datei vor dem Import auf Syntaxfehler prĂŒfen
bin/console topdata:enhanced-search:synonym:import synonyms.txt --dry-run

# Regeln aus einer Textdatei importieren, danach Index neu aufbauen
bin/console topdata:enhanced-search:synonym:import synonyms.txt
bin/console es:index

Verwandte Seiten: Synonym-Quellen (konfigurierte CSV-Importe), Synonym-APIs (externe Quellen), Filter-Map (bestimmte Produkte aus den Ergebnissen eines Suchbegriffs entfernen) und Such-Stoppwörter (Wörter, mit denen das Titel-Mining nie einen Vorschlag beenden soll).

NĂŒtzliche Befehle

# Synonyme
bin/console topdata:enhanced-search:synonym:list
bin/console topdata:enhanced-search:synonym:validate synonyms.txt
bin/console topdata:enhanced-search:synonym:delete "papier"
bin/console topdata:enhanced-search:synonym:clear

# VorschlÀge
bin/console topdata:enhanced-search:synonym-suggestion:list
bin/console topdata:enhanced-search:search-suggestion:clear
bin/console topdata:enhanced-search:synonym-suggestion:clear

# Diagnose: zeigt, wie die Produkte zu einem Begriff bewertet werden
bin/console topdata:enhanced-search:debug-search "papier"

Support

FĂŒr zusĂ€tzlichen Support wenden Sie sich bitte an unser technisches Support-Team oder besuchen Sie unser Support-Portal.

Topdata Enhanced Search SW6 FAQ & Fehlerbehebung

HĂ€ufige Probleme

SymptomWahrscheinliche UrsacheLösung
Das Such-Overlay öffnet sich nichtDas Plugin ist nicht aktiv oder der Suchindex wurde nie neu aufgebautbin/console plugin:list, danach bin/console es:index
Ein neu angelegtes Synonym zeigt keine WirkungDer Index enthÀlt noch den alten Synonym-Standbin/console es:index
Ein Synonym wirkt, aber ein Produkt, das den Begriff enthÀlt, fehlt in den TreffernDie Regel leitet den Begriff um; Export/Import ist quellenerhaltend (term => term, targets)ErgÀnzen Sie den Quellbegriff in der ZielListe der Regel und bauen Sie den Index neu auf
Die Treffer enthalten offensichtlich falsche Produkte (z. B. „Toiletten” findet „Tabletten”)Die Fuzzy-Suche ist aktivdisableFuzzySearch aktivieren und Index neu aufbauen — oder das Produkt ĂŒber die Filter-Map fĂŒr diesen Begriff ausschließen
Korrekte Produkte fehlen in den TreffernSie sind einer ausgeschlossenen Kategorie zugeordnetexcludedCategories prĂŒfen; sind die Produkte der Kategorie nur als Nebenkategorie zugeordnet, excludeOnlyMainCategory aktivieren
Marken ohne Produkte verwirren die HerstellerlisteLeere Marken werden standardmĂ€ĂŸig angezeigtemptyBrandHandling auf hide_empty oder grey_empty setzen
Kategorienamen im Overlay sind zu langLange BreadcrumbscategoryBreadcrumbMaxParts erhöhen oder categoryBreadcrumbHideRoot deaktivieren
Die Synonym-Generierung findet nichtsEs wurden noch keine Begriffe ohne Treffer erfasst, oder alle sind als verarbeitet markiertDie Analyse einige Zeit laufen lassen, Suchstatistik prĂŒfen und --reset-processed verwenden
Ein Generierungslauf dauert sehr langeEine teure Strategie ist aktiviertTHESAURUS_THEN_LLM_FILTER aus enabledStrategies entfernen oder maxTermsPerRun senken
Es werden keine Synonym-VorschlÀge erzeugt, obwohl das LLM konfiguriert istDie LLM-Strategie wurde entfernt, weil topdata/llm-connect-sw6 fehltPlugin installieren und einen Zugang unter Topdata Llm Connect > AI Credentials hinterlegen
Die KI-Bewertung (Banding) tut nichtsbandingMode steht noch auf off oder beim Provider jev fehlt der API-KeybandingMode zur Kalibrierung auf shadow setzen; Zugang fĂŒr den Provider jev prĂŒfen
Produktanzahlen neben VorschlĂ€gen sind veraltetDer Katalog wurde nach dem letzten Mining-Lauf geĂ€nderttopdata:enhanced-search:search-suggestion:generate-from-titles ohne --skip-counts erneut ausfĂŒhren; Ă€ltere ZĂ€hler als der aktive Index werden automatisch neu berechnet
Die Overlay-Farben passen nicht zum ThemeDas Theme ĂŒberschreibt die CSS-Custom-Properties nichtDie Variablen --tdes-color-* in der base.scss des Themes auf .tdes-overlay setzen

Fehlerbehebungsanleitung

1. Die Suche liefert nach einem Update keine Ergebnisse

Shopware 6.7 verwendet fĂŒr das Indexfeld des Plugins einen echten Edge-Ngram-Tokenizer. Nach einem Update muss der Index neu aufgebaut werden, sonst sind die neuen Suchregeln nicht aktiv:

bin/console cache:clear
bin/console es:index

2. PrĂŒfen, wie ein Begriff bewertet wird

Mit dem Debug-Befehl sehen Sie, welche Produkte ein Begriff trifft und wie sie bewertet werden:

bin/console topdata:enhanced-search:debug-search "papier"

Mit --sales-channel-id und --language-id prĂŒfen Sie einen bestimmten Vertriebskanal und eine Sprache, --limit kĂŒrzt die Ausgabe.

3. Eine Synonymdatei lÀsst sich nicht importieren

Validieren Sie die Datei zuerst — der Befehl nennt die fehlerhafte Zeile, statt mitten im Lauf abzubrechen:

bin/console topdata:enhanced-search:synonym:validate synonyms.txt
bin/console topdata:enhanced-search:synonym:import synonyms.txt --dry-run

Eine Regel hat die Form [language,product,boost=LEVEL] term => syn1, syn2. FĂŒr die LLM-Strategien sind nur Chat-Modelle wĂ€hlbar, fĂŒr das Jev-Banding nur Entscheidungsmodelle.

4. Eine falsche KI-Entscheidung zurĂŒcknehmen

FĂŒhren Sie das Banding erneut mit --reband aus: Es bewertet jede Zeile neu, die die KI entschieden hat — auch die verworfenen — und legt Zeilen, die unentschieden zurĂŒckkommen, in die menschliche Warteschlange. Von Menschen entschiedene Zeilen werden nie berĂŒhrt. Nachdem neue Synonyme geschrieben wurden, bauen Sie den Index neu auf.

5. Die KI-Funktionen vorĂŒbergehend abschalten

Setzen Sie bandingMode auf off und entfernen Sie LLM und THESAURUS_THEN_LLM_FILTER aus enabledStrategies. Alles Weitere — Suchanalysen, Titel-Mining, MPN_PREFIX_FAMILY, die bestehenden Synonyme — funktioniert ohne KI-Zugang weiter.

Support

FĂŒr zusĂ€tzlichen Support wenden Sie sich bitte an unser technisches Support-Team oder besuchen Sie unser Support-Portal.