> 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/einstellungen/indizes.md).

# Quellen

Datenquellen ansehen, anlegen, neu einlesen und löschen, mit Status, Kennzahlen und Fehlerhilfe.

Im Bereich **Quellen** sehen Sie alle Datenquellen, aus denen die Suche ihre Produkte bezieht. Sie legen hier neue Produkt-Feeds an, lesen Produktdaten nach Änderungen neu ein und löschen Quellen, die Sie nicht mehr brauchen.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-d3992095aa084896b2adb5b8eb270564f4689f39%2Fsuche-intelligent-und-ki-optimiert-quellen.png?alt=media" alt="Bereich Quellen mit einer Datenquelle, Kennzahlen und Uhrzeit der automatischen Indexierung"><figcaption></figcaption></figure>

Ist noch keine Quelle vorhanden, weist eine gelbe Warnung darauf hin, dass noch keine Produkte für die Suche und die Empfehlungen eingelesen sind. Legen Sie dann mit „Produkt-Feed anlegen“ eine Quelle an.

## Die Karte einer Datenquelle

Jede Datenquelle hat eine Karte mit ihrem Namen und einem Status.

### Status

| Status                                | Bedeutung                                                             |
| ------------------------------------- | --------------------------------------------------------------------- |
| Synchron (grün)                       | Die Quelle ist eingelesen und aktuell.                                |
| In Bearbeitung (gelb)                 | Das Einlesen wartet oder wird vorbereitet.                            |
| Synchronisierung (gelb)               | Das Einlesen läuft gerade.                                            |
| Fehlgeschlagen (rot)                  | Das Einlesen ist gescheitert.                                         |
| Synchronisierung fehlgeschlagen (rot) | Der letzte Abgleich ist gescheitert. Die Quelle ist weiter vorhanden. |
| Status unbekannt (grau)               | Der Zustand ist nicht bekannt.                                        |

### Kennzahlen

Die Karte zeigt „Sprache“, „Währung“, „Produkte“ (Anzahl), „Modus“, „Letzte Indexierung“ und „Nächste Indexierung“. Fehlt ein Wert, steht dort „Nicht gesetzt“. Bei Feeds sehen Sie zusätzlich die Feed-Adresse.

Der **Modus** sagt, wie die Produkte zu uns kommen:

* **Feed (Pull):** Unser System ruft den Produkt-Feed Ihres Shops regelmäßig ab.
* **Push:** Ihr Shop sendet die Produkte selbst an unser System. Das ist für Entwicklungs- und Stage-Umgebungen gedacht, die von außen nicht erreichbar sind. Dafür muss die Hintergrundverarbeitung von Shopware laufen.

## Die Knöpfe

| Knopf                     | Wirkung                                                                                  |
| ------------------------- | ---------------------------------------------------------------------------------------- |
| Ansicht aktualisieren     | Lädt nur die Anzeige von Status und Kennzahlen neu. Es werden keine Produkte eingelesen. |
| Produkt-Feed anlegen      | Öffnet den Dialog „Weiteren Feed anlegen“ (siehe unten).                                 |
| Produktdaten neu einlesen | Liest alle Produktdaten der Quelle komplett neu ein, sofort und ohne Rückfrage.          |
| Datenfelder bearbeiten    | Öffnet den Editor, in dem Sie festlegen, welche Produktdaten übertragen werden.          |
| Löschen                   | Entfernt die Datenquelle samt Suchdaten (siehe unten).                                   |

„Produktdaten neu einlesen“ und „Löschen“ sehen Sie nur bei den Status „Synchron“, „In Bearbeitung“ und „Synchronisierung fehlgeschlagen“. Bei „Fehlgeschlagen“ und während des Einlesens fehlen sie. „Datenfelder bearbeiten“ erscheint nur, wenn die Quelle zu einem Produktvergleichs-Verkaufskanal Ihres Shops gehört oder eine Push-Quelle ist. Bei einem externen Feed gibt es den Knopf nicht.

{% content-ref url="/pages/OmNGCvlIfQV60CzrLwrX" %}
[Datenfelder bearbeiten](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/feed-template-editor.md)
{% endcontent-ref %}

### Manuelles Einlesen

Mit „Produktdaten neu einlesen“ können Sie jederzeit neu einlesen. Es geht nicht, wenn die Datenquelle durch InsightSearch gesperrt ist oder gerade schon ein Lauf aktiv ist. Bei einer Sperre erscheint der Hinweis, sich an den Support zu wenden. Die Meldung „Indexierung wurde angestoßen.“ bestätigt den Start.

