Häufige llms.txt-Fehler
Veröffentlicht:
Die meisten llms.txt-Probleme lassen sich auf eine Handvoll Muster zurückführen. Hier sind die, die unser Validator am häufigsten bemängelt – und die schnelle Lösung für jedes davon.
1. Mehr als eine H1
Die Spezifikation verlangt genau einen Titel auf oberster Ebene (# Title). Zusätzliche #-Überschriften verwirren die Struktur. Stufen Sie die übrigen zu ##-Abschnittsüberschriften herab.
2. Keine Zusammenfassung als Blockquote
Ein ein- bis zweisätziges Blockquote direkt unter dem Titel ist der Kontext, den ein Modell zuerst liest. Es wegzulassen ist das mit Abstand häufigste Versäumnis. Fügen Sie eines hinzu:
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. Abschnitte ohne Links (oder gar keine Abschnitte)
Leere ##-Abschnitte bringen nichts. Jeder Abschnitt sollte eine Markdown-Aufzählungsliste mit Links zu echten Seiten enthalten. Wenn Sie gar keine Abschnitte haben, gruppieren Sie Ihre wichtigsten Seiten unter Überschriften wie ## Docs und ## Guides.
4. Defekte Links
Eine Datei kann perfekt formatiert sein und trotzdem auf tote Seiten verweisen – das verschwendet das Budget eines Crawlers und untergräbt das Vertrauen. Jede URL muss erreichbar sein. Das ist die Prüfung, die die meisten Tools auslassen; wir rufen jede einzelne ab.
5. Relative oder http://-Links
Verwenden Sie überall absolute https://-URLs. Modelle können relative Pfade wie /docs/start möglicherweise nicht auflösen, und einfache http://-Links wirken unseriös und können bei reinem HTTPS-Crawling brechen.
6. Der falsche Content-Type
Liefern Sie die Datei als text/plain; charset=utf-8 aus. Wenn Ihr Server text/html zurückgibt (eine häufige Fehlkonfiguration), behandeln manche Verbraucher sie nicht als llms.txt.
7. Eine aufgeblähte, unkuratierte Datei
llms.txt ist ein kuratierter Index, kein Sitemap-Abzug. Hunderte von Links ohne Beschreibungen verschütten das Signal. Behalten Sie die besten Seiten, fügen Sie hinter jeder eine kurze : description hinzu und verschieben Sie sekundäre Links in einen ## Optional-Abschnitt.
Alle auf einmal erkennen
Lassen Sie Ihre Datei durch den Validator laufen – er bewertet Struktur, Erreichbarkeit der Links und Best Practices und sagt Ihnen genau, welche der oben genannten Punkte zu beheben sind. Neu im Format? Beginnen Sie mit der Anleitung zum Erstellen einer llms.txt-Datei.