> 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/ki-funktionen.md).

# KI-Funktionen

Hybride Suche, KI-Aufbereitung, Synonym-Vorschläge und Insight-Analyse einschalten, einstellen und verstehen.

Der Bereich **KI** im Plugin-Dashboard bündelt die Funktionen, die Ihre Suche um Bedeutung und Lernen aus echten Kundendaten erweitern. Sie öffnen ihn in der Seitenleiste in der Gruppe „Produkte & Daten“. Die Seite heißt „KI-Funktionen“ und hat die Reiter „Einstellungen“, „Vorschau“, „Synonym-Vorschläge“ (Beta) und, sobald die Insight-Analyse eingeschaltet ist, „Insight-Analyse“.

Unter „Was steuert dieser Tab?“ steht die Kurzfassung: Hier schalten Sie die KI-Funktionen Ihrer Shop-Suche ein und stellen sie ein. Unter „Vorschau“ testen Sie jede Einstellung, bevor Sie sie im Shop aktivieren.

## Überblick

| Funktion           | Wofür                                                                        | Stand |
| ------------------ | ---------------------------------------------------------------------------- | ----- |
| Hybride Suche      | Ergänzt die wortgenaue Suche um eine Suche nach Bedeutung.                   | Beta  |
| KI-Aufbereitung    | Bereitet Ihre Produkte einmalig dafür auf. Voraussetzung der hybriden Suche. |       |
| Synonym-Vorschläge | Die KI schlägt Synonyme vor, die Sie mit einem Klick übernehmen.             | Beta  |
| Insight-Analyse    | Wertet Klicks, Warenkorb, Bestellungen und Suchanfragen täglich aus.         | Beta  |

Dazu kommen Funktionen, die Sie an anderer Stelle einstellen: „Verwandte Treffer“ („Das könnte auch passen“), Ersatzprodukte und die Rettung bei null Treffern (siehe [Keine Treffer](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/keine-treffer.md)) sowie der [Shopping-Assistent](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/shopping-assistent.md) (Beta) mit eigener Seite.

## Die Kacheln im Reiter „Einstellungen“

Oben zeigen vier Kacheln den Stand auf einen Blick:

* **„KI-Aufbereitung“:** Prozent und „x von y Produkten“. Solange der Wert nicht bekannt ist, steht „wird ermittelt“, bei einer Störung „gestört“ mit dem Hinweis „Wir kümmern uns darum.“
* **„Hybride Suche“:** „Aktiv“ (mit „Anteil Bedeutung …“) oder „Inaktiv“.
* **„Offene Synonym-Vorschläge“:** Anzahl offener Vorschläge und wie viele bisher übernommen wurden.
* **„Status Hybride Suche“:** „Verfügbar“, „Eingeschränkt“, „Gestört“ oder „Pausiert“, jeweils mit kurzer Erklärung. Bei „Gestört“ übernimmt automatisch die normale Suche.

## Hybride Suche (Beta)

Die normale Suche vergleicht Wörter. Die hybride Suche versteht zusätzlich, was gemeint ist. Das Beispiel aus dem Plugin: Wer „gemütliches Sofa“ sucht, findet auch die „Couch mit weichem Bezug“. Beide Ergebnisarten werden gemischt.

### Einschalten, Schritt für Schritt

1. Warten Sie, bis die „KI-Aufbereitung“ 100 % erreicht hat. Vorher ist der Schalter gesperrt („Einschaltbar, sobald die KI-Aufbereitung 100 % erreicht hat.“). Der Fortschrittsbalken aktualisiert sich alle 10 Sekunden.
2. Schalten Sie „Hybride Suche“ (Beta) ein. Standard ist aus.
3. Stellen Sie bei Bedarf den Regler „Anteil Bedeutung“ ein und klicken Sie auf „Speichern“. „Standard“ setzt den Regler zurück, „In der Vorschau ansehen“ springt in den Reiter „Vorschau“.

Der Schalter selbst speichert den zuletzt gespeicherten Anteil mit. Änderungen am Regler übernimmt nur „Speichern“.

### Anteil Bedeutung

