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

# Fehlersuche

Prüfschritte für die häufigsten Probleme, von Shopware-Ergebnissen statt InsightSearch über fehlende Produkte bis zu leeren Statistiken.

Wenn etwas nicht wie erwartet funktioniert, finden Sie hier die Prüfschritte in sinnvoller Reihenfolge. Suchen Sie in der Tabelle Ihr Symptom und springen Sie zum passenden Abschnitt.

| Symptom                                                    | Abschnitt                                                                   |
| ---------------------------------------------------------- | --------------------------------------------------------------------------- |
| Im Shop erscheint die Shopware-Suche statt InsightSearch   | [Die Suche zeigt Shopware-Ergebnisse](#die-suche-zeigt-shopware-ergebnisse) |
| Die Suche findet nichts, alles ist leer                    | [Keine Ergebnisse](#keine-ergebnisse)                                       |
| Der Feed ist leer oder meldet einen Fehler                 | [Feed leer oder Fehler](#feed-leer-oder-fehler)                             |
| Einzelne Produkte fehlen                                   | [Produkte fehlen](#produkte-fehlen)                                         |
| Ein Preis in der Suche stimmt nicht                        | [Preise sind falsch](#preise-sind-falsch)                                   |
| Eine Änderung ist in der Suche nicht zu sehen              | [Änderungen sind nicht sichtbar](#anderungen-sind-nicht-sichtbar)           |
| Die Indexierung bleibt stehen, zum Beispiel bei 96 Prozent | [Push hängt](#push-hangt)                                                   |
| Die Statistik zeigt keine oder zu wenige Daten             | [Statistik ist leer](#statistik-ist-leer)                                   |
| Bestellungen fehlen in der Statistik                       | [Bestellungen fehlen](#bestellungen-fehlen)                                 |
| Die Suchbox sieht falsch aus oder fehlt                    | [Theme-Konflikte](#theme-konflikte)                                         |
| Es geht um das Kontingent der Suchanfragen                 | [Kontingent erreicht](#kontingent-erreicht)                                 |
| Im Admin erscheint eine Meldung                            | [Hinweise im Admin](#hinweise-im-admin)                                     |

## Zuerst prüfen

Öffnen Sie im Plugin-Dashboard die Übersicht und schauen Sie auf den „Systemstatus“. Dort sehen Sie die Verbindung, die Datenquellen, laufende Vorgänge und offene Probleme. Darüber kann ein Banner „Aktuelle Meldungen: KI-gestützte Produktsuche“ stehen. Danach hilft das Protokoll des Plugins im Shop (`var/log`, Datei `cogi_insightsearch-<Datum>.log`).

## Die Suche zeigt Shopware-Ergebnisse

Das Such-Overlay von InsightSearch erscheint nur, wenn „Suche aktivieren“ an ist **und** für den aktuellen Verkaufskanal und die aktuelle Sprache eine Zuordnung zu einer Datenquelle besteht. Fehlt sie, bleibt die Shopware-Suche.

Prüfen Sie in dieser Reihenfolge:

1. Ist das Plugin aktiv und „Suche aktivieren“ an, für den richtigen Verkaufskanal? Prüfen Sie auch den Eintrag „Alle Verkaufskanäle“.
2. Gibt es eine **Sprachzuordnung** für genau diesen Verkaufskanal und diese Sprache (Einstellungen, „Sprachen einzelnen Datenquellen zuordnen“)? Die Zuordnung gilt exakt je Verkaufskanal und Sprache. Im Systemstatus steht sonst: „Es sind Datenquellen vorhanden, aber noch keine Sprache und kein Verkaufskanal zugeordnet.“ Der Knopf „Sprachen zuordnen“ führt hin.
3. Steht im Systemstatus die Verbindung auf „Verbunden“ und die Datenquelle auf „Synchron“?
4. Zeigt das Banner „Aktuelle Meldungen“ eine Störung?
5. Blockiert etwas im Browser die Aufrufe der Suche? Öffnen Sie die Entwicklerwerkzeuge des Browsers (Netzwerk) und schauen Sie, ob Aufrufe an unseren Suchdienst oder an `/cogi/insightsearch/auth/session-token` fehlschlagen. Typische Ursachen sind eine Firewall, ein Bot-Schutz, eine strenge Content-Security-Policy oder ein Werbeblocker.
6. Steht im Protokoll „Fallback auf Shopware-Suche“?
7. Leeren Sie den Zwischenspeicher (`cache:clear`) und bauen Sie das Theme neu (`theme:compile`), besonders wenn ein eigenes Theme die Suchbox überschreibt. Mehr dazu unter [Befehle](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/befehle.md).

Gut zu wissen:

* **Layout „Nativ“** nutzt das Vorschlagsfenster von Shopware mit InsightSearch-Treffern. Der Schalter „Shopware-Suchergebnisseite durch InsightSearch beliefern“ (Standard aus) liefert die Treffer der normalen Suchergebnisseite.
* **Rückfall bei Störungen:** Antwortet unsere Suche auf dem Server-Weg nicht rechtzeitig, zeigt Shopware die eigene Suche. Die Zeitlimits betragen rund 3 Sekunden für die Suchergebnisseite und 5 Sekunden für das Vorschlagsfenster. Nach 3 Fehlern in Folge gehen die Anfragen dieses Verkaufskanals für 60 Sekunden direkt an Shopware, danach wird neu versucht.
* **Elasticsearch/OpenSearch:** Ist die Produktsuche von Shopware über Elasticsearch oder OpenSearch aktiv, übernimmt InsightSearch die Suchergebnisseite nicht. Das Such-Overlay ist davon nicht betroffen.

## Keine Ergebnisse

Die Suche öffnet sich, findet aber nichts oder zeigt leere Seiten.

1. Gibt es eine **Sprachzuordnung** für diesen Verkaufskanal und diese Sprache? Eine falsche Zuordnung, etwa zu einer Datenquelle mit anderer Sprache, wirkt wie „keine Treffer“.
2. Öffnen Sie den Bereich „Quellen“. Wie ist der Status, wie viele Produkte enthält die Datenquelle, wann war die letzte Indexierung? Bei 0 Produkten ist der Feed leer, siehe [Feed leer oder Fehler](#feed-leer-oder-fehler).
3. Haben Sie weniger Zeichen eingegeben als die Mindestanzahl (Standard 3)? Dann zeigt das Overlay einen Hinweis, wie viele Zeichen nötig sind, und nicht „Keine Produkte gefunden“.
4. Sind Filter aktiv, die nichts mehr übrig lassen? Nutzen Sie „Zurücksetzen“.
5. Ist die Rettung bei keinen Treffern ausgeschaltet? Sie ist standardmäßig an („Suche bei 0 Treffern lockern“, „Tippfehler korrigieren“, Ersatzprodukte). Sind alle Optionen aus, bleibt die Seite leer. Mehr unter [Keine Treffer](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/keine-treffer.md).
6. Passt die Sprache des Feeds zur Sprache der Storefront? Hat der Feed im Verkaufskanal eine andere Sprache als die Storefront, passen Suchbegriffe und Daten nicht zusammen.

## Feed leer oder Fehler

Das gilt für Pull. Alle Fehlerarten mit Ursache und Maßnahme stehen auf der Seite [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). Kurzfassung der Reihenfolge:

1. Öffnen Sie die Feed-Adresse in einem **privaten Browserfenster**, ohne Anmeldung. Sie finden sie im Bereich „Quellen“ (Knopf „Feed im Browser öffnen“) oder im Verkaufskanal vom Typ Produktvergleich ganz unten unter „Export-URL“. Lädt sie? Ist es gültiges XML mit `<item>`-Einträgen?
2. Sehen Sie sich im Wizard oder im Bereich „Quellen“ die Fehlerart und den HTTP-Status an.
3. Prüfen Sie Wartungsmodus, htaccess, Firewall und Bot-Schutz sowie das Zertifikat.
4. Gibt es den Produktexport in Shopware unter Marketing, Produktvergleich noch und ist er aktiv? Läuft bei „Im Hintergrund generieren“ die geplante Aufgabe von Shopware, die die Datei erzeugt? Ist die Datei veraltet?
5. Schauen Sie ins Shopware-Protokoll (`var/log`) zum Produktexport.
6. Prüfen Sie die dynamische Produktgruppe des Exports. Der Standardfilter ist nur „Aktiv = ja“. Eine eigene Gruppe mit zu strengem Filter, zum Beispiel beim Lagerbestand, leert den Feed.
7. Nach der Behebung: „Erneut versuchen“ oder „Produktdaten neu einlesen“.

## Produkte fehlen

Prüfen Sie, ob das Produkt in Shopware die Bedingungen erfüllt:

* **Aktiv und sichtbar:** Es werden nur aktive Produkte übertragen, die im Storefront-Verkaufskanal eine Sichtbarkeit haben, mindestens „nur Suche“. Produkte mit der Sichtbarkeit „nur Suche“ werden gefunden, erscheinen aber nicht auf Kategorieseiten. Unsichtbare, inaktive und Produkte ohne Zuordnung zum Verkaufskanal fehlen.
* **Dynamische Produktgruppe und Filter:** Sie schließen Produkte im Export oder Push-Index aus, wenn das Produkt nicht dazu passt.
* **Kundengruppe, Währung, Sprache:** Der Feed wird mit den Einstellungen des Produktvergleichs-Verkaufskanals erzeugt.
* **Bestand:** Ein Produkt gilt als verfügbar, wenn der verfügbare Bestand mindestens der Mindestabnahme entspricht. Ausgeblendete Abverkaufsartikel wirken über die Sichtbarkeit in Shopware.
* **Varianten:** Ist „Varianten desselben Produkts zu einem Treffer zusammenfassen“ an (Standard an), zeigen Overlay und Suchergebnisseite Varianten als einen Treffer. Sollen Varianten einzeln gefunden werden, etwa bei eigenen Bildern oder Farben, schalten Sie die Option aus. Die Zähler der Filter zählen weiterhin Varianten.
* **Push:** Findet die Vorabprüfung kein Produkt („Keine Produkte gefunden“), startet der Lauf nicht.
* **Nach Änderungen:** „Produktdaten neu einlesen“. Bei Pull müssen Sie zusätzlich den nächsten Export-Lauf von Shopware abwarten.

Vergleichen Sie im Überblick die Anzahl der Produkte je Datenquelle mit der Anzahl in Shopware. Mehr zur Ansicht unter [Produkte im Dashboard](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/produkte-im-dashboard.md).

## Preise sind falsch

1. Preise in der Suche stammen aus dem Index. Er wird für **eine** Kundengruppe, **eine** Währung und **eine** Sprache berechnet. Kunden anderer Gruppen oder mit Sonderpreisen sehen sonst den Preis des Index.
2. Mit der Option „Live-Preise aus Shopware anzeigen (Beta)“ wird für jeden sichtbaren Treffer der echte, kundenindividuelle Preis nachgeladen. Das erzeugt eine zusätzliche Abfrage pro Suche. Die Option lässt sich nicht mit „Preise in der Suche ausblenden“ oder „Preise mit UVP-Prefix anzeigen“ kombinieren.
3. Prüfen Sie die Aktualität: Bei Pull zeigt erst der nächste Export-Lauf und Abruf den neuen Preis. Bei Push zeigt ihn der nächste Push oder, mit eingeschaltetem Live-Abgleich, die Suche nach etwa zwei Minuten. Siehe [Push und Live-Abgleich](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/push-und-live-abgleich.md).
4. Der Feed nutzt bei Staffelpreisen den niedrigsten Preis (ein „ab“-Preis).
5. Vergleichen Sie den Preis im Feed mit der Währung und Kundengruppe des Produktvergleichs-Verkaufskanals.
6. Stimmt der Streichpreis (UVP)? Prüfen Sie die Felder für Verkaufspreis und regulären Preis im Feed.

## Änderungen sind nicht sichtbar

| Was Sie geändert haben                                                                                  | Wann es sichtbar wird                                                                                                                                                                         |
| ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Preis, Name, Bild oder Bestand (Pull)                                                                   | Nach dem nächsten Export-Lauf von Shopware und dem nächsten Abruf. Sofort: „Produktdaten neu einlesen“ im Bereich „Quellen“. Bei „Im Hintergrund generieren“ zuerst den Export-Lauf abwarten. |
| Preis, Name, Bild oder Bestand (Push)                                                                   | Mit dem nächsten täglichen Push, mit „Produktdaten neu einlesen“ oder mit Live-Abgleich nach etwa 2 Minuten                                                                                   |
| Datenfelder, Datenattribute, Typen, Suchgewichtung, Boost-Wert, „Abverkauf und Margenklasse übertragen“ | Erst nach „Produktdaten neu einlesen“                                                                                                                                                         |
| Filter-Einstellungen                                                                                    | Es kann bis zu 5 Minuten dauern, bis Änderungen aktiv sind                                                                                                                                    |
| Neue oder geänderte Synonyme                                                                            | Nach kurzer Zeit (Zwischenspeicher, bis zu einigen Minuten). Ein gelöschtes Synonym kann bis zum nächsten Neu-Einlesen nachwirken.                                                            |
| Plugin-Konfiguration (Storefront-Optionen, Farben, Texte)                                               | Zwischenspeicher von Shopware leeren (`cache:clear`), bei Theme-Änderungen `theme:compile`. Beachten Sie auch den Browser-Zwischenspeicher und ein CDN.                                       |
| Zahlen der Kachel im Shopware-Dashboard                                                                 | Der Zwischenspeicher hält 10 Minuten                                                                                                                                                          |

Trefferlisten der Suchergebnisseite werden außerdem kurz zwischengespeichert, in der Größenordnung von etwa 2 Minuten.

## Push hängt

Ausführlich steht der Ablauf unter [Push und Live-Abgleich](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/push-und-live-abgleich.md). Die Kurzfassung der Prüfschritte:

1. Läuft ein Worker, der die Warteschlange `async` abarbeitet?
2. Ist das PHP-Speicherlimit des Worker-Prozesses (CLI) ausreichend, und startet ihn Supervisor oder systemd nach einem Beenden neu?
3. Läuft `scheduled-task:run`? Die Überwachung läuft alle 10 Minuten.
4. Zeigt der Bereich „Quellen“ den Hinweis, dass hängende Pakete neu eingereiht werden?
5. Sehen Sie im Protokoll Einträge mit „\[PushIndexing]“ und „\[PushFinalize]“?
6. Nach 15 Minuten ohne Fortschritt, oder nach einer Stunde, wenn gar kein Worker läuft, gilt der Lauf als fehlgeschlagen. Starten Sie ihn dann mit „Neu starten“.
7. Tritt es häufig auf, ist der Katalog womöglich sehr groß. Erhöhen Sie das Speicherlimit des Workers.

## Statistik ist leer

1. **Läuft der Worker?** Warenkorb, Bestellung und Zahlstatus sind Hintergrundnachrichten. Ohne Worker bleiben sie liegen. Bestellungen holt eine Aufgabe alle 6 Stunden nach, Warenkorb-Ereignisse nicht.
2. Ist „Bestellungs-Tracking aktivieren“ an? Ist es aus, werden Warenkorb, Bestellung und Zahlstatus nicht gesendet.
3. Passt der **Bezahlt-Status** zu Ihren Zahlungsarten? Bei Rechnung oder Vorkasse ohne Status „Bezahlt“ wählen Sie bei „Bezahlt-Status der Transaktion“ zusätzlich „Offen“, sonst fehlt Umsatz.
4. Gibt es eine Sprachzuordnung? Bestellungen ohne Zuordnung zu einer Datenquelle werden nicht gemeldet.
5. Stimmen Zeitraum und Zeitzone? Die Zeitzone stellen Sie in der Karte „Admin-Dashboard“ bei „Zeitzone für Statistiken“ ein (zum Beispiel `Europe/Berlin`). Tage beginnen um Mitternacht in dieser Zeitzone.
6. Bots und Crawler zählen nicht. Ein Test mit curl oder einem Skript erscheint nicht.
7. Ohne Cookie-Zustimmung werden Ereignisse mit der abgeleiteten Sitzungsreferenz gesendet. Sie erscheinen trotzdem, nur die Wiedererkennung über mehrere Besuche fehlt. Mehr unter [Datenschutz](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/datenschutz.md).
8. Hinter einem CDN ohne gesetzte vertrauenswürdige Proxys (`TRUSTED_PROXIES` in Shopware) sehen alle Besucher dieselbe IP-Adresse. Das Plugin begrenzt Ereignisse auf 120 pro Minute je Besucher und 3000 pro Minute je IP. Darüber hinaus werden Ereignisse verworfen.
9. Lädt die Statistik-Seite im Admin nicht? Dafür brauchen Sie das Recht „Bestellungen ansehen“. Siehe [Berechtigungen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/berechtigungen.md).
10. Die Zahlen der Kachel erscheinen erst nach dem Zwischenspeicher von 10 Minuten.

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

## Bestellungen fehlen

1. Läuft die Aufgabe zum Nachholen von Bestellungen (alle 6 Stunden)? Sie holt nur Bestellungen der **letzten 7 Tage** nach. Ältere werden nicht nachgeholt.
2. Eine Bestellung zählt als Umsatz, wenn ihr Zahlstatus zu „Bezahlt-Status der Transaktion“ passt. Wählen Sie bei Rechnungskauf „Offen“ zusätzlich, dann zählt sie schon beim Bestellen. Storno und Rückbuchung nehmen sie wieder heraus.
3. **Umsatz über die Suche** zählt je gekauftem Produkt (oder dessen Variante), wenn dieses Produkt in der Suche angeklickt oder von dort in den Warenkorb gelegt wurde. Zwischen Klick und Bestellung dürfen bis zu 72 Stunden liegen, im selben Browser. Andere Bestellungen sind Shop-Umsatz, nicht Suchumsatz.
4. Bestellungen aus einer Sprache oder einem Verkaufskanal ohne eigene Zuordnung zählen bei der Datenquelle desselben Verkaufskanals. Verkaufskanäle ohne Zuordnung in Shops mit mehreren Datenquellen werden nicht gezählt.
5. Bestellungen aus der Zeit vor der Installation des Commanders tragen Sie mit `cogi-insightsearch:suite-backfill` nach, siehe [Befehle](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/befehle.md).
6. Zahlungsabbrecher haben eine Bestellung, die „offen“ bleibt und nicht als bezahlt erscheint.
7. Doppelte Meldungen sind kein Problem: Wiederholungen derselben Bestellung werden anhand der Bestell-ID zusammengeführt.

## Theme-Konflikte

* **Eigenes Theme:** Es kann Templates der Suchbox, des Headers oder der Produktkarten überschreiben. Alte Überschreibungen können Elemente verdecken. Prüfen Sie den Aktivierungsmodus der Suche: Standard, Inline, Über externen Trigger (mit CSS-Selektor) oder Such-Button. Der Such-Button hilft bei Themes, in denen das Suchfeld nicht dauerhaft auf der Seite liegt.
* **Farben und Stylesheet:** Eigene Farben setzen Sie über „Eigene Suchfarben“ oder „Eigenes Stylesheet“. Mit der Option „Standard-Stylesheet ersetzen“ ersetzen Sie das Standard-Styling. Mehr unter [Design anpassen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/design-anpassen.md).
* **Andere Such-Plugins** ersetzen die Suchbox ebenfalls und können mit InsightSearch in Konflikt geraten.
* **Elasticsearch/OpenSearch** für die Produktsuche von Shopware verträgt sich nicht mit der Übernahme der Suchergebnisseite.
* **Nach Änderungen am Theme:** `theme:compile` und `cache:clear`.
* **Cookie-Banner von Drittanbietern** müssen den Cookie-Mechanismus von Shopware verwenden, sonst erscheint der Eintrag „Wiedererkennung für Suche und Empfehlungen“ eventuell nicht.

## Kontingent erreicht

Im Dashboard sehen Sie „Suchanfragen diesen Monat“, die aktuellen Suchanfragen und die Hochrechnung bis Monatsende.

* **Suchanfragen:** Bei Erreichen des Limits finden keinerlei Einschränkungen oder automatische Mehrkosten statt. Bei übermäßiger Überschreitung treten wir mit Ihnen in Kontakt, um gemeinsam eine Lösung zu finden.
* **Shopping-Assistent (Beta):** Ist das Kontingent verbraucht, wird der Assistent bis zum Monatsersten ausgeblendet. Die Suche läuft normal weiter. Ab 80 Prozent erscheint eine Warnung.
* **Manuelles Einlesen:** Zeigt der Admin eine Meldung zu einem aufgebrauchten Kontingent für manuelle Synchronisationen, versuchen Sie es am nächsten Tag erneut.

## Hinweise im Admin

| Hinweis                                                                                                                              | Bedeutung                                                                                                                                                                                   |
| ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Banner „Aktuelle Meldungen: KI-gestützte Produktsuche“                                                                               | Aktuelle Störungen und geplante Wartungen, mit Status „Offen“, „In Bearbeitung“ oder „Unter Beobachtung“ und Datum. Sichtbar auf allen Reitern, in der Karte „Admin-Dashboard“ ausblendbar. |
| „Offene Probleme“ in der Übersicht                                                                                                   | Probleme zu einer Datenquelle. Mit „Als erledigt markieren“ räumen Sie einen Eintrag ab, wenn Sie ihn behoben haben.                                                                        |
| „Deine Suchindizes wurden aufgrund von Inaktivität gelöscht. Bitte starte eine neue Indexierung, um die Suche wieder zu aktivieren.“ | Die Verbindungsprüfung kam lange nicht an. Starten Sie eine neue Indexierung.                                                                                                               |
| „Es sind Datenquellen vorhanden, aber noch keine Sprache und kein Verkaufskanal zugeordnet.“                                         | Ohne Zuordnung erscheint die Suche im Shop nicht. Ordnen Sie Sprachen zu.                                                                                                                   |
| „Verbunden“ oder „Nicht verbunden“, „Verbindung prüfen“                                                                              | Verbindungsstatus je Datenquelle                                                                                                                                                            |
| „Das Plugin ist noch nicht mit InsightSearch verbunden“ in der Kachel                                                                | Die Einrichtung ist nicht abgeschlossen                                                                                                                                                     |
| „Einige Werte konnten gerade nicht geladen werden“ oder „Kennzahlen konnten gerade nicht geladen werden“                             | Mit „Erneut laden“ noch einmal versuchen                                                                                                                                                    |

Für ändernde Aktionen (Indexierung, Feeds, Synonyme, Filter, Zurücksetzen) brauchen Administratoren das Recht „Systemkonfiguration bearbeiten“, für Statistik, Kachel und Auswertung des Assistenten das Recht „Bestellungen ansehen“.

## Kommen Sie nicht weiter?

Wenn die Schritte nicht helfen, öffnen Sie im Plugin-Dashboard den Support-Dialog. Beschreiben Sie das Symptom, den Verkaufskanal und die Sprache und fügen Sie die Fehlermeldung hinzu. Mehr unter [Feedback, Support und Commander](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/feedback-und-commander.md).

## Weiterlesen

{% content-ref url="/pages/cZQWYrygPV5Tw1s3Uyo7" %}
[FAQ und häufige Probleme](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/faq-and-haufige-probleme.md)
{% endcontent-ref %}

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

{% 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/CjY24FwIjTqbOmJFUGvX" %}
[Befehle](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/befehle.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/fehlersuche.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.
