llms-full.txt: что это и чем отличается от llms.txt
Если llms.txt — оглавление сайта для нейросетей, то llms-full.txt — вся книга целиком в одном файле. Разбираем, когда он нужен, а когда только навредит.
В чём разница
llms.txt — компактная карта: название, описание и аннотированные ссылки на ключевые страницы. Модель читает карту и сама решает, по каким ссылкам идти.
llms-full.txt — тот же принцип, но вместо ссылок в файл складывается полное текстовое содержимое страниц в Markdown. Модели не нужно никуда переходить: весь контент уже в одном файле.
| Критерий | llms.txt | llms-full.txt |
|---|---|---|
| Содержимое | Ссылки с пояснениями | Полные тексты страниц |
| Типичный размер | Единицы килобайт | Сотни килобайт — мегабайты |
| Нужны переходы по ссылкам | Да | Нет |
| Риск переполнить контекст | Минимальный | Реальный — файл может не влезть целиком |
| Кому подходит | Любому сайту | В основном документации |
Когда llms-full.txt действительно нужен
- Документация продукта. Главный сценарий: пользователь подключает файл к ИИ-ассистенту или редактору кода, и тот отвечает по актуальной документации без походов в интернет. Так делают, например, Expo и другие проекты для разработчиков.
- База знаний или справочный центр — когда важно, чтобы ассистент поддержки отвечал строго по вашим материалам.
- Небольшие сайты с важным текстом — оферта, условия, методология: всё влезает в один файл и снимает неоднозначность.
Когда он не нужен
- Интернет-магазинам с тысячами товаров — файл получится огромным и мгновенно устареет; достаточно llms.txt с категориями и условиями.
- Сайтам с часто меняющимся контентом — новости, объявления: поддерживать полную копию в актуальном виде дороже, чем она приносит пользы.
- Как замена llms.txt — это дополнение. Сначала базовый файл, потом, при необходимости, полный.
Практическое правило: начните с llms.txt — он нужен всем и делается за минуту. llms-full.txt добавляйте, когда у вас есть документация и пользователи, которые скармливают её ИИ-ассистентам.
Как создать llms-full.txt
- Отберите страницы — те же, что в llms.txt, или их подмножество: только действительно содержательные.
- Конвертируйте в Markdown. Из HTML текст переводят в Markdown любым конвертером; в генераторах документации (Docusaurus, VitePress, Mintlify и других) часто есть готовые плагины, которые собирают llms-full.txt автоматически при сборке.
- Склейте в один файл со структурой: общий H1 и описание сверху, затем каждая страница отдельным разделом со своим заголовком и адресом источника.
- Разместите в корне рядом с llms.txt:
https://ваш-домен/llms-full.txt, и сошлитесь на него из llms.txt.
# TaskFlow — полная документация > Полное содержимое документации TaskFlow одним файлом. ## Быстрый старт Источник: https://example.ru/docs/quickstart/ Чтобы создать рабочее пространство, зарегистрируйтесь и… (полный текст страницы) ## Справочник API Источник: https://example.ru/docs/api/ Аутентификация выполняется по API-ключу в заголовке… (полный текст страницы)
Подводные камни
- Размер против контекста. Файл в несколько мегабайт не влезет в контекстное окно целиком — модели возьмут только начало. Самое важное ставьте выше.
- Актуальность. Полная копия контента устаревает быстрее, чем список ссылок. Автоматизируйте генерацию при публикации изменений.
- Дубли и приватность. В файл попадает только то, что вы туда положили: проверьте, что не выгружаете черновики и закрытые разделы.
Начать всё равно стоит с обычного llms.txt — сгенерируйте его за минуту, проверьте валидатором и загрузите в корень сайта по инструкции.