> 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/suche-im-shop.md).

# Die Suche im Shop

Wie die Suche in Ihrem Shop aussieht und sich verhält: Aktivierung, Such-Fenster, Vorschläge, Treffer, Layouts, Produktkarte, Filter und Tastatur.

Diese Seite beschreibt die Suche aus Sicht Ihrer Kunden. Sie zeigt, was ein Besucher sieht und bedienen kann, und nennt bei jedem Punkt die Einstellung, mit der Sie es steuern. Alle Einstellungen finden Sie in der Plugin-Konfiguration auf der Karte „Sucheinstellungen“ und können je Verkaufskanal gepflegt werden.

## Wann die Suche im Shop aktiv ist

Das Such-Fenster von InsightSearch erscheint nur, wenn zwei Dinge zutreffen:

1. „Suche aktivieren“ ist eingeschaltet (Standard: aus).
2. Für die Kombination aus Verkaufskanal und Sprache ist ein Suchindex zugeordnet (Zuordnung im Plugin-Dashboard unter „Sprachzuordnung“).

Fehlt die Zuordnung für eine Sprache, bleibt in dieser Sprache die Shopware-Suche unverändert, ohne Meldung. Das gilt auch beim Layout „Natives Shopware-Design“: Dann gibt es kein Such-Fenster des Plugins, die Treffer kommen aber von InsightSearch (siehe unten bei den Layouts).

## Aktivierungsmodi

Mit „Aktivierungsmodus der Suche“ legen Sie fest, wie sich das Such-Fenster öffnet. Standard ist „Shopware Standard Suchfeld nutzen“.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-28ddd0e7332e8109b4ecbe1f1a38b23ee98f9dca%2Fimage.png?alt=media" alt="Auswahl des Aktivierungsmodus der Suche"><figcaption></figcaption></figure>

| Modus                               | Was passiert                                                                                                                                                                                               | Wann sinnvoll                                                                        |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| „Shopware Standard Suchfeld nutzen“ | Das Plugin hängt sich an das Suchfeld in der Kopfzeile Ihres Themes. Das Fenster öffnet sich, sobald der Kunde in das Feld klickt oder tippt. Shopwares eigenes Vorschlagsfenster wird dabei abgeschaltet. | Normalfall, wenn Ihr Theme ein normales Suchfeld hat.                                |
| „Suchfeld immer sichtbar“           | Das Plugin erzeugt ein eigenes Suchfeld mit Lupen-Knopf. Es öffnet sich beim Klicken oder Tippen wie im Standardmodus.                                                                                     | Wenn das Theme kein passendes Suchfeld mitbringt.                                    |
| „Aktivierung über externen Trigger“ | Das Fenster öffnet sich, wenn der Kunde auf ein Element klickt, das Sie über den „Trigger-Selector“ benennen.                                                                                              | Wenn das Theme die Suche anders aufbaut, zum Beispiel mit einem eigenen Such-Symbol. |
| „Aktivierung über Such-Button“      | Wie der Standardmodus, zusätzlich öffnet ein Klick auf die Lupe das Fenster, statt das Formular abzuschicken.                                                                                              | Für Themes, in denen das Suchfeld nicht dauerhaft auf der Seite liegt.               |

### Der externe Trigger

Im Feld „Trigger-Selector“ tragen Sie einen CSS-Selektor ein, also die Kennzeichnung des Elements, das die Suche öffnen soll. Vor einen Klassennamen gehört ein Punkt, vor eine ID eine Raute, zum Beispiel `.mein-suchknopf` oder `#suche-oeffnen`.

* Ein Klick auf das Element öffnet das Fenster und setzt den Cursor ins Suchfeld. Die eigentliche Aktion des Elements (zum Beispiel ein Link) wird dabei unterdrückt.
* Ein weiterer Klick auf den Trigger schließt das Fenster wieder.
* Auch Trigger, die erst später nachgeladen werden, funktionieren.
* Bleibt das Feld leer, öffnet sich nichts.

