Формат llms.txt, справочник спецификации

Обзор формата

llms.txt представляет собой текстовый ресурс, использующий Markdown CommonMark. Он может находиться в корне источника или по более специфичному пути, например https://example.com/docs/llms.txt. Наиболее конкретный применимый файл описывает эту область.

Совместимые помощники по программированию, конвейеры RAG и исследовательские агенты могут использовать файл как тщательно отобранную карту. Одна публикация не доказывает обнаружение или использование, поэтому указывайте это с помощью rel="describedby" где это уместно, и измеряйте клиентов, которых вы действительно поддерживаете.

Обязательные элементы

Предложение 08.2026 определяет один обязательный элемент:

1. Заголовок H1, первая строка должна быть H1 (# Name) с названием проекта или сайта.

Сводка в blockquote, пояснительное вступление, списки файлов H2 и примечания к ссылкам необязательны.

# Your Project Name

> One sentence describing what your project does and who it's for.

## Documentation

- [Getting Started](https://example.com/docs/start): Install and first steps.
- [API Reference](https://example.com/api): Full endpoint catalog.

## Optional

- [Changelog](https://example.com/changelog): Release history.

Необязательные разделы

Разделы — это заголовки H2 (##) с последующими неупорядоченными списками ссылок Markdown. Распространённые названия разделов:

• Документация, основная документация, руководства, справочники.
• Продукт, маркетинговые страницы, цены, статус.
• Примеры, примеры кода, учебные материалы, демонстрации.
• Необязательно, журнал изменений, блог, GitHub имеют более низкий приоритет для AI.
• API, отдельный раздел справочника API.
• SDK, библиотеки клиентов для конкретных языков.

Необязательно остаётся понятной редакционной меткой для второстепенных ресурсов, но v2 не приписывает ей особой семантики обработки.

# Acme SaaS

> Acme SaaS helps teams automate their billing workflows with a no-code dashboard
> and a REST API supporting 40+ payment providers.

## Product

- [Overview](https://acme.com/product): Core capabilities and use cases.
- [Pricing](https://acme.com/pricing): Plans, limits, and enterprise options.
- [Status](https://status.acme.com/): Uptime and incident history.

## Documentation

- [Quickstart](https://acme.com/docs/quickstart): Set up in under 5 minutes.
- [API Reference](https://acme.com/docs/api): REST endpoints, auth, rate limits.
- [SDKs](https://acme.com/docs/sdks): Node, Python, Ruby, Go clients.
- [Webhooks](https://acme.com/docs/webhooks): Event payloads and retry policy.

## Examples

- [Node.js integration](https://acme.com/examples/node): End-to-end payment flow.
- [Python integration](https://acme.com/examples/python): Subscription management.

## Optional

- [Changelog](https://acme.com/changelog): Version history.
- [Blog](https://acme.com/blog): Product updates and tutorials.
- [GitHub](https://github.com/acme/acme-oss): Open-source components.

Синтаксис ссылок

Каждая ссылка соответствует синтаксису Markdown - [Title](URL): short description.

• Используйте абсолютные URL включая схему (https://).
• Описание после двоеточия представляет собой обычный текст. Ограничьте его примерно 120 символами и сделайте информативным для ИИ, не наполняйте ключевыми словами.
• Одна ссылка на элемент списка, не вкладывайте маркированные списки.
• Предпочитайте канонические URL-адреса (с завершающей косой чертой, если так принято у вас).

вариант llms-full.txt

В более широкой экосистеме используется необязательный сопутствующий файл /llms-full.txt. Хотя llms.txt — это индекс ссылок, llms-full.txt содержит полный текст всех этих связанных страниц, объединённых и оформленных в Markdown.

Инструмент с явной поддержкой соглашения может запрашивать llms-full.txt для объединённого контекста. Компромисс — больший размер, устаревание и риск для безопасности.

Ознакомьтесь с отдельным Руководство по llms-full.txt для стратегий генерации.

Контрольный список

• Файл, размещённый в корне или по предполагаемому заданному пути
• Тип медиа plain-text или Markdown с кодировкой UTF-8
• Начинается ровно с одного заголовка H1
• Необязательные blockquote и вступление не содержат заголовков
• Цели ссылок корректно разрешаются в контексте публикации
• Необязательные примечания к ссылкам должны быть краткими и фактологичными
• Размер файла оправдан задачами и протестированными клиентами
• Никаких HTML-тегов, никаких вложенных списков
• Проверено с помощью Валидатор llms.txt

Распространённые ошибки

• Относительные URL, - [Docs](/docs) не будет корректно разрешаться, когда файл запрашивает сканер ИИ. Всегда используйте абсолютные URL.
• Отсутствует цитата, это не ошибка соответствия v2. Добавляйте его только когда краткое фактическое резюме помогает целевому клиенту.
• Неправильный Content-Type, обслуживая через text/html или отсутствие content-type приводит к тому, что некоторые парсеры отклоняют файл.
• Описания с переспамом ключевыми словами, ИИ-модели читают их буквально. Перенасыщение ключевыми словами ухудшает сигнал качества.
• Перечисление каждой страницы, отберите 10–30 самых важных ссылок. Используйте sitemap.xml для исчерпывающего обнаружения URL. Сопутствующий llms-full.txt может объединять содержимое для явно совместимых процессов загрузки, но не заменяет карту сайта.

Связанные руководства

• Как создать llms.txt, пошагово для любого стека.
• Руководство по llms-full.txt, файл-спутник с полным содержимым.
• Валидатор, проверьте соответствие файла спецификации.
• Генератор, создайте файл из формы.
• Лучшие практики, что включать, а что пропускать.
• Какие AI-краулеры читают llms.txt, статус внедрения.