> 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/installation-und-einrichtung.md).

# Installation und Einrichtung

Plugin installieren und den Einrichtungsassistenten Schritt für Schritt durchlaufen, bis die ersten Produkte in der Suche stehen.

Das Plugin installieren Sie wie jedes Shopware-Plugin. Danach führt Sie ein Einrichtungsassistent (Wizard) durch die Verbindung zu unserem Suchsystem, das Anlegen des Produkt-Feeds und das erste Einlesen der Produkte. Planen Sie dafür etwa eine halbe Stunde ein, bei großen Katalogen läuft das Einlesen anschließend im Hintergrund weiter.

{% hint style="info" %}
Wenn Sie die Ersteinrichtung nicht selbst vornehmen möchten, übernehmen wir sie gern im Rahmen einer einmaligen Einrichtung. Nehmen Sie dafür über das Shopware-Ticketsystem Kontakt mit uns auf. Dieser Hinweis steht auch oben im Wizard.
{% endhint %}

## Bevor Sie starten

Prüfen Sie auf der Seite [Voraussetzungen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/voraussetzungen.md), ob Ihr Shop bereit ist. Besonders wichtig: Bei Pull muss die Feed-Adresse von außen ohne Anmeldung erreichbar sein.

## Plugin installieren

1. Öffnen Sie in Shopware die Erweiterungsverwaltung (Erweiterungen → Meine Erweiterungen).
2. Installieren und aktivieren Sie das Plugin.
3. Leeren Sie bei Bedarf den Shopware-Zwischenspeicher.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-a75376ff033b9129caa1961ec5497964b956bd81%2Fimage.png?alt=media" alt="Plugin in der Erweiterungsverwaltung von Shopware"><figcaption></figcaption></figure>

Bei der Installation meldet das Plugin Ihren Shop automatisch bei unserem Suchsystem an. Dabei entsteht das **Installation Secret**, ein Zugangsschlüssel, der Ihre Installation eindeutig kennzeichnet. Das Plugin speichert ihn selbst in der Plugin-Konfiguration. Verändern Sie ihn nicht.

Das **Account Secret** fehlt zunächst. Es entsteht erst im Wizard, wenn Ihre Installation mit einem Account verbunden wird. Ein Account fasst mehrere Installationen zusammen, zum Beispiel Live, Stage und Entwicklung. Beide Schlüssel sehen Sie später in der Plugin-Konfiguration in der Karte „Globale Einstellungen“ (Felder „Account secret“ und „Installation secret“). Dort prüft der Knopf „Verbindung testen“, ob die Verbindung steht.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-5c8ffd90ed06f2220318f7b64745defed5e2d7bc%2Fimage.png?alt=media" alt="Plugin-Konfiguration mit Installation Secret, Account Secret und Knopf zum Wizard"><figcaption></figcaption></figure>

Das Plugin erreichen Sie danach auch über Inhalte → KI-gestützte Produktsuche. In der Plugin-Konfiguration führt der Knopf „Zum Einrichtungsassistenten“ zum Wizard.

### Wenn der Wizard gesperrt ist

Hat das automatische Speichern des Installation Secrets bei der Installation nicht geklappt, meldet der Wizard: „Der Einrichtungsassistent ist derzeit gesperrt, weil der Installationsschlüssel in dieser Shop-Installation fehlt.“ Klicken Sie dann auf „Installationsschlüssel erneut abrufen“. Sobald der Schlüssel gespeichert ist, lädt der Wizard neu und gibt sich frei.

Erscheint stattdessen eine Fehlermeldung, hilft meist Folgendes:

* Fehlen Shop-URL oder Instanz-ID, prüfen Sie die Einstellung `APP_URL` Ihres Shops.
* Heißt es, der Schlüssel konnte gerade nicht angefordert werden, versuchen Sie es in wenigen Minuten erneut.
* Bei der dritten Meldung prüfen Sie die Shop-Konfiguration und versuchen es erneut.

## Der Wizard Schritt für Schritt

