Czym jest llms.txt i komu służy

llms.txt to plik Markdown w katalogu głównym strony (albo w podkatalogu, np. /docs/llms.txt), który w kilku akapitach i listach linków mówi agentowi AI, czym jest strona i gdzie szukać szczegółów. Zaproponował go Jeremy Howard we wrześniu 2024 r., a w sierpniu 2026 r. ukazała się druga wersja specyfikacji na llmstxt.org.

Z pliku korzystają przede wszystkim agenci, którzy w trakcie zadania szukają informacji: asystent programisty czytający dokumentację albo czat sprawdzający ofertę firmy. Według specyfikacji plik służy głównie do odpowiadania na bieżące pytania, a nie do trenowania modeli.

Uwaga: llms.txt nie poprawia pozycji w Google. W dokumentacji funkcji AI w wyszukiwarce Google pisze, że do pojawienia się w AI Overviews i AI Mode nie trzeba tworzyć nowych plików czytelnych dla maszyn ani „plików tekstowych dla AI”. Lighthouse w Chrome sprawdza plik w audycie przeglądania przez agentów: zgłasza błąd serwera przy jego pobieraniu, a brak pliku (kod 404) oznacza jako nie dotyczy.

Format według specyfikacji v2

Plik ma ściśle określoną kolejność elementów. Walidator sprawdza każdy z nich.

  1. Nagłówek H1 z nazwą strony albo projektu. To jedyny wymagany element.
  2. Cytat (wiersz zaczynający się od „>”) z krótkim opisem: najważniejsze informacje potrzebne do zrozumienia reszty pliku.
  3. Dowolna liczba akapitów i list bez nagłówków, z dodatkowym kontekstem.
  4. Sekcje z nagłówkiem H2, a w nich listy linków w formacie - [nazwa](adres): opis. Opis po dwukropku jest opcjonalny, ale pomaga agentowi wybrać właściwy link.

Sekcja „Optional” jest w wersji 2 zwykłą konwencją dla linków drugorzędnych. Wersja 1 nadawała jej specjalne znaczenie dla narzędzi, które z niej rezygnowały przy krótkim kontekście.

Co zmieniła wersja 2

  • Odnośnik do pliku. Strona może wskazać swój plik przez <link rel="describedby" href="/llms.txt"> albo nagłówek HTTP Link. Walidator sprawdza to na stronie głównej.
  • Wersje Markdown stron. Specyfikacja proponuje czysty Markdown pod tym samym adresem z końcówką .md (np. /oferta.html.md) i odnośnik rel="alternate" type="text/markdown". Linki w llms.txt powinny prowadzić właśnie do takich wersji, jeśli istnieją.
  • Pliki w podkatalogach. Plik opisuje adresy pod swoją ścieżką, a gdy pasuje kilka plików, agent wybiera najbardziej szczegółowy.