Der Regler reicht von „wortgenau“ bis „bedeutungsbasiert“, von 10 % bis 60 % in 5-%-Schritten.

| Suchmodus  | Standard-Anteil Bedeutung               |
| ---------- | --------------------------------------- |
| Standard   | 30 %                                    |
| Explorativ | 50 %                                    |
| Präzise    | keiner, es wird immer wortgenau gesucht |

Ist die hybride Suche aus, ist der Regler gesperrt. Testen können Sie den Anteil trotzdem in der Vorschau.

### Wann die Bedeutungssuche nicht greift

In diesen Fällen sucht das System normal weiter, Ihre Kunden sehen dabei keine Fehlermeldung:

* Eingaben, die wie Artikelnummern aussehen.
* Sortierung anders als „Relevanz“.
* Suchmodus „Präzise“.
* Leere Suche.
* Sehr tiefes Blättern.
* Wenn die Bedeutungssuche vorübergehend nicht verfügbar ist.

Die Beta-Hinweise im Plugin sagen dazu: Die Funktion kann vorübergehend nicht oder nur eingeschränkt verfügbar sein. Dann springt automatisch die normale Suche ein. Ihre Kunden bekommen immer Suchergebnisse, Fehler in der Suche entstehen dadurch nicht. Bei Störungen kann die Funktion automatisch oder von uns vorübergehend pausiert werden. Der Status zeigt dann „Pausiert“.

{% hint style="info" %}
Die Funktion befindet sich in der kostenfreien Beta-Phase und kann jederzeit ein- oder ausgeschaltet werden.
{% endhint %}

## Reiter „Vorschau“

Unter „So findet Ihre Suche mit KI“ vergleichen Sie, was die Bedeutungssuche ändert:

1. Geben Sie einen Suchbegriff ein und klicken Sie auf „Vergleichen“.
2. Links steht „Nur Textsuche“, rechts „Hybride Suche (x % Bedeutung)“, je 12 Treffer.
3. Die Markierung „neu“ zeigt Treffer, die nur rechts vorkommen. Die Pfeile ▲ und ▼ zeigen die Rangänderung.

Die Vorschau funktioniert auch bei ausgeschalteter hybrider Suche und mit Reglerwerten, die Sie noch nicht gespeichert haben. Probieren Sie Begriffe, die nicht wörtlich in Ihren Produkttexten stehen. Dort zeigt sich der Unterschied am deutlichsten. Kann die Bedeutungssuche für eine Anfrage nicht angewendet werden, steht ein Warnhinweis und rechts die Textsuche.

## KI-Aufbereitung

Für die Bedeutungssuche wird jedes Produkt einmal aus seinen Daten aufbereitet. Das passiert bei uns, nicht in Ihrem Shop. Im Plugin sehen Sie den Fortschritt als „KI-Aufbereitung“ mit Prozent und Produktzahl. Fertig ist sie bei 100 %.

* Eine feste Dauer lässt sich nicht nennen. Sie hängt von der Zahl Ihrer Produkte ab.
* Solange die Aufbereitung läuft, steht der Hinweis, dass Ergebnisse noch nicht die volle Qualität haben.
* Schlägt sie fehl, steht dort „KI-Aufbereitung fehlgeschlagen. Sie wird beim nächsten Abgleich erneut versucht.“

## Synonym-Vorschläge (Beta)

Statt Synonyme selbst zu sammeln, lassen Sie sich Vorschläge machen. Unter „Woher kommen die Vorschläge?“ erklärt das Plugin zwei Quellen:

* **„Aus Produktdaten“:** Produkte mit gleicher Bedeutung, die unterschiedlich benannt sind, zum Beispiel „Sneaker“ und „Turnschuh“.
* **„Aus Suchverhalten“:** Suchanfragen mit gleicher Bedeutung, nach denen Kunden dieselben Produkte anklicken. Ausgewertet werden die letzten 30 Tage.