### Was bei Enter passiert

Das hängt von zwei Schaltern im Bereich „Suchergebnisseite und Varianten“ ab:

* **Beide aus (Standard):** Enter lässt die Treffer im Fenster stehen. Unter der Mindestzeichenzahl erscheint ein Hinweis, bei leerem Feld der Leer-Zustand. Gibt es für den Begriff eine Weiterleitung aus den Suchbegriff-Regeln, wird weitergeleitet.
* **„Weiterleitung zur Shopware-Suchergebnisseite per Enter erlauben“ oder „Shopware-Suchergebnisseite durch InsightSearch beliefern“:** Enter öffnet die Suchergebnisseite von Shopware. Ist mit den Pfeiltasten ein Eintrag markiert, wird stattdessen dieser geöffnet.

Mehr zur Suchergebnisseite lesen Sie unter [Suchergebnisseite](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suchergebnisseite.md).

## Aufbau des Such-Fensters

Das Fenster füllt den Bildschirm. Der Hintergrund ist abgedunkelt, die Seite dahinter scrollt nicht mehr. Von oben nach unten sieht der Kunde:

1. **Kopf:** Suchfeld mit Kreuz (löscht den Text) und Lupe, daneben der Schließen-Knopf. Ab 768 Pixel Breite steht links das Logo Ihres Shops.
2. **Vorschläge:** Überschrift „Vorschläge“ mit Auswahl-Knöpfen, ein Knopf je Vorschlagsbegriff.
3. **Aktive Filter:** nur wenn Filter gewählt sind, mit „×“ und dem Link „Zurücksetzen“.
4. **Inhalt:** links die Filter-Seitenleiste „Filter“ (ab 992 Pixel Breite), rechts die Treffer. Ohne aktivierte Filter nehmen die Treffer die ganze Breite.
5. **Treffer:** Überschrift wie „Produkte (128 Treffer)“, darunter die Produktkarten im gewählten Layout.
6. **Ende:** der Knopf „Weitere Ergebnisse laden“, danach gegebenenfalls „Passt zu …“ und „Das könnte auch passen“.

### Schließen

Das Fenster schließt sich mit dem Schließen-Knopf, mit der Taste Esc, mit einem Klick auf den abgedunkelten Rand und wenn der Fokus aus dem Fenster wandert, etwa durch einen Klick auf ein anderes Element der Seite. Der Text im Suchfeld bleibt dabei erhalten.

{% hint style="info" %}
Cookie-Banner, Chat-Fenster und andere Pop-ups, die beim Laden den Fokus an sich ziehen, können ein offenes Such-Fenster schließen. Wenn das bei Ihnen auffällt, prüfen Sie diese Elemente zuerst.
{% endhint %}

### Eingabe und Mindestzeichenzahl

Vorschläge erscheinen schon ab 1 Zeichen. Die Produkttreffer erscheinen ab der „Mindestanzahl an Zeichen für die Suche“ (Standard 3, kleinster Wert 1). Liegt die Eingabe darunter, steht im Treffer-Bereich „Bitte mindestens 3 Zeichen eingeben.“ (mit Ihrer eingestellten Zahl). „Beliebte Suchen“ und „Zuletzt gesucht“ umgehen diese Sperre.

Dauert eine Anfrage länger als 8 Sekunden, erscheint „Fehler beim Laden der Ergebnisse.“ Der Rest der Seite bleibt benutzbar.

## Der Leer-Zustand

Öffnet der Kunde die Suche, ohne etwas einzugeben, zeigt das Fenster:

* **„Zuletzt gesucht“** (mit Uhr-Symbol): höchstens 3 Begriffe aus diesem Browser-Tab, sofort sichtbar. Über „Verlauf ausblenden“ verschwindet die Liste für diesen Tab.
* **„Beliebte Suchen“:** bis zu 10 Begriffe, die bei Ihnen oft gesucht werden. Gibt es keine zuletzt gesuchten Begriffe, heißt die Überschrift „Vorschläge“.