Der Wizard heißt in der Kopfzeile „Ersteinrichtung“ und zeigt oben eine Fortschrittsleiste mit fünf Schritten: „Verbindungsart“, „Verbinden“, „Überprüfung“, „Produkte anbinden“ und „Produkte indizieren“.

Er erscheint, sobald Sie das Plugin-Dashboard zum ersten Mal öffnen, und die Seitenleiste ist währenddessen ausgeblendet. Ihr Stand wird im Browser gespeichert. Wenn Sie die Seite verlassen oder neu laden, geht es an derselben Stelle weiter. Das Einlesen der Produkte läuft im Hintergrund weiter, Sie können die Seite also jederzeit schließen.

### Schritt 1: Verbindungsart

Hier legen Sie fest, wie diese Shop-Installation mit InsightSearch verbunden wird. Es gibt zwei Wege:

* **„Neue Installation anlegen“:** Suche und Daten bleiben für diesen Shop getrennt. Das ist der Normalfall bei der ersten Einrichtung.
* **„Mit bestehender Installation verbinden“:** Sie nutzen einen vorhandenen Account weiter, zum Beispiel wenn Sie eine Stage-Umgebung neben Ihrem Live-Shop einrichten.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-0025bf2b759cb79152b1fc83cecc4aadd068f8e2%2Fimage.png?alt=media" alt="Wizard, Schritt Account anlegen oder verbinden"><figcaption></figcaption></figure>

### Schritt 2a: Neue Installation anlegen

Füllen Sie drei Felder aus. Der Knopf „Weiter“ wird erst aktiv, wenn alle gefüllt sind.

| Feld                       | Bedeutung                                                                                                                | Vorbelegung   |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------- |
| „Shop-Name“                | Ein Name, an dem Sie die Installation erkennen, zum Beispiel „Hauptshop Produktion“, „Staging Shop“ oder „DEV Umgebung“. | leer          |
| „Einsatz (dev/stage/live)“ | Wofür die Installation genutzt wird. Auswahl: „Entwicklung“, „Staging“, „Produktion“.                                    | „Entwicklung“ |
| „E-Mail“                   | Adresse für Mitteilungen bei kritischen Problemen rund um die Suche.                                                     | leer          |

{% hint style="warning" %}
Die Voreinstellung für „Einsatz“ ist „Entwicklung“. Wählen Sie für Ihren Live-Shop ausdrücklich „Produktion“.
{% endhint %}

Die E-Mail-Adresse verwenden wir ausschließlich, um Sie bei kritischen Problemen im Zusammenhang mit der Suche zu informieren. In den InsightSearch-Einstellungen legen Sie später fest, ob und an welche Adresse solche Mitteilungen gehen.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-5ee57403078d7bbb985e8d7c619c3d8bf0dab75a%2Fimage.png?alt=media" alt="Wizard, Schritt Account-Daten"><figcaption></figcaption></figure>

Mit „Weiter“ legt das Plugin die Installation an. Der Knopf „Zurück“ ist nur sichtbar, solange noch nichts verbunden wurde.

### Schritt 2b: Mit bestehender Installation verbinden

Sie sehen ein Feld „Account Secret“ und den Knopf „Verknüpfen“. Er wird aktiv, sobald das Feld gefüllt ist. Tragen Sie das Account Secret Ihres bestehenden Accounts ein. Sie finden es in der Plugin-Konfiguration einer bereits verbundenen Installation, Karte „Globale Einstellungen“, Feld „Account secret“.

Das Plugin speichert das Secret und prüft es anschließend. Wie Sie mehrere Installationen sinnvoll aufteilen, lesen Sie auf der Seite [Stage und Live](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/stage-und-live.md).

### Schritt 3: Überprüfung

Das Plugin prüft kurz die Verbindung („Wir prüfen kurz die Verbindung. Das dauert nur einen Moment.“). Bei Erfolg geht es automatisch weiter. Schlägt die Prüfung fehl, springt der Wizard zurück zu Schritt 2 und zeigt eine Fehlermeldung. Prüfen Sie dann Ihre Eingaben.

### Schritt 4: Produkte anbinden (Feed anlegen)

