llms.txt

Довідник

llms.txt v2: що змінилося

Опубліковано:

Специфікацію llms.txt переглянули в серпні 2026 року — майже через два роки після первісної. Сам формат файлу не змінився: файл, написаний за v1, лишається валідним файлом v2. Змінилося все навколо файлу: як агенти його знаходять і якого інструментарію очікує специфікація.

Формат незмінний

Обов'язкова структура точно така, як була: необов'язковий BOM, заголовок H1 з назвою проєкту (досі єдиний обов'язковий елемент), блок-цитата з підсумком, необов'язковий текст без заголовків, далі нуль або більше секцій H2 зі списками посилань у Markdown. Якщо ваш файл давав 100 за v1 — він і далі дає 100.

1. Link-relations, щоб агенти перестали вгадувати

Це головне доповнення, і воно відповідає на найчастіший запит за два роки використання: маючи сторінку, як агент знайде її Markdown-версію або той llms.txt, що її покриває, не вгадуючи URL?

v2 відповідає двома стандартними link-relations:

Кожну можна подати як HTML-елемент <link>:

<link rel="describedby" href="/llms.txt">
<link rel="alternate" type="text/markdown" href="/docs/page.html.md">

…або як HTTP-заголовок відповіді — це єдиний варіант для не-HTML ресурсів, як-от самі Markdown-файли, і його можна прописати в конфігурації веб-сервера чи CDN, не торкаючись жодної сторінки:

Link: </docs/page.html.md>; rel="alternate"; type="text/markdown", </docs/llms.txt>; rel="describedby"

Якщо ви раніше йшли за порадою оголошувати файл через rel="alternate" type="text/plain" — зокрема з ранніх версій наших власних посібників — замініть це на rel="describedby". Це була розумна конвенція, поки в специфікації своєї не було; тепер вона є.

2. Обидві форми URL з .md тепер дозволені

v1 задавала одну форму URL для Markdown-двійника сторінки: .md дописане до повного URL, тож page.html ставало page.html.md. На практиці частина інструментів публікації натомість замінювала розширення, даючи page.md. v2 благословила обидві. Для URL без імені файлу дописуйте index.html.md або index.md.

Міграції тут не потрібно — та форма, яку ви вже віддаєте, тепер правильна.

3. Файли в підшляхах нарешті визначені

v1 дозволяла llms.txt поза коренем, але ніколи не казала, що це означає. v2 визначає: файл покриває сторінки під своїм шляхом, а якщо підходить кілька — агенти беруть найспецифічніший. Тобто /docs/llms.txt покриває все під /docs/, і агент, що читає сторінку документації, віддає йому перевагу перед кореневим файлом.

Це важливо для всіх, хто контролює шлях, але не хост — сайт проєкту на GitHub Pages, розділ документації на спільному домені — і саме тому специфікація тримається звичайного імені файлу, а не /.well-known/, який існує лише в корені origin.

Практичний висновок: якщо агентам цікава саме ваша документація, окремий /docs/llms.txt тепер повноцінний вибір, а не сіра зона.

4. Інструментарій розгортання контексту прибрано (а «Optional» втратила механіку)

v1 описувала llms_txt2ctx — інструмент, що розгортав llms.txt в один контекст для моделі. v2 від нього відмовляється і замість цього прямо формулює очікування: агенти дивляться або шукають у llms.txt, а потім переходять за потрібними посиланнями — отже посилання мають вести на контент, дружній до моделей, а сам файл лишається достатньо малим, щоб уміститися в контекст.

Разом із тим інструментарієм зникає механічний сенс секції ## Optional, яка існувала, щоб казати таким інструментам, що пропускати. Секції Optional досі дозволені й досі корисна конвенція для другорядних посилань, які агент може пропустити — просто вони більше нічого не запускають автоматично.

Зверніть увагу: llms-full.txt ніколи не був частиною специфікації — ні в першій версії, ні в другій. Це поширена індустріальна практика, і добра для великих наборів документації — просто не вважайте її вимогою.

Що зробити цього тижня

  1. Додайте rel="describedby" з посиланням на ваш llms.txt — один рядок у шаблоні або одне правило заголовка в CDN.
  2. Якщо ви публікуєте Markdown-двійники, оголосіть їх через rel="alternate" type="text/markdown".
  3. Замініть будь-яку підказку rel="alternate" type="text/plain" на rel="describedby".
  4. Якщо документація — найцінніша частина, розгляньте окремий /docs/llms.txt для неї.
  5. Проженіть валідатор ще раз — він тепер повідомляє, чи ваші сторінки оголошують relations з v2, і йде за файлами в підшляхах так, як v2 приписує агентам.

Чому взагалі знадобився перегляд

Бо передумова перестала бути припущенням. Коли llms.txt пропонували у вересні 2024 року, «агенти читатимуть ваш сайт» було прогнозом. Сьогодні документаційні платформи генерують цей файл автоматично, Lighthouse у Chrome перевіряє його наявність у межах своїх перевірок agentic browsing, а самі AI-лабораторії публікують llms.txt для власної документації для розробників. v2 — це те, як виглядає пропозиція після того, як її припущення перевірило справжнє поширення.

Продовжити читання

Перевірте свій llms.txt →