- Sie haben noch keine Artikel in Ihrem Warenkorb.
KI-Agenten-Erkennung für Gambio (llms.txt und KI-Katalog)
NEU
TOP
KI-Agenten
KI-Agenten-Erkennung ist das Gambio-Modul, mit dem Ihr Shop sich selbst für KI-Assistenten beschreibt. Es beantwortet /llms.txt und /.well-known/ai-catalog.json mit erzeugten Dokumenten statt mit der HTML-Startseite. Der Inhalt kommt aus Ihren Kategorien und Informationsseiten, es funktioniert mit jedem Theme.
Gambio-Shop für KI-Assistenten beschreiben: llms.txt und KI-Katalog
KI-Agenten-Erkennung ist das Gambio-Modul, mit dem Ihr Shop sich selbst für KI-Assistenten beschreibt. Ein Gambio-Shop beantwortet die Adressen /llms.txt und /.well-known/ai-catalog.json ohne Zusatz mit seiner HTML-Startseite. Ein Programm, das dort eine Beschreibung des Shops erwartet, kann damit nichts anfangen, und Google Lighthouse meldet es als Fehler. Das Modul liefert an diesen Adressen erzeugte Dokumente aus, zusammengestellt aus Kategorien, Informationsseiten und Ihren eigenen Texten.
Auf einen Blick
| Was es ist | Gambio-Modul der WinHelp GmbH. Es beschreibt Ihren Shop für KI-Assistenten mit einer llms.txt und einem KI-Katalog. |
|---|---|
| Für wen | Shopbetreiber, die wollen, dass KI-Assistenten und Prüfwerkzeuge ihren Shop korrekt erkennen. |
| Adressen | /llms.txt, /llms-full.txt, /llms-<Kürzel>.txt für weitere Sprachen, /.well-known/ai-catalog.json und /.well-known/ard.json |
| Inhalt | Shopname, Zusammenfassung, Kategorien, neue Artikel, gewählte Informationsseiten, Shop-Fakten, Sitemap. Nur, was Gäste sehen dürfen. |
| So wird ausgeliefert | Als echte Dateien per Cronjob (voreingestellt stündlich) oder dynamisch durch PHP. |
| Theme | Jedes Theme. Das Modul ändert keine Templates. |
| Voraussetzung | Gambio ab GX5 (PHP 8.2), läuft auch unter GX26. Das Modul WinHelp Core muss installiert sein. |
| Hersteller und Support | WinHelp GmbH, Rheinstetten, info@winhelp.eu |
Für wen ist KI-Agenten-Erkennung gedacht?
- Das passt gut zu: Shops, die von KI-Assistenten gefunden und richtig eingeordnet werden wollen, und zu Shops, die die Lighthouse-Prüfung „Agent Discoverability“ bestehen sollen.
- Dafür ist es nicht gedacht: Das Modul macht den Shop nicht von sich aus bestellbar für KI-Assistenten und sichert keinen Platz in KI-Antworten zu.
Gambio ohne Modul oder mit KI-Agenten-Erkennung?
| Gambio ohne Modul | Mit KI-Agenten-Erkennung | |
|---|---|---|
| Antwort auf /llms.txt | Die HTML-Startseite des Shops. | Ein Markdown-Dokument mit Kategorien und Informationsseiten. |
| Antwort auf /.well-known/ai-catalog.json | Die HTML-Startseite des Shops. | Ein KI-Katalog im JSON-Format. |
| Lighthouse „Agent Discoverability“ | Prüfung schlägt fehl. | Beide Abrufe liefern gültige Dokumente. |
| Pflege | Nicht vorgesehen. | Automatisch aus den Shopdaten, mit eigenen Texten je Sprache. |
Ihre Vorteile
Richtige Antwort statt Startseite. Unter /llms.txt, /llms-full.txt und /.well-known/ai-catalog.json (auch als ard.json) liefert der Shop die erzeugten Dokumente aus.
Läuft mit jedem Theme. Das Modul ändert keine Templates. Ist es nicht installiert, verhält sich der Shop wie ohne Modul.
Dateien oder dynamisch. Voreingestellt schreibt das Modul echte Dateien, die der Webserver direkt ausliefert. Fehlt eine, antwortet das Modul an ihrer Stelle. Alternativ beantwortet PHP jede Anfrage.
Ein Cronjob hält sie aktuell. Der Gambio-Cronjob „WinHelp® KI-Agenten-Erkennung“ schreibt stündlich, täglich oder nie, je nach Einstellung „Intervall“.
Ihr Text in jeder Sprache. Einleitungstext und Shop-Fakten pflegen Sie je aktiver Shop-Sprache. Weitere Sprachen bekommen eigene Dateien.
Kurztexte an Kategorien und Artikeln. Im Formular einer Kategorie steht ein Kurztext für die llms.txt. Im Formular eines Artikels markieren Sie ihn für die Liste „Neue Artikel“.
Eigene Katalog-Einträge. Weitere Ressourcen wie einen Produktfeed tragen Sie als „Adresse | Medientyp | Beschreibung“ in den Katalog ein.
Genaue Inhaltstypen per .htaccess. Auf Wunsch trägt das Modul einen markierten Block ein, nach vorheriger Sicherung. Er setzt text/markdown und application/ai-catalog+json und sendet auf der Startseite einen Link-Header.
Selbsttest. Das Modul ruft seine eigenen Adressen auf und zeigt je Adresse Status, Inhaltstyp und gültiges Format. Es prüft auch, ob die Links der llms.txt erreichbar sind.
So richten Sie das Modul ein
1 Laden Sie den Ordner des Moduls in Ihren Shop. Das Modul WinHelp Core muss dort schon vorhanden sein.
2 Leeren Sie im Admin den Cache, auch die Textbausteine, damit Gambio die neuen Dateien und Texte kennt.
3 Öffnen Sie im Modul-Center den Eintrag „WinHelp® - KI-Agenten-Erkennung“, installieren Sie ihn und klicken Sie auf „Bearbeiten“.
4 Schreiben Sie auf der Seite „KI-Agenten“ bei Bedarf einen Einleitungstext und ergänzen Sie die Shop-Fakten, dann klicken Sie auf „Speichern“.
5 Starten Sie den „Selbsttest“. Er ruft die Adressen des Moduls auf und zeigt, welche in Ordnung sind.
6 Tragen Sie im Kasten „Webserver-Regeln (.htaccess)“ mit „Regeln schreiben“ die genauen Inhaltstypen ein, wenn Ihre .htaccess beschreibbar ist.
Im Auslieferungszustand sind llms.txt, KI-Katalog und die lange Fassung eingeschaltet. Die Kategorietiefe steht auf 2 und „Neue Artikel“ auf 10.
Technische Daten
- Gambio ab GX5 mit PHP 8.2, läuft auch unter GX26. Das Modul arbeitet mit jedem Theme.
- Voraussetzung ist das Modul WinHelp Core im Shop.
- Die Antworten sind öffentlich und werden eine Stunde zwischengespeichert. Das Modul entfernt dabei Cookies und Sitzungsdaten aus der Antwort.
- Dateien: llms.txt im Hauptverzeichnis, ai-catalog.json und ard.json im Ordner .well-known. Geschrieben wird atomar und nur, wenn sich der Inhalt geändert hat.
- Die .htaccess-Regeln brauchen Apache 2.4. Ohne mod_headers gelten nur die Inhaltstypen, der Link-Header entfällt.
- Schreibaktionen verlangen Schreibrechte im Gambio-Admin. Der Hauptadmin hat sie immer, weitere Admins brauchen die Berechtigung.
- Installation, Update und Deinstallation laufen über das Gambio-Modul-Center. Beim Deinstallieren gehen die Einstellungen verloren, ein Export ist nicht vorgesehen.
- Stand dieser Beschreibung: November 2026.
Gut zu wissen
- Die llms.txt ist eine Konvention. Das Modul stellt sie korrekt bereit, ob ein bestimmter KI-Dienst sie liest, liegt nicht bei Ihnen und nicht beim Modul.
- Das Modul macht Ihren Shop nicht bestellbar für KI-Assistenten, bietet keine Agenten-Schnittstelle und behauptet keine Identität des Shops.
- Erzeugt wird für die Standardsprache und für jede weitere aktive Sprache. Der KI-Katalog selbst ist ein Dokument in der Standardsprache. Nach dem Aktivieren einer Sprache kann er bis zu eine Stunde veraltet sein, „Neu erzeugen“ aktualisiert ihn.
- Zahlungs- und Versandarten schreibt das Modul nicht selbst in die Shop-Fakten, weil die Namen aus Sprachdateien anderer Module stammen. Tragen Sie sie bei Bedarf ein.
- Eine echte Datei gleichen Namens im Hauptverzeichnis hat immer Vorrang. Zeigt die Seite „Atelier antwortet“, liefert das Atelier-Modul die Adresse aus, bis Sie sie dort ausschalten.
- Manche Hosts belegen den Ordner /.well-known/ selbst, etwa für Zertifikate. Dann kann die statische Katalogdatei fehlen. Der Selbsttest zeigt das.
Häufige Fragen
Was ist eine llms.txt und braucht mein Gambio-Shop sie?
Die llms.txt ist eine Textdatei im Shop-Hauptverzeichnis, die einem KI-Assistenten kurz sagt, was für ein Shop das ist und wo die wichtigen Seiten stehen. Sie ist eine Konvention und keine Pflicht. Ob ein bestimmter Assistent sie liest, kann das Modul nicht zusichern.
Wie kann ich in Gambio eine llms.txt erstellen?
Mit dem Modul KI-Agenten-Erkennung. Es erzeugt die llms.txt aus Shopname, Kategorien und Informationsseiten und liefert sie unter /llms.txt aus. Gambio selbst beantwortet diese Adresse mit der HTML-Startseite.
Was steht in der llms.txt?
Oben der Shopname und eine kurze Zusammenfassung, dann Ihr Einleitungstext, die Shop-Fakten, der Kategoriebaum, neue Artikel, die gewählten Informationsseiten und ein Link auf die XML-Sitemap. Es erscheint nur, was ein nicht angemeldeter Besucher sehen darf.
Was ist der KI-Katalog unter /.well-known/ai-catalog.json?
Eine JSON-Datei nach der Spezifikation „AI Catalog“. Sie nennt Ihren Shop und listet die Dokumente auf, die das Modul ausliefert, dazu die Sitemap und eigene Einträge, die Sie selbst ergänzen. Dieselbe Datei gibt es auch unter /.well-known/ard.json.
Besteht Gambio die Prüfung „Agent Discoverability“ von Lighthouse mit dem Modul?
Die Prüfung ruft /.well-known/ai-catalog.json und /llms.txt ab. Ohne Modul liefert Gambio dort die HTML-Startseite, mit dem Modul kommen gültige Dokumente. Das Modul macht den Shop aber nicht für KI-Assistenten bestellbar.
Muss ich die Dateien selbst pflegen?
Nein. Das Modul erzeugt sie aus Ihren Shopdaten und schreibt sie voreingestellt stündlich per Cronjob neu. Das Intervall stellen Sie auf täglich oder manuell. Eigene Texte tragen Sie nur ein, wenn Sie etwas ergänzen wollen.
Funktioniert das Modul mit meinem Theme?
Ja, mit jedem Theme. Das Modul ändert keine Templates und antwortet, bevor Gambio das Theme lädt oder der Webserver die fertige Datei ausliefert.
Was passiert, wenn bei mir schon eine llms.txt liegt?
Das Modul überschreibt sie nicht. Eine Datei, die es nicht selbst geschrieben hat, behandelt es als fremd und zeigt das auf der Seite an. Erst nach „Übernehmen (überschreiben)“ und einer Bestätigung ersetzt es sie.
Kann ich die Dateien auch in mehreren Sprachen ausliefern?
Ja. Für jede weitere aktive Shop-Sprache entstehen eine llms-
Stehen Preise oder Lagerbestände in den Dateien?
Nein. Das Modul liest weder Preise noch Lagerbestände aus. Es nennt Kategorien, Informationsseiten und Artikel. Die lange Fassung llms-full.txt enthält zusätzlich die Kurzbeschreibungen der Artikel und den Text der gewählten Informationsseiten.
Läuft das Modul unter Gambio GX26?
Ja. Das Modul ist für Gambio GX5 mit PHP 8.2 gebaut und läuft auch unter GX26. Es setzt das WinHelp-Core-Modul voraus.
Support
Bei Fragen zur Einrichtung oder Nutzung erreichen Sie uns unter info@winhelp.eu.
Fragen zu Einrichtung, Kompatibilität oder Updates beantworten wir gern. Nennen Sie uns Ihre Gambio-Version und das verwendete Theme.