Das ist der wichtigste Schritt. Unser Suchsystem braucht Ihre Produkte. Hier legen Sie fest, wie sie zu uns kommen. Der Standard ist ein **Produkt-Feed**, ähnlich einem Google-Feed: Er wird in Shopware als Verkaufskanal vom Typ „Produktvergleich“ angelegt und erzeugt eine Export-Datei, die unser Suchsystem regelmäßig abholt. Ohne diesen Feed hat die Suche keine Produkte und liefert keine Ergebnisse.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-2054e6397e397a5880e6c3c10d14b7072609f80e%2Fimage.png?alt=media" alt="Wizard, Schritt Produkt-Feed anlegen"><figcaption></figcaption></figure>

Dieselbe Maske finden Sie später im Bereich „Quellen“ im Dialog „Weiteren Feed anlegen“.

**Indexierungsart (Pflicht):**

* **„Pull (Standard): InsightSearch holt den Produkt-Feed ab“.** Vorausgewählt. Unser Suchsystem ruft die Feed-Adresse regelmäßig ab, die Adresse muss deshalb von außen erreichbar sein (kein Passwortschutz, keine htaccess-Sperre).
* **„Push: Das Plugin sendet die Produkte (für DEV/Stage)“.** Nur für DEV- und Stage-Umgebungen gedacht, die von außen nicht erreichbar sind. Das Plugin sendet die Produkte selbst. Dafür muss die Hintergrundverarbeitung von Shopware laufen.

**Felder der Maske:**

| Feld                                                                          | Wirkung                                                                                                                                   | Vorbelegung                                             |
| ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| „Name“ (Pflicht)                                                              | Name für Produkt-Feed und zugehörigen Verkaufskanal, zum Beispiel „InsightSearch Produkt-Feed Hauptshop“.                                 | „InsightSearch Feed“                                    |
| „Storefront-Verkaufskanal“ (Pflicht)                                          | Nur Produkte aus diesem Kanal gehen an die Suche. Zulässig sind nur Storefront-Kanäle.                                                    | keine, Auswahl aus Ihren Verkaufskanälen                |
| „Storefront-Domain“ (Pflicht)                                                 | Domain, über die der Export für uns erreichbar ist, in der Regel die Hauptdomain. Erst wählbar, wenn ein Verkaufskanal gewählt ist.       | Hat der Kanal genau eine Domain, ist sie vorausgewählt. |
| „Sprache“ (Pflicht)                                                           | Sprache der Texte im Feed. Zur Auswahl stehen nur Sprachen des Kanals. Die Suche lässt sich später auch in anderen Shop-Sprachen nutzen.  | Standardsprache des Kanals                              |
| „Währung“ (Pflicht)                                                           | Währung aller Preise im Feed. Nur Währungen des Kanals.                                                                                   | Währung des Kanals                                      |
| „Kundengruppe“ (Pflicht)                                                      | Auf dieser Basis wenden Sie Preis- und Sichtbarkeitsregeln (Rule Builder) an, damit der Feed die gleichen Konditionen nutzt wie der Shop. | Kundengruppe des Kanals                                 |
| „Bestehende dynamische Produktgruppe verwenden (optional)“                    | Nur wählen, wenn Sie eine eigene Produktgruppe nutzen möchten.                                                                            | „Automatisch neue Produktgruppe erstellen“              |
| „Bestehenden Produktvergleichs-Verkaufskanal nutzen (optional)“, nur bei Pull | Nutzt Feed-Vorlage und Zugangsschlüssel eines vorhandenen Kanals. Die übrigen Felder entfallen.                                           | leer                                                    |

Wechseln Sie den Verkaufskanal, werden Domain, Sprache, Währung und Kundengruppe zurückgesetzt und neu vorbelegt.

Eine Auswahl der Feed-Vorlage gibt es nicht, sie wird automatisch angelegt. Welche Datenfelder sie enthält, passen Sie später mit „Datenfelder bearbeiten“ an (siehe [Datenfelder bearbeiten](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/feed-template-editor.md)).

Mit „Feed erstellen“ starten Sie das Anlegen. Der Knopf wird aktiv, sobald alle Pflichtfelder gefüllt sind.

