Поширені помилки в llms.txt
Опубліковано:
Більшість проблем із llms.txt зводяться до кількох типових шаблонів. Ось ті, які наш валідатор позначає найчастіше — і швидке виправлення для кожної.
1. Більше одного H1
Специфікація вимагає рівно один заголовок верхнього рівня # Title. Зайві заголовки # заплутують структуру. Знизьте решту до заголовків розділів ##.
2. Відсутній короткий опис у цитаті
Цитата з одного-двох речень одразу під заголовком — це контекст, який модель читає першим. Її пропуск — найпоширеніший недолік. Додайте її:
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. Розділи без посилань (або взагалі без розділів)
Порожні розділи ## нічого не дають. Кожен розділ має містити маркований Markdown-список посилань на реальні сторінки. Якщо у вас немає жодних розділів, згрупуйте ключові сторінки під заголовками на кшталт ## Docs та ## Guides.
4. Биті посилання
Файл може бути ідеально відформатований, але вести на неіснуючі сторінки — а це марнує бюджет сканування краулера і підриває довіру. Кожен URL має відкриватися. Це перевірка, яку пропускає більшість інструментів; ми звертаємося до кожного посилання.
5. Відносні або http:// посилання
Скрізь використовуйте абсолютні https:// URL-адреси. Моделі можуть не розпізнати відносні шляхи на кшталт /docs/start, а звичайні http:// посилання виглядають ненадійно і можуть не працювати при скануванні лише через HTTPS.
6. Неправильний тип контенту
Віддавайте файл як text/plain; charset=utf-8. Якщо ваш сервер повертає text/html (поширена помилка конфігурації), деякі споживачі не сприйматимуть його як llms.txt.
7. Роздутий, невідібраний файл
llms.txt — це відібраний вручну індекс, а не звалище з sitemap. Сотні посилань без описів ховають корисний сигнал. Залиште найкращі сторінки, додайте короткий : description після кожного і перенесіть другорядні посилання до розділу ## Optional.
Виявіть їх усі за раз
Пропустіть свій файл через валідатор — він оцінює структуру, доступність посилань і дотримання найкращих практик та точно вказує, що з переліченого вище слід виправити. Уперше працюєте з форматом? Почніть із того, як створити файл llms.txt.