Gibt es nichts zu zeigen, bleibt das Fenster bei einem Klick in das leere Feld geschlossen, damit nicht ein leeres Vollbild-Fenster hängt. Wird es durch Enter, die Lupe oder einen Trigger erzwungen, steht dort „Bitte geben Sie einen Suchbegriff ein.“

Wollen Sie den leeren Zustand selbst gestalten, wählen Sie bei „CMS-Seite für leeren Suchzustand“ eine Erlebniswelt. Sie erscheint im Fenster, die Begriffe stehen dazu. Mit einer gewählten Seite öffnet sich das Fenster auch dann, wenn es keine Begriffe gibt. Gut geeignet sind kompakte Banner, Einstiege in Kategorien, Aktionen oder ein Bestseller-Slider. Mehr dazu unter [Erlebniswelten und Empfehlungen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/erlebniswelten-und-empfehlungen.md).

## Vorschläge

Die Vorschläge erscheinen als Auswahl-Knöpfe über den Treffern. Die Anzahl stellen Sie mit „Anzahl Suchvorschläge“ ein (1 bis 10, Standard 5).

* Jedes eingegebene Wort (ab 2 Zeichen) wird im Vorschlag fett markiert.
* Erkennt das System einen Tippfehler, erscheint die Korrektur als zusätzlicher Vorschlag in der Akzentfarbe.
* Ein Klick auf einen Vorschlag setzt ihn ins Feld und startet die Suche. Manche Vorschläge bringen einen Filter mit, zum Beispiel eine Marke. Er wird dann direkt gesetzt, sofern Filter aktiviert sind.

## Treffer und Nachladen

Die Anzahl der Treffer je Abruf stellen Sie mit „Anzahl Suchergebnisse (pro Seite)“ ein (Standard 12). Die Überschrift zeigt die Gesamtzahl.

Ist „Pagination für Suchergebnisse aktivieren“ an (Standard), steht unten der Knopf „Weitere Ergebnisse laden“. Beim Laden steht dort „Lade Ergebnisse...“, am Ende „Keine weiteren Ergebnisse“. Nachgeladene Treffer werden angehängt, Suchbegriff, Filter und Scrollposition bleiben. Ist die Option aus, sehen Kunden nur die erste Seite. Im Karussell gibt es keinen Knopf, dort lädt das Fenster beim Wischen zum rechten Ende nach.

## Layouts

Das „Layout der Suchergebnisse“ bestimmt, wie die Produkte angeordnet sind. Standard ist „Raster mit detaillierten Karten (Standard)“.

| Layout                                                        | Aussehen                                                                                                                                                                                                                | Empfehlung                                                                                                                                |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| „Raster mit detaillierten Karten (Standard)“                  | Große Bilder, Badges, Name, Untertitel und Preise. Am Desktop etwa 4 Spalten, auf Tablets 2, auf dem Handy wird daraus eine Liste.                                                                                      | Der Normalfall, besonders für Mode, Lifestyle und bildstarke Sortimente. Nur hier gibt es Badges und Untertitel.                          |
| „Kompakte Liste“                                              | Eine Zeile je Produkt: kleines Bild links, Name und Preis daneben. Ohne Badges und Untertitel.                                                                                                                          | Technische Shops mit langen Namen, Ersatzteile, viele Treffer auf kleinem Raum.                                                           |
| „Kompaktes Raster“                                            | Dichter als das Raster: ab Tablet etwa 3 Spalten, am Desktop bis etwa 6. Ohne Badges und Untertitel.                                                                                                                    | Große Sortimente mit wenig Text, schneller Überblick.                                                                                     |
| „Karussell“                                                   | Eine horizontale Zeile mit Pfeil-Knöpfen, wischbar. Das Fenster bleibt niedrig, nachgeladen wird am rechten Ende.                                                                                                       | Wenige, hochwertige Treffer.                                                                                                              |
| „Natives Shopware-Design (InsightSearch-Treffer, kein Popup)“ | Kein Fenster des Plugins. Es bleibt Shopwares Vorschlagsfenster mit dem Design Ihres Themes, Treffer und Reihenfolge kommen von InsightSearch. Ist InsightSearch nicht erreichbar, erscheinen Shopwares eigene Treffer. | Themes mit stark angepasster Kopfzeile, in denen das Fenster nicht passt, oder wenn Sie nur die Reihenfolge der Treffer tauschen möchten. |

