- [ Главная ](/ru/) / - [ Блог ](/ru/blog/) / - llms.txt для сайтов с документацией # `llms.txt` для сайтов документации Сайты документации — идеальный сценарий для llms.txt. Разработчики постоянно задают ИИ-помощникам вопросы о документации; вот как убедиться, что они получают точные ответы. Последнее обновление: 22 апреля 2026 г. На этой странице - [ Почему сайты документации получают наибольшую пользу ](#why-docs-sites) - [ Что включать ](#what-to-include) - [ Что исключать ](#what-to-exclude) - [ Порядок приоритетов ](#priority-ordering) - [ Автоматическая генерация из навигации ](#auto-generate) - [ Как Mintlify с этим работает ](#mintlify) - [ Пример структуры ](#example) ## Почему сайты документации получают наибольшую пользу Сайты документации, например размещённые на Mintlify, GitBook, Docusaurus или созданные с помощью MkDocs или Nextra, — идеальный вариант использования llms.txt. Причина проста: разработчики регулярно используют ИИ-ассистентов для навигации по документации. Вопросы вроде «как настроить аутентификацию с Acme?», «какие вебхуки поддерживает Acme?» и «покажи SDK Acme для Python» — это вопросы о документации. Когда разработчик задает эти вопросы ИИ-ассистенту, ассистент либо опирается на данные обучения (которые могут быть устаревшими на несколько месяцев), получает актуальное содержимое из интернета или загружает документацию из совместимого процесса, настроенного на получение llms.txt. Во всех трех случаях качество ответа зависит от качества доступной ему документации. llms.txt — это механизм, позволяющий сообщить совместимому клиенту, какие страницы наиболее важны. Для сайта документации такая подборка полезна, когда принимающий процесс известен и его можно проверить. ## Что включить Для сайтов документации в llms.txt неизменно входят следующие типы страниц: - **Руководство по быстрому старту**, первая страница, куда попадают большинство новых пользователей и помощников AI. Она должна проводить по минимальному пути к работающему результату. Если вы включаете только одну страницу, включите эту. - **Основные понятия**, страницы или страниц, объясняющих ментальную модель вашего продукта. Каковы фундаментальные сущности? Как работает модель данных продукта? Какова ключевая терминология? - **Справочник API**, полное описание конечных точек API, параметров и схем ответов. Если это одна длинная страница, добавьте ссылку на верхний уровень. Если страницы разбиты по типам ресурсов, добавьте ссылки на страницы соответствующих ресурсов. - **Руководства по SDK и клиентским библиотекам**, по одной ссылке на каждый официально поддерживаемый язык или платформу. - **Аутентификация и авторизация**, как пользователи и приложения проходят аутентификацию. Один из самых распространённых вопросов к ИИ-ассистентам по документации. - **Часто задаваемые вопросы или руководство по устранению неполадок**, если у вас есть подробный FAQ, на него стоит сослаться. ИИ-помощники смогут точно отвечать с его помощью на распространённые вопросы. - **Журнал изменений**, помогает системам поиска отличать текущее поведение от устаревших обучающих данных. ## Что исключить Не каждая страница вашего сайта документации относится к llms.txt: - **Внутренние заметки или документация команды**, если ваша платформа документации размещает и общедоступную документацию, и внутренние вики команды, включайте только публичную документацию. - **Черновые или скрытые страницы**, страницы, ещё не готовые для пользователей, не должны попадать в llms.txt. ИИ, цитирующий черновую страницу, цитирует то, что вы ещё не одобрили. - **Содержимое с ограниченным доступом**, документацию за стеной входа нельзя получить краулерам ИИ или агентным фреймворкам. Включайте только общедоступные страницы. - **Устаревшая документация**, если вы поддерживаете документацию для старых версий продукта, исключите эти страницы или явно пометьте их. Вы не хотите, чтобы AI-ассистенты обучали пользователей устаревшим шаблонам. - **Очень детализированные подстраницы**, если в вашей документации API есть 200 отдельных страниц конечных точек, не ссылайтесь на все 200. Укажите ссылку на справочник верхнего уровня и позвольте ИИ перейти дальше самостоятельно. llms.txt — слой кураторства, а не карта сайта. - **Маркетинговые или коммерческие страницы**, цены, тематические исследования и страницы сравнения — полезный контент, но это не документация. Если вы их включаете, поместите их в `## Optional` раздел. ## Порядок приоритетов В каждом разделе вашего llms.txt порядок ссылок имеет значение. Клиенты ИИ, которые читают ваш файл, считают расположенные раньше ссылки более приоритетными. При ограниченном размере контекста они могут прекратить чтение на середине файла. Размещайте самые важные страницы первыми. Рекомендуемый порядок приоритетов для сайтов документации разработчика: - Быстрый старт / Начало работы - Основные понятия / Обзор архитектуры - Справочник API (верхнего уровня или наиболее используемого ресурса) - Аутентификация / авторизация - Руководства по SDK (сначала самый используемый язык) - Справочник вебхуков (если применимо) - Устранение неполадок / FAQ - Журнал изменений (в необязательном разделе) - Руководства по миграции (в разделе «Необязательное») Пример Думайте как разработчик, использующий AI-ассистента Лучший способ расставить приоритеты — спросить: «какие вопросы разработчики чаще всего задают AI-ассистентам о моём продукте?» Страницы, отвечающие на эти вопросы, должны находиться в начале llms.txt. Если у вас есть данные внутреннего поиска или обращения в поддержку, используйте их. ## Автоматическая генерация из навигации Для сайтов документации с большим количеством страниц ручное ведение llms.txt непрактично. Лучше автоматически генерировать его во время сборки из структуры документации. Общий подход: - **Используйте конфигурацию навигации как источник.** Большинство платформ документации задают навигацию в конфигурационном файле (sidebar.json, mint.json, mkdocs.yml и т. д.). Эта конфигурация уже представляет ваш отобранный упорядоченный вид документации и естественно подходит как входные данные для генерации llms.txt. - **Отфильтруйте элементы верхнего и второго уровня.** Не включайте каждый конечный узел в дерево навигации. Возьмите разделы верхнего уровня и их непосредственных потомков. Обычно получается 10–30 страниц, что подходит для llms.txt. - **Свяжите каждый элемент с абсолютным URL.** В вашей конфигурации навигации, вероятно, используются относительные пути. Преобразуйте их в абсолютные URL с помощью настроенного базового URL. - **Используйте заголовки страниц как текст ссылок, а описания страниц — как описания ссылок.** Если у страниц есть метаописания, используйте их. Если нет, используйте первый абзац каждой страницы. - **Выведите файл в общедоступный каталог.** Запишите созданный файл туда, где находятся ваши статические файлы, чтобы он был доступен по адресу `/llms.txt`. Выполняйте эту генерацию при каждой сборке документации, чтобы llms.txt автоматически сохранял соответствие структуре навигации. ## Как это реализовано в Mintlify Mintlify — платформа документации, широко используемая компаниями, ориентированными на разработчиков (многие инструменты для разработчиков эпохи ИИ используют её). Mintlify автоматически создаёт оба `llms.txt` и `llms-full.txt` для каждого сайта документации, размещённого на её платформе. Концептуально генерация Mintlify работает так: - Навигация сайта определяется в `mint.json` конфигурации. Этот файл задаёт иерархию страниц, включая страницы, отображаемые в разных разделах боковой панели. - Во время сборки Mintlify читает структуру навигации и создаёт `llms.txt` файл, где каждый элемент навигации становится записью-ссылкой в соответствующем разделе. - Для `llms-full.txt`, Mintlify встраивает полное содержимое Markdown каждой страницы под её ссылкой, предоставляя системам поиска ИИ полный корпус документации в одном файле. - Оба файла развёртываются вместе с сайтом документации и доступны по стандартным путям (`/llms.txt` и `/llms-full.txt`). В результате сайты документации на Mintlify автоматически получают соответствующие спецификации файлы llms.txt без ручной подготовки. Компромисс в том, что файл отражает структуру навигации, а не вручную расставленные приоритеты, поэтому в нём могут оказаться страницы низкого приоритета, которые автор поместил бы в раздел Optional или исключил полностью. Другие платформы документации, GitBook, Docusaurus, ReadMe и прочие, поддерживают llms.txt в разной степени. Проверьте документацию или примечания к выпуску вашей платформы, чтобы узнать текущее состояние поддержки. ## Пример структуры Ниже приведён пример llms.txt для условного сайта документации разработчика. Эта структура подходит большинству сайтов документации продукта с REST API: ``` # Acme Documentation > Acme is a platform for real-time inventory management. This documentation covers the > REST API, SDKs for Python and Node.js, and integration guides for common e-commerce > platforms. The API is used by developers building stock tracking, warehouse management, > and demand forecasting applications. ## Getting started - [Introduction](https://docs.acme.example/introduction/): what Acme is and how it works. - [Quickstart](https://docs.acme.example/quickstart/): create your first integration in five minutes. - [Authentication](https://docs.acme.example/authentication/): API key setup and OAuth 2.0. - [Core concepts](https://docs.acme.example/concepts/): products, locations, stock records, and events. ## API reference - [API overview](https://docs.acme.example/api/): base URL, versioning, and conventions. - [Products](https://docs.acme.example/api/products/): create, read, update, and delete products. - [Stock adjustments](https://docs.acme.example/api/stock/): record stock movements and reconcile inventory. - [Webhooks](https://docs.acme.example/api/webhooks/): event types, payloads, and signature verification. - [Rate limits](https://docs.acme.example/api/rate-limits/): limits by plan tier. - [Errors](https://docs.acme.example/api/errors/): error codes and handling recommendations. ## SDKs - [Python SDK](https://docs.acme.example/sdk/python/): official Python client library. - [Node.js SDK](https://docs.acme.example/sdk/node/): official Node.js client library. ## Optional - [Changelog](https://docs.acme.example/changelog/): release notes and breaking changes. - [FAQ](https://docs.acme.example/faq/): common questions from developers. - [Migration guide (v1 to v2)](https://docs.acme.example/migration/): upgrading from v1. ``` ## Продолжить чтение - [llms.txt для API-продуктов](/ru/blog/llms-txt-for-api-products/), более подробное руководство для продуктов, ориентированных прежде всего на API. - [Руководство по llms-full.txt](/ru/llms-full-txt/), сопутствующий файл с полным корпусом для сайтов документации. - [Как создать llms.txt](/ru/how-to-create/), пошагово, с руководствами по развёртыванию для каждого стека. - [Генератор](/ru/generator/), создайте соответствующий спецификации файл с помощью формы. ## Источники - [ llmstxt.org, предложение сообщества ](https://llmstxt.org/) - [ Документация поддержки llms.txt в Mintlify ](https://www.mintlify.com/docs/ai/llmstxt) - [ Документация Anthropic, реальный пример llms.txt ](https://platform.claude.com/llms.txt)