**Was dabei im Shop entsteht (Pull):**

* Ein neuer, aktiver Verkaufskanal vom Typ „Produktvergleich“ mit Ihrem Namen. Zahlungsart, Versandart, Land und Navigation übernimmt er aus dem Storefront-Kanal.
* Eine dynamische Produktgruppe „InsightSearch Feed“ mit Datum und Uhrzeit im Namen. Der Filter lautet „Aktiv = ja“. Haben Sie eine eigene Gruppe gewählt, wird keine neue angelegt.
* Ein Produktexport im Format XML (UTF-8), der Varianten einschließt und per geplanter Aufgabe erzeugt wird.
* Die Feed-Adresse, aufgebaut aus Ihrer Domain und dem Zugangsschlüssel des Exports. Sie sehen sie später im Bereich „Quellen“ und im Produktvergleichs-Kanal unter „Export-URL“.
* Eine automatische Sprachzuordnung für den gewählten Verkaufskanal und die gewählte Sprache.

Shopware prüft die Vorlage vor dem Registrieren. Ist sie fehlerhaft, erscheint: „Der Produktvergleichs-Verkaufskanal wurde angelegt, aber die Feed-Vorlage ist fehlerhaft. Der Feed wurde deshalb nicht registriert. Prüfe die Vorlage im Verkaufskanal.“ Lässt sich die Vorlage nur nicht prüfen, wird der Feed trotzdem angelegt und Sie sehen einen Hinweis.

{% hint style="info" %}
Schlägt ein Anlegen nach dem Erstellen des Kanals fehl, bleibt der Kanal erhalten. Er ist dann unter „Bestehenden Produktvergleichs-Verkaufskanal nutzen“ vorausgewählt, und ein erneuter Versuch verwendet ihn weiter, statt einen zweiten anzulegen.
{% endhint %}

**Bei Push** entsteht kein Verkaufskanal und kein Export. Das Plugin legt stattdessen einen Push-Index an („Push-Index angelegt, die Produkte werden jetzt übertragen.“) und startet die Übertragung sofort. Klappt der Start nicht, steht dort: „Die automatische Indexierung konnte nicht gestartet werden. Du kannst sie später manuell im Dashboard anstoßen.“ Ohne dynamische Produktgruppe werden alle Produkte des Verkaufskanals übertragen.

### Schritt 5: Produkte indizieren und Abschluss

Der Feed wird nun verarbeitet. Zuerst prüft unser Suchsystem Erreichbarkeit und Vollständigkeit, dann werden die Produkte ausgewertet, die Datenqualität wird geprüft und der Feed wird für die Suche aufbereitet. Erst danach steht er der Suche zur Verfügung. Das dauert je nach Produktzahl.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-e6da4ec33283c2de42110c2e72d9dcc4b92a5163%2Fimage.png?alt=media" alt="Wizard, letzter Schritt mit erster Indexierung"><figcaption></figcaption></figure>

Sie sehen drei Prüfpunkte mit dem Status „Ausstehend“ oder „Abgeschlossen“: „Überprüfung“, „Qualitätskontrolle“ und „Indexiert“. Dazu zeigt der Wizard, wie lange der Lauf schon dauert („Läuft seit“) und wann zuletzt aktualisiert wurde. Die Anzeige aktualisiert sich alle paar Sekunden von selbst.

Bei Push zeigt ein Balken zusätzlich „Produkte übertragen“ mit Anzahl, Prozent und geschätzter Restzeit. Läuft die Hintergrundverarbeitung von Shopware nicht, bleibt dieser Balken stehen.

Der Wizard warnt in diesen Fällen, bricht aber nicht ab:

* Push ohne Fortschritt seit über 10 Minuten.
* Eine Feed-Indexierung, die länger als 30 Minuten läuft. Bei sehr großen Katalogen kann das normal sein.
* Der Status war mehrfach nicht abrufbar. Die Indexierung läuft dann möglicherweise trotzdem weiter.

Bei Warnungen und Fehlern gibt es einen Bereich „Technische Details“, den Sie unserem Support zeigen können.

