> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einleitung.md).

# So funktioniert die Suche

Wie die Suche arbeitet, von Ihren Produkten über unser Suchsystem bis zu den Treffern im Shop.

Das Plugin ersetzt die Suche Ihres Shopware-Shops durch eine Suche, die Tippfehler verzeiht, Synonyme kennt und Treffer nach Relevanz ordnet. Diese Seite erklärt in einfachen Worten, wie die Produkte dorthin kommen, was bei einer Suche passiert und wie schnell sich Änderungen im Shop auswirken.

## Der Weg Ihrer Produkte

Es gibt drei Stationen:

1. **Ihr Shop** liefert die Produktdaten: Titel, Beschreibung, Preise, Bilder, Kategorien, Eigenschaften.
2. **Unser Suchsystem** nimmt diese Daten entgegen, bereitet sie auf und legt sie so ab, dass sie in Sekundenbruchteilen durchsucht werden können.
3. **Ihre Kunden** tippen im Shop einen Suchbegriff ein. Die Anfrage geht direkt an unser Suchsystem, die Treffer erscheinen im Such-Overlay und auf der Suchergebnisseite Ihres Shops.

Ihr Shop selbst muss die Suche also nicht berechnen. Das entlastet ihn, auch bei vielen gleichzeitigen Besuchern.

## Begriffe: Datenquelle und Index

Die gelieferten Produktdaten eines Verkaufskanals und einer Sprache bilden zusammen eine **Datenquelle**. Im Plugin-Dashboard finden Sie sie im Bereich „Quellen“. Aus jeder Datenquelle baut unser Suchsystem einen **Index**. Das ist vereinfacht gesagt ein sehr schnell durchsuchbares Verzeichnis Ihrer Produkte, ähnlich dem Stichwortverzeichnis eines Buches.

Pro Datenquelle sehen Sie unter anderem Sprache, Währung, Anzahl der Produkte, den Modus (Pull oder Push) sowie die letzte und die nächste Indexierung. Wenn Ihr Shop mehrere Sprachen anbietet, brauchen Sie je Sprache eine eigene Datenquelle und eine Zuordnung zu Verkaufskanal und Sprache (siehe [Sprachzuordnung und Untertitel](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/allgemeine-einstellungen.md)).

## Pull und Push: zwei Wege für die Daten

Wie die Produktdaten zu uns kommen, legen Sie bei der Einrichtung fest.

|                    | Pull (Standard)                                           | Push                                                           |
| ------------------ | --------------------------------------------------------- | -------------------------------------------------------------- |
| So funktioniert es | Unser Suchsystem holt Ihren Produkt-Feed selbst ab.       | Das Plugin in Ihrem Shop sendet die Produkte.                  |
| Voraussetzung      | Die Feed-Adresse ist von außen ohne Anmeldung erreichbar. | Die Hintergrundverarbeitung von Shopware läuft dauerhaft.      |
| Geeignet für       | Live-Shops                                                | DEV- und Stage-Umgebungen, die von außen nicht erreichbar sind |

Ein **Produkt-Feed** ist eine Datei mit allen Produkten Ihres Verkaufskanals, ähnlich einem Google-Shopping-Feed. Der Wizard legt ihn für Sie an, als Verkaufskanal vom Typ „Produktvergleich“. Mehr dazu auf der Seite [Installation und Einrichtung](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/installation-und-einrichtung.md).

## Tägliche Indexierung

Beim Einlesen, der **Indexierung**, werden Ihre Produkte komplett neu verarbeitet. Das geschieht automatisch einmal am Tag. Bei Pull stellen Sie die Uhrzeit im Bereich „Quellen“ ein (Feld „Automatische Indexierung (Uhrzeit)“). Der Lauf startet innerhalb von 15 Minuten nach dieser Zeit. Lassen Sie das Feld leer, ist die automatische Indexierung aus. Bei Push läuft der tägliche Abgleich über die geplanten Aufgaben von Shopware.

Außerdem können Sie jederzeit selbst neu einlesen: Der Knopf „Produktdaten neu einlesen“ in der Karte der Datenquelle startet einen kompletten Lauf. Das geht immer, außer die Datenquelle ist durch InsightSearch gesperrt oder es läuft bereits ein Lauf.

Je nach Produktzahl dauert eine Indexierung eine Weile. Währenddessen arbeitet die Suche weiter. Danach kann noch die KI-Aufbereitung nachlaufen, die für die hybride Suche nötig ist (mehr dazu auf der Seite [KI-Funktionen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/ki-funktionen.md)).

## Was bei einem Suchaufruf passiert