Im Layout „Nativ“ wirken Filter, Schnellansicht, Warenkorb-Knopf, Badges und alle weiteren Fenster-Einstellungen nicht. Zusätzliche Listen wie „Das könnte auch passen“ oder Ersatzprodukte nutzen immer die Standard-Karte.

**Unsere Empfehlung:** Beginnen Sie mit dem Standard-Raster. Wechseln Sie auf die kompakte Liste, wenn Ihre Produktnamen lang sind oder Bilder wenig aussagen, und auf das Nativ-Design nur, wenn das Fenster in Ihrem Theme nicht sauber funktioniert.

Wie die Suche auf dem Handy aussieht, lesen Sie unter [Suche auf dem Handy](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-auf-dem-handy.md).

## Die Produktkarte

### Bild und Ersatzbild

Die Karte zeigt das Produktbild. Fehlt es oder lädt es nicht, erscheint das „Ersatzbild für Produkte ohne Bild“, das Sie aus Ihren Shopware-Medien wählen (je Verkaufskanal). Das Ersatzbild gilt auch bei Ersatzprodukten und im Shopping-Assistenten, und Cross-Selling Pro nutzt es mit, wenn dort kein eigenes gepflegt ist. Ohne Auswahl erscheint ein grauer Platzhalter. Auf der Shopware-Suchergebnisseite zeigt Shopware die eigene Darstellung.

### Name und Untertitel

Die ganze Karte ist klickbar, auch ein Klick mit der mittleren Maustaste öffnet das Produkt in einem neuen Tab. Der Untertitel kommt aus der „Untertitel-Konfiguration“ je Suchindex (siehe [Sprachzuordnung und Untertitel](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/allgemeine-einstellungen.md)). „Position des Untertitels“ steht auf „Über dem Produktnamen“ oder „Unter dem Produktnamen“ (Standard). Mehrere Werte werden mit Komma verbunden. Der Untertitel erscheint nur im Raster.

### Preise

* Der Normalpreis steht in der Währung des Verkaufskanals. Weicht der Streichpreis ab, steht er durchgestrichen davor. Haben Varianten unterschiedliche Preise, steht „ab “ davor.
* „Preise in der Suche ausblenden“ (Standard aus) blendet alle Preise auf den Karten aus, auch den Grundpreis.
* „Preise mit UVP-Prefix anzeigen“ (Standard aus) setzt „UVP “ vor den Preis.
* „Grundpreise und Einheiten in der Suche anzeigen“ zeigt unter dem Preis zum Beispiel „12,50 € / 1 kg“, wenn Verpackungseinheit und Bezugsgröße vorhanden sind.
* „Live-Preise aus Shopware anzeigen (Beta)“ (Standard aus) lädt für jedes sichtbare Produkt den echten, kundenindividuellen Preis nach, etwa aus erweiterten Preisregeln, und zeigt ihn in Shopwares eigener Preisdarstellung. Das kostet eine zusätzliche Abfrage je Suche. Zusammen mit „Preise in der Suche ausblenden“ oder „UVP-Prefix“ ist die Funktion nicht aktiv.

{% hint style="info" %}
Ohne Live-Preise zeigt die Karte den Preis aus Ihren Produktdaten. Er kann vom Preis im Shop abweichen, wenn es kundenindividuelle Preise gibt oder die Daten noch nicht neu eingelesen wurden.
{% endhint %}