**Abschluss:** Ist die Indexierung fertig, schaltet der Wizard die Suche selbst ein (Schalter „Suche aktivieren“ in der Plugin-Konfiguration) und schließt sich. Danach sehen Sie das normale Plugin-Dashboard mit der Übersicht.

## Wenn das Einlesen fehlschlägt

Schlägt die Indexierung fehl, zeigt der Wizard eine rote Karte „Indexierung fehlgeschlagen“. Bei Pull mit erkannter Ursache erscheint darunter ein Hilfeblock mit:

* dem Titel der Fehlerart und, wenn bekannt, dem „HTTP-Status“,
* der Feed-Adresse mit dem Link „Feed im Browser öffnen“,
* den Listen „Das kann die Ursache sein“ und „Das kannst du tun“,
* dem Hinweis für Stage- und Testsysteme: Sie sind oft mit Passwort, IP-Sperre oder interner Domain geschützt. Unser Suchsystem ruft den Feed über das Internet ab, die Adresse muss deshalb öffentlich und ohne Anmeldung erreichbar sein.

Im Bereich „Quellen“ steht derselbe Block eingeklappt hinter „Hilfe anzeigen“.

### Ursachen und was Sie tun können

| Meldung                                               | Häufige Ursachen                                                                                                               | Was Sie tun können                                                                                                                                                                  | Automatisch wiederholt |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| „Der Feed ist durch eine Anmeldung geschützt“         | Passwortschutz oder Basic Auth, IP-Sperre oder Firewall, Bot-Schutz (zum Beispiel Cloudflare)                                  | Feed-Adresse im privaten Browserfenster öffnen, sie muss ohne Anmeldung laden. Adresse vom Schutz ausnehmen oder unseren Abruf freigeben (User-Agent „CogiInsightSearch-Feed/1.0“). | nein                   |
| „Der Zugriff auf den Feed wird verweigert“            | wie oben                                                                                                                       | Adresse öffentlich machen, Abruf mit dem User-Agent „CogiInsightSearch-Feed/1.0“ in Firewall oder Bot-Schutz freigeben.                                                             | nein                   |
| „Der Feed wurde unter dieser Adresse nicht gefunden“  | Produktexport gelöscht oder deaktiviert, Zugangsschlüssel geändert, falsche Domain (zum Beispiel nach Umzug oder Stage-Kopie)  | In Shopware unter Marketing → Produktvergleich prüfen, ob der Export aktiv ist. Adresse im Browser öffnen. Bei Bedarf Feed im Wizard neu anlegen.                                   | nein                   |
| „Der Shop ist im Wartungsmodus“                       | Wartungsmodus für Shop oder Verkaufskanal                                                                                      | Wartungsmodus beenden oder die Feed-Adresse davon ausnehmen.                                                                                                                        | ja                     |
| „Der Shop hatte einen Fehler beim Erzeugen des Feeds“ | Fehler im Shop, sehr großer Katalog                                                                                            | Shopware-Log (var/log) prüfen, Adresse im Browser öffnen. Bei großen Katalogen im Produktexport „Im Hintergrund generieren“ einschalten.                                            | ja                     |
| „Zu viele Abrufe in kurzer Zeit“                      | Shop oder Suchsystem drosselt kurzzeitig                                                                                       | Kurz warten.                                                                                                                                                                        | ja                     |
| „Der Feed hat zu lange gebraucht“                     | Erzeugung dauert zu lange, Shop ausgelastet                                                                                    | Im Produktexport „Im Hintergrund generieren“ mit passendem Intervall einstellen, später erneut versuchen.                                                                           | ja                     |
| „Die Domain des Feeds ist nicht erreichbar“           | Domain nicht öffentlich auflösbar (lokale oder interne Stage-Domain), falsch geschrieben, nicht eingerichtet                   | Öffentlich erreichbare Domain für den Kanal nutzen, Domain des Verkaufskanals prüfen.                                                                                               | nein                   |
| „Der Server lehnt die Verbindung ab“                  | Webserver nicht erreichbar oder nicht gestartet, Firewall                                                                      | Erreichbarkeit von außen prüfen, in der Firewall freigeben.                                                                                                                         | ja                     |
| „Das SSL-Zertifikat ist nicht gültig“                 | abgelaufen, ungültig, passt nicht zur Domain, selbst signiert                                                                  | Gültiges Zertifikat einrichten (zum Beispiel Let’s Encrypt), dann erneut versuchen.                                                                                                 | nein                   |
| „Der Feed ist kein gültiges XML“                      | Antwort ist HTML oder abgeschnitten, Vorlage verändert                                                                         | Adresse im Browser prüfen. Feed im Wizard neu anlegen, damit die richtige Vorlage genutzt wird.                                                                                     | nein                   |
| „Der Feed enthält keine Produkte“                     | Kanal ohne Produkte, Produkte nicht sichtbar oder nicht aktiv, Filter im Export (zum Beispiel Lagerbestand) schließt alles aus | Verkaufskanal, Sichtbarkeit und dynamische Produktgruppe prüfen.                                                                                                                    | nein                   |
| „Der Feed konnte nicht geladen werden“                | Auffangfall, wenn keine genaue Ursache erkannt wurde                                                                           | Adresse im Browser öffnen, erneut versuchen. Bleibt der Fehler, hilft der Support.                                                                                                  | ja                     |

Weitere Hilfe finden Sie unter [Produkt-Feed Einlesen 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) und in der [Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md).

### Automatische Wiederholung

Bei Ursachen, die sich durch Warten erledigen können, versucht der Wizard es bis zu dreimal selbst, nach 30, 60 und 120 Sekunden. Sie sehen einen Countdown („Wir versuchen es in {Sekunden} Sekunden automatisch noch einmal (Versuch {n} von 3).“) und die Knöpfe „Jetzt erneut versuchen“ und „Automatisch wiederholen stoppen“.

* Nach „Stopp“ gilt: „Automatisches Wiederholen ist gestoppt. Du kannst es jederzeit selbst erneut versuchen.“
* Nach drei Versuchen wiederholt der Wizard nicht mehr von selbst und bittet Sie, die Hinweise zu prüfen.
* Bei Ursachen, die durch Warten nicht verschwinden, steht: „Dieser Fehler geht durch Warten nicht weg. Prüfe die Hinweise und versuche es danach erneut.“

Der Knopf „Erneut versuchen“ ist immer da, wenn kein Countdown läuft. Ein Push wird nie automatisch wiederholt, nur von Hand.

## Was der Wizard im Shop anlegt

Zusammengefasst:

| Bei Pull                                                              | Bei Push                                             |
| --------------------------------------------------------------------- | ---------------------------------------------------- |
| Verkaufskanal „Produktvergleich“ mit Zugangsschlüssel                 | kein Verkaufskanal                                   |
| Dynamische Produktgruppe mit Filter „Aktiv = ja“ (oder Ihre gewählte) | Ihre gewählte Gruppe, sonst alle Produkte des Kanals |
| Produktexport (XML) mit der Feed-Adresse                              | kein Export, das Plugin sendet die Produkte          |
| Automatische Sprachzuordnung                                          | Automatische Sprachzuordnung                         |

Außerdem schaltet der Wizard am Ende die Suche ein. Beim Installieren legt das Plugin außerdem zwei Zusatzfelder und die Sortierung „Empfehlung“ an. Die Sortierung erscheint für Besucher im Sortier-Auswahlfeld, Sie können sie in Shopware anpassen oder deaktivieren.

## Was Sie danach tun

In den meisten Fällen liefert die Suche jetzt schon erste Ergebnisse. Für die gute Qualität lohnen sich noch ein paar Schritte, zum Beispiel Sprachen zuordnen, Filter einrichten und die Suche testen. Die Reihenfolge finden Sie auf der Seite [Erste Schritte](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/erste-schritte.md).

## Weiterlesen

{% content-ref url="/pages/GYNTy0uL33CV3MtEyjfm" %}
[Erste Schritte](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/erste-schritte.md)
{% endcontent-ref %}

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

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

{% 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 %}


---

# 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/installation-und-einrichtung.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.