Wenn ein Kunde im Shop zu tippen beginnt, passiert Folgendes:

1. Das Such-Overlay im Browser des Kunden schickt den Suchbegriff an unser Suchsystem.
2. Die Suche bereinigt den Begriff, toleriert je nach Suchstrategie Tippfehler und nimmt Wortanfänge mit. Synonyme aus Ihrer Pflege werden als zusätzliche Varianten mitgesucht.
3. Erkennt die Suche in der Eingabe einen bekannten Wert, etwa eine Marke oder eine Preisangabe wie „unter 50 €“, setzt sie ihn als Filter. Bei „Bosch Akkuschrauber“ wird also nach Akkuschraubern der Marke Bosch gesucht.
4. Die Treffer werden nach Relevanz geordnet. Dabei zählen die Suchgewichtung der Felder, die Beliebtheit der Produkte und Ihre Suchbegriff-Regeln.
5. Findet die Suche nichts, versucht sie es automatisch noch einmal gelockert, korrigiert Tippfehler und zeigt auf Wunsch Ersatzprodukte (siehe [Keine Treffer](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/keine-treffer.md)).
6. Die Treffer erscheinen im Overlay oder auf der Suchergebnisseite.

Wie genau die Suche mit Tippfehlern und mehreren Wörtern umgeht, stellen Sie mit der **Suchstrategie** ein: „Standard“, „Präzise“ oder „Explorativ“. Die Einstellung finden Sie in der Plugin-Konfiguration (siehe [Plugin-Konfiguration](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/plugin-einstellungen.md)).

## Kontingent „Suchanfragen“

Gezählt werden die Suchanfragen Ihrer Kunden. Weitere Ergebnisseiten derselben Suche, Zwischenstände beim Tippen und Bots zählen nicht. Den Verbrauch sehen Sie im Plugin unter „Suchanfragen diesen Monat“ mit den Werten „Aktuelle Suchanfragen“ und „Hochrechnung bis Monatsende“.

Wird das Kontingent überschritten, schaltet sich die Suche nicht ab und es entstehen keine automatischen Mehrkosten. Bei starker Überschreitung melden wir uns bei Ihnen, um gemeinsam eine Lösung zu finden.

## Wie schnell kommen Änderungen an?

Das hängt davon ab, was Sie ändern.

| Änderung im Shop                                                               | Wann sie in der Suche ankommt                                                                       |
| ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------- |
| Neue Produkte, geänderte Texte, Preise, Lagerbestand                           | Mit der nächsten Indexierung (täglich zur eingestellten Zeit oder nach „Produktdaten neu einlesen“) |
| Preis, Lager, Sichtbarkeit und gelöschte Produkte bei Push mit „Live-Abgleich“ | Nach etwa zwei Minuten                                                                              |
| Änderungen an Datenfeldern, Datenattributen und Suchgewichtung                 | Nach „Produktdaten neu einlesen“                                                                    |
| Suchbegriff-Regeln und Ranking-Einstellungen                                   | Nach etwa einer Minute, ohne Neu-Einlesen                                                           |
| Filter-Einstellungen                                                           | Bis zu 5 Minuten                                                                                    |
| Neue und geänderte Synonyme                                                    | Nach kurzer Zeit (Zwischenspeicher, bis zu einigen Minuten)                                         |

Ein gelöschtes Synonym kann bis zum nächsten Neu-Einlesen der Produktdaten noch nachwirken.

Der **Live-Abgleich** ist ein Schalter in der Plugin-Konfiguration (Karte „Live-Abgleich“, „Preis-, Lager- und Sichtbarkeitsänderungen sofort übertragen“, Standard aus). Er gilt nur für Push und immer für alle Verkaufskanäle. Mehr dazu unter [Push und Live-Abgleich](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/push-und-live-abgleich.md).

{% hint style="info" %}
Bei Pull mit der Option „Im Hintergrund generieren“ erzeugt Shopware die Feed-Datei per geplanter Aufgabe. Änderungen erscheinen dann erst mit dem nächsten Export-Lauf von Shopware, und erst danach kann unser Suchsystem sie einlesen.
{% endhint %}

## Weiterlesen

{% content-ref url="/pages/9Yl8w0qM8JGbltMC7PMr" %}
[Voraussetzungen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/voraussetzungen.md)
{% endcontent-ref %}

{% content-ref url="/pages/G8WHK3FCmQgWEZXwYEFm" %}
[Installation und Einrichtung](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/installation-und-einrichtung.md)
{% endcontent-ref %}

{% content-ref url="/pages/ZLOZ8FodmjtZCbb4ihPh" %}
[Glossar](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/glossar.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einleitung.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
