Najczęstsze błędy w llms.txt
Opublikowano:
Większość problemów z llms.txt sprowadza się do kilku powtarzalnych wzorców. Oto te, które nasz walidator oznacza najczęściej — wraz z szybkim sposobem naprawy każdego z nich.
1. Więcej niż jeden H1
Specyfikacja wymaga dokładnie jednego nadrzędnego # Title. Dodatkowe nagłówki # zaburzają strukturę. Zmień pozostałe na nagłówki sekcji ##.
2. Brak podsumowania w cytacie blokowym
Jedno- lub dwuzdaniowy cytat blokowy tuż pod tytułem to kontekst, który model czyta jako pierwszy. Jego pominięcie to najczęstszy pojedynczy błąd. Dodaj go:
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. Sekcje bez odnośników (lub brak sekcji)
Puste sekcje ## niczego nie wnoszą. Każda sekcja powinna zawierać listę wypunktowaną w Markdown z odnośnikami do rzeczywistych stron. Jeśli w ogóle nie masz sekcji, pogrupuj kluczowe strony pod nagłówkami takimi jak ## Docs i ## Guides.
4. Niedziałające odnośniki
Plik może być sformatowany bez zarzutu, a mimo to kierować do nieistniejących stron — co marnuje budżet indeksowania robota i podważa zaufanie. Każdy adres URL musi się rozwiązywać. To kontrola, którą większość narzędzi pomija; my pobieramy każdy z nich.
5. Odnośniki względne lub http://
Wszędzie używaj bezwzględnych adresów URL z https://. Modele mogą nie rozwiązywać ścieżek względnych takich jak /docs/start, a zwykłe odnośniki http:// wyglądają niewiarygodnie i mogą przestać działać przy indeksowaniu wyłącznie przez HTTPS.
6. Niewłaściwy typ zawartości
Udostępniaj plik jako text/plain; charset=utf-8. Jeśli Twój serwer zwraca text/html (częsta błędna konfiguracja), część odbiorców nie potraktuje go jako llms.txt.
7. Rozdęty, niewyselekcjonowany plik
llms.txt to wyselekcjonowany indeks, a nie zrzut z sitemap.xml. Setki odnośników bez opisów zagłuszają sygnał. Zachowaj najlepsze strony, dodaj krótki : description po każdej z nich, a drugorzędne odnośniki przenieś do sekcji ## Optional.
Wychwyć je wszystkie za jednym razem
Przepuść swój plik przez walidator — ocenia strukturę, dostępność odnośników i dobre praktyki oraz wskazuje dokładnie, które z powyższych elementów poprawić. Nowy w tym formacie? Zacznij od jak utworzyć plik llms.txt.