### Badges

Mit „Badges in Suchergebnis-Karten anzeigen“ (Standard aus) erscheinen bis zu 2 farbige Etiketten oben links im Bild. Titel und Farbe stammen aus dem Datenfeld „badge“, das Sie unter [Datenfelder bearbeiten](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/feed-template-editor.md) festlegen.

### Schnellansicht

„Schnellansicht auf Suchergebnis-Karten aktivieren“ (Standard aus) setzt einen runden Augen-Knopf oben rechts ins Bild. Er öffnet Shopwares Schnellansicht über dem Such-Fenster, ohne es zu verlassen.

### Warenkorb-Knopf

„In-den-Warenkorb-Button im Such-Overlay“ (Standard aus) setzt ein rundes Warenkorb-Symbol unten rechts auf die Karte:

* **Einfache, lieferbare Artikel:** Ein Klick legt 1 Stück in den Warenkorb, das Fenster schließt sich und der seitliche Warenkorb öffnet sich.
* **Artikel mit Varianten:** Der Knopf heißt „Auswählen“ und öffnet die Schnellansicht, wenn diese aktiv ist, sonst die Produktseite.
* **Ausverkaufte Artikel:** kein Knopf.

Der Knopf wirkt auch bei „Passt zu …“ und bei Ersatzprodukten.

## Filter im Such-Fenster

Filter sind standardmäßig aus. Schalten Sie „Aktiviert die Filter in der Suche“ ein, damit Seitenleiste, aktive Filter und Filter-Knöpfe erscheinen. Welche Filter es gibt, bestimmen Sie im Plugin-Dashboard unter [Filter](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/filter.md). Änderungen dort sind nach bis zu 5 Minuten im Shop sichtbar.

* **Listenfilter:** Auswahl-Knöpfe mit Beschriftung und Trefferzahl. Mehrere Werte einer Gruppe sind wählbar, jeder Klick schaltet an oder aus.
* **Bereichsfilter** (zum Beispiel Preis): ein Schieberegler mit zwei Griffen, Zahlenfelder „von“ und „bis“, beides oder Preisstufen wie „bis 20 €“. Neu gesucht wird nach dem Loslassen, nicht bei jedem Zwischenschritt. Hat ein Filter nur einen Wert, wird er ausgeblendet.
* **Stufen-Regler** für Texte wie Größen (S, M, L).

**Auf- und Zuklappen:** „Standardmäßiger Filterzustand“ steht auf „Offen (alle aufgeklappt)“ (Standard) oder „Geschlossen (alle eingeklappt)“. Pro Filter kann die Filter-Pflege das überschreiben. Gruppen mit gewählten Werten sind immer offen. Ein Klick auf die Gruppenüberschrift klappt sie auf oder zu.

**Mehr anzeigen:** „Sichtbare Optionen je Filter“ (Standard 5, erlaubt 1 bis 50). Weitere Optionen erscheinen über „Mehr anzeigen“, danach „Weniger anzeigen“.

**Aktive Filter:** Aktive Filter stehen oben als Auswahl (bei einem Preisfilter mit dem gewählten Bereich) mit „×“ zum Entfernen, rechts der Link „Zurücksetzen“. Ein neuer Suchbegriff setzt die Filter zurück.

Auf Handys gelten eigene Regeln, siehe [Suche auf dem Handy](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-auf-dem-handy.md).

## Tastatur

* **Pfeil nach unten und oben** springen durch Vorschläge, Produkte und Filteroptionen, am Ende geht es im Kreis weiter.
* **Enter** öffnet den markierten Eintrag. Ohne Markierung gilt das Verhalten aus dem Abschnitt „Was bei Enter passiert“.
* **Esc** schließt das Fenster.
* **Tab** und **Shift+Tab** bleiben im Fenster. Das hilft Screenreader-Nutzern.
* Alle Knöpfe tragen Beschriftungen für Screenreader, zum Beispiel „Suche löschen“ und „In den Warenkorb“.