Die Vorschläge werden jede Nacht neu ermittelt. Mit „Jetzt ermitteln“ starten Sie die Ermittlung sofort, höchstens einmal pro Stunde. Voraussetzung ist die abgeschlossene KI-Aufbereitung. Der Status zeigt zum Beispiel „Ermittlung läuft …“ oder „Letzte Ermittlung abgeschlossen“ mit Datum und Zahl der neuen Vorschläge.

### Vorschläge bearbeiten

1. Öffnen Sie den Reiter „Synonym-Vorschläge“. Das Symbol am Reiter zeigt die Zahl offener Vorschläge.
2. Die Liste zeigt bis zu 100 der sichersten Vorschläge, je mit den Begriffen, der Herkunft („aus Produktdaten“ oder „aus Suchverhalten“) und „x % sicher“.
3. Wählen Sie einzelne Begriffe per Haken ab, wenn einer nicht passt. Mindestens zwei Begriffe müssen übrig bleiben.
4. Klicken Sie auf „Übernehmen“ oder „Ablehnen“.

Übernommene Vorschläge landen in Ihren [Synonymen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/synonyme.md) und wirken nach wenigen Minuten in der Suche. Gibt es nichts zu tun, steht dort „Keine offenen Vorschläge.“

## Insight-Analyse (Beta)

Die Insight-Analyse lernt aus dem, was in Ihrem Shop passiert. Sie schalten sie im Reiter „Einstellungen“ ein. Beim Einschalten startet sofort eine erste Auswertung, danach läuft sie jede Nacht. Mit „Jetzt auswerten“ starten Sie sie von Hand, höchstens einmal pro Stunde.

Ausgewertet werden Bestellungen, Klicks auf Suchergebnisse, Warenkorb-Aktionen und Suchanfragen. Stornierte und unbezahlte Bestellungen zählen nicht mit. Daraus entstehen:

* **Beliebtheit je Produkt (0 bis 100):** Sie entsteht aus Klicks, Warenkorb und Bestellungen der letzten 30 Tage. Bei gleich guten Treffern stehen beliebte Produkte weiter oben.
* **Suchvorschläge:** Die Vorschläge beim Tippen lernen aus echten Suchen.
* **Bestseller und Trends:** Bestseller der letzten 7, 30 und 90 Tage und insgesamt, dazu Trend-Suchbegriffe der letzten 7 Tage gegenüber den 7 davor. Nützlich für Synonyme, Landingpages und Kampagnen.

Im Reiter „Insight-Analyse“ sehen Sie den Status der Verarbeitung, die nächste automatische Auswertung, Kacheln wie „Verkaufte Artikel (30 Tage)“, „Umsatz der Artikel (30 Tage)“, „Produkte mit Beliebtheit“ und „Trends (7 Tage)“ sowie die Liste „Bestseller“. Gab es in den letzten 30 Tagen keine Besucherdaten, bleibt die Beliebtheit unverändert.

## Kontingent und Grenzen

* Hybride Suche, Synonym-Vorschläge und Insight-Analyse sind in der kostenfreien Beta-Phase. Im KI-Bereich gibt es dafür kein eigenes Kontingent.
* Anteil Bedeutung: höchstens 60 %.
* Hybride Suche nicht bei Artikelnummern, nicht bei Sortierung außer „Relevanz“, nicht im Modus „Präzise“.
* Ermittlung der Synonym-Vorschläge und Insight-Auswertung von Hand: höchstens einmal pro Stunde.
* Allgemein gibt es ein Kontingent für „Suchanfragen“. Bei Überschreiten gibt es keine automatische Sperre, wir melden uns bei starker Überschreitung.

## Weiterlesen

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

{% content-ref url="/pages/d5mIc2dVZOIZDCZQW1u1" %}
[Produkte im Dashboard](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/produkte-im-dashboard.md)
{% endcontent-ref %}

{% content-ref url="/pages/EFhYbJhqfikKs7df9Kz1" %}
[Keine Treffer](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/keine-treffer.md)
{% endcontent-ref %}

{% content-ref url="/pages/ygPmevhI5XOJUeRPfFTy" %}
[Shopping-Assistent (Beta)](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/shopping-assistent.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/ki-funktionen.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.