Nach Änderungen an Datenfeldern, Datenattributen oder Synonymen ist ein Neu-Einlesen nötig, damit sie wirken.

### Löschen

Der Knopf „Löschen“ fragt mit dem Dialog „Feed löschen“ nach. Löschen Sie eine Quelle, geschieht Folgendes:

* Der Suchindex dieser Quelle wird gelöscht, mit den Daten für Suchvorschläge.
* Die zugehörigen Datenattribute, Synonyme, Filter und Protokolle des Einlesens werden gelöscht.
* Statistikdaten bleiben bewusst erhalten.
* Bei Push werden zusätzlich die Push-Daten in Ihrem Shop entfernt (Aufträge, Sitzungen, Feld-Einstellungen).

{% hint style="warning" %}
Das Löschen lässt sich nicht rückgängig machen. Synonyme, Filter und Einstellungen der Datenattribute müssten Sie danach neu anlegen. Deinstallieren Sie das Plugin, werden die Datenquellen auf dieselbe Weise gelöscht.
{% endhint %}

## Weiteren Feed anlegen

„Produkt-Feed anlegen“ öffnet den Dialog „Weiteren Feed anlegen“. Er ist derselbe wie im Einrichtungsassistenten. Der Standard ist ein Produkt-Feed, den Shopware als Verkaufskanal vom Typ „Produktvergleich“ erzeugt und den unser System automatisch einliest.

| Feld                                                                        | Wirkung                                                                                                                                                                                           | Standard                                             |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| Indexierungsart                                                             | „Pull“: InsightSearch holt den Produkt-Feed ab. Die Feed-Adresse muss von außen erreichbar sein, also ohne Passwortschutz. „Push“: Das Plugin sendet die Produkte, nur für Entwicklung und Stage. | Pull                                                 |
| Name                                                                        | Name für den Produkt-Feed und den zugehörigen Verkaufskanal, z. B. „Feed Staging-Shop“. Pflicht.                                                                                                  | „InsightSearch Feed“                                 |
| Storefront-Verkaufskanal                                                    | Nur Produkte aus diesem Kanal gehen an die Suche. Pflicht. Möglich sind nur Storefront-Kanäle.                                                                                                    | keiner                                               |
| Storefront-Domain                                                           | Domain des Kanals, in der Regel die Hauptdomain. Erst wählbar, wenn ein Kanal gewählt ist. Pflicht.                                                                                               | Bei nur einer Domain vorausgewählt                   |
| Sprache                                                                     | Sprache der Texte im Feed. Nur Sprachen des Kanals. Pflicht.                                                                                                                                      | Standardsprache des Kanals                           |
| Währung                                                                     | Gilt für alle Preise im Feed. Pflicht.                                                                                                                                                            | Währung des Kanals                                   |
| Kundengruppe                                                                | Auf dieser Basis gelten Preis- und Sichtbarkeitsregeln, damit der Feed dieselben Konditionen nutzt wie der Shop. Pflicht.                                                                         | Kundengruppe des Kanals                              |
| Bestehende dynamische Produktgruppe verwenden (optional)                    | Nur nötig, wenn Sie eine eigene Gruppe nutzen wollen.                                                                                                                                             | Es wird automatisch eine neue Produktgruppe erstellt |
| Bestehenden Produktvergleichs-Verkaufskanal nutzen (optional), nur bei Pull | Nutzt Feed-Vorlage und Zugriffsschlüssel eines vorhandenen Kanals. Die übrigen Felder entfallen.                                                                                                  | keiner                                               |

Wechseln Sie den Verkaufskanal, werden Domain, Sprache, Währung und Kundengruppe neu vorbelegt. „Feed erstellen“ ist erst aktiv, wenn alle Pflichtfelder gefüllt sind. Eine Auswahl der Feed-Vorlage gibt es nicht, sie wird automatisch angelegt. Anpassen können Sie sie später über „Datenfelder bearbeiten“.

**Was bei Pull in Ihrem Shop entsteht:**

1. Ein Verkaufskanal vom Typ Produktvergleich mit Ihrem Namen.
2. Eine dynamische Produktgruppe „InsightSearch Feed“ mit Datum und Uhrzeit, die alle aktiven Produkte enthält (falls Sie keine eigene gewählt haben).
3. Ein Produkt-Export als XML-Datei, der von einer geplanten Aufgabe in Shopware erzeugt wird.
4. Die Registrierung bei InsightSearch. Dabei wird automatisch die Sprachzuordnung für den Kanal und die gewählte Sprache angelegt.