## Wiederherstellen beim Zurückgehen

Öffnet ein Kunde ein Produkt aus dem Such-Fenster und geht im Browser zurück, öffnet sich das Fenster mit demselben Stand wieder. „Suche beim Zurückgehen wiederherstellen“ ist standardmäßig an.

* **Gemerkt werden:** Suchbegriff, gewählte Filter, die Zahl der nachgeladenen Seiten (bis zu 5) und die Scrollposition.
* **Gültigkeit:** 30 Minuten, im selben Browser-Tab.
* **Nicht wiederhergestellt wird,** wenn der Kunde das Fenster selbst geschlossen hat, per Enter auf die Suchergebnisseite gewechselt ist, eine Weiterleitung gegriffen hat, die Seite neu geladen wurde oder mehr als 30 Minuten vergangen sind.
* Auf Touch-Geräten öffnet sich dabei die Bildschirmtastatur nicht von selbst.
* Wiederhergestellte Abfragen zählen nicht als neue Suche in der Statistik.

## Banner und Weiterleitungen

Mit den [Suchbegriff-Regeln](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suchbegriff-regeln.md) (kostenpflichtige Zusatzfunktion) steuern Sie einzelne Begriffe:

* **Banner:** Eine Erlebniswelt steht über den Treffern, im Fenster wie auf der Suchergebnisseite. Das gilt auch, wenn der Begriff keine Produkttreffer hat.
* **Weiterleitung:** Sie greift beim Absenden (Enter oder Lupe), nicht beim Tippen. Erlaubte Ziele sind relative Pfade, die Domains des Verkaufskanals und Domains, die Sie unter „Freigegebene externe Domains für Suchbegriff-Weiterleitungen“ eintragen (eine pro Zeile). Andere Ziele werden ignoriert, die Seite lädt dann normal.

## „Passt dazu“

Ist im selben Shop „Cross-Selling Pro - KI Cross Selling“ verbunden, zeigt das Fenster unter den Treffern „Passt zu …“ mit dem Namen des ersten Treffers und bis zu 4 passenden Ergänzungsprodukten. Der Schalter heißt „„Passt dazu“ im Such-Overlay“ und ist standardmäßig an. Ohne Cross-Selling Pro ändert sich nichts. Die Einzelheiten stehen unter [Erlebniswelten und Empfehlungen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/erlebniswelten-und-empfehlungen.md).

## Texte und Sprachen

Alle Texte im Fenster kommen aus Shopware-Textbausteinen. Deutsch und Englisch sind mitgeliefert. Eigene Formulierungen legen Sie in Shopware unter Einstellungen → Shop → Textbausteine an. Die Textbausteine dieses Plugins beginnen mit `cogi-insightsearch.storefront.`. Wie Sie den Platzhalter im Suchfeld je Sprache setzen, steht unter [Design anpassen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/design-anpassen.md).

## Wenn die Suche nichts tut

Prüfen Sie der Reihe nach:

1. Ist „Suche aktivieren“ an?
2. Ist für die Sprache ein Suchindex zugeordnet?
3. Steht das Layout auf „Natives Shopware-Design“? Dann gibt es kein Fenster.
4. Passt der Aktivierungsmodus zu Ihrem Theme? Bei stark angepassten Themes hilft „Aktivierung über externen Trigger“ oder „Aktivierung über Such-Button“.
5. Blockiert eine Sicherheitsrichtlinie oder ein Werbeblocker den Abruf? Dann erscheint „Fehler beim Laden der Ergebnisse.“

Weitere Hilfe finden Sie unter [Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md).

## Weiterlesen

{% 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/4BSNACyJnL4PqGnH9VKn" %}
[Suche auf dem Handy](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-auf-dem-handy.md)
{% endcontent-ref %}

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

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