Shopware prüft danach die Feed-Vorlage. Ist sie fehlerhaft, wird der Feed nicht registriert und der schon angelegte Kanal bleibt ausgewählt. Ein erneuter Versuch legt keinen zweiten an.

Bei **Push** entsteht kein Verkaufskanal und kein Export. Es wird ein Push-Index angelegt und die Übertragung sofort gestartet. Schlägt der Start fehl, stoßen Sie ihn später über „Produktdaten neu einlesen“ an.

## Automatische Indexierung (nur Pull)

Im Feld **Automatische Indexierung (Uhrzeit)** legen Sie fest, wann die Quelle täglich neu eingelesen wird. Die Zeitzone steht daneben. Die Zeit wird gespeichert, sobald Sie das Feld verlassen („Uhrzeit wurde gespeichert.“). Die Indexierung startet innerhalb von 15 Minuten nach der eingestellten Uhrzeit. Lassen Sie das Feld leer, ist die automatische Indexierung aus. Die Karte zeigt die nächste Indexierung danach neu an.

Push-Quellen haben kein Zeitfeld.

## Dynamische Produktgruppe (nur Push)

Bei Push-Quellen wählen Sie im Feld **Dynamische Produktgruppe**, welche Produkte übertragen werden. „Bearbeiten“ öffnet die Gruppe in Shopware. Die Auswahl wird sofort gespeichert. Ohne Produktgruppe werden alle Produkte des Verkaufskanals übertragen.

## Fortschritt und Fehler

**Pull.** Während des Einlesens zeigt ein Balken „Wird synchronisiert …“, die Ansicht aktualisiert sich alle 5 Sekunden. Abbrechen können Sie einen Feed-Lauf nicht.

**Push.** Die Karte zeigt „Indexierung läuft …“ mit Anzahl, Prozent, geschätzter Restzeit und Produkten pro Sekunde. „Abbrechen“ beendet den Lauf nach einer Rückfrage. Gibt es 5 Minuten lang keinen Fortschritt, erscheint ein Hinweis, dass hängende Pakete automatisch neu eingereiht werden. Während der Übertragung gilt immer der Hinweis, dass die Hintergrundverarbeitung von Shopware dauerhaft laufen muss, sonst bleibt der Fortschritt stehen. Läuft sie gar nicht, gilt die Indexierung nach spätestens einer Stunde ohne Fortschritt als fehlgeschlagen und lässt sich neu starten.

**Bei einem Fehler.** Ein roter Kasten nennt die Ursache, bei Push mit dem Knopf „Neu starten“. Typische Meldungen sind „Es wurden keine passenden Produkte zum Indexieren gefunden.“, „Konfiguration unvollständig. Bitte Einrichtung prüfen.“ und „Die Synchronisation dieses Index ist derzeit gesperrt. Bitte wenden Sie sich an den Support.“ Bei Pull-Feeds erklärt ein Hilfeblock („Hilfe anzeigen“) die Ursache in einfachen Worten, nennt die Feed-Adresse und sagt, was Sie tun können.

{% content-ref url="/pages/6FkPYe3rryaW0kzcPtOe" %}
[Das Einlesen des Produktfeeds schlägt fehl](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/faq-and-haufige-probleme/das-einlesen-des-produktfeeds-schlagt-fehl.md)
{% endcontent-ref %}

## KI-Aufbereitung

Nach dem Einlesen bereiten wir die Daten für die KI-Funktionen auf. Solange das läuft oder falls es fehlschlägt, zeigt die Karte einen Balken „KI-Aufbereitung“ mit einer Liste der Schritte (ausstehend, läuft, fertig). Danach verschwindet der Balken. Schlägt sie fehl, steht dort: „KI-Aufbereitung fehlgeschlagen. Sie wird beim nächsten Abgleich erneut versucht.“ In der Übersicht steht in dieser Zeit, wie viele Indizes aufbereitet werden.

## Weiterlesen

{% content-ref url="/pages/TB60BMQ05uLv6epja2ky" %}
[Push und Live-Abgleich](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/push-und-live-abgleich.md)
{% endcontent-ref %}

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

{% content-ref url="/pages/1iPrVkK2dpXSZ3xUdbD5" %}
[Allgemeine Einstellungen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/allgemeine-einstellungen.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/einstellungen/indizes.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.
