llms.txt v2: neler değişti
Yayınlandı:
llms.txt önerisi, ilkinden neredeyse iki yıl sonra, Ağustos 2026'da revize edildi. Dosya biçiminin kendisi değişmedi — v1 dosyası hâlâ geçerli bir v2 dosyasıdır. Değişen şey, dosyanın çevresindeki her şey: ajanların onu nasıl bulduğu ve spesifikasyonun hangi araçları beklediği.
Biçim değişmedi
Gerekli yapı tam olarak eskisi gibi: isteğe bağlı bir BOM, proje adını taşıyan bir H1 (hâlâ tek zorunlu öğe), blok alıntı biçiminde bir özet, isteğe bağlı başlıksız düz metin ve ardından Markdown bağlantı listeleri içeren sıfır veya daha fazla H2 bölümü. Dosyanız v1'e göre 100 alıyorsa, hâlâ 100 alır.
1. Bağlantı ilişkileri: ajanlar artık tahmin etmesin
Asıl ekleme bu ve iki yıllık kullanımın en sık gelen talebini karşılıyor: bir sayfa verildiğinde ajan, o sayfanın Markdown sürümünü ya da onu kapsayan llms.txt dosyasını URL tahmin etmeden nasıl bulacak?
v2 bunu iki standart bağlantı ilişkisiyle yanıtlıyor:
rel="describedby"— bu sayfayı kapsayan llms.txt dosyasını gösterir.rel="alternate" type="text/markdown"— bu sayfanın Markdown sürümünü gösterir.
İkisi de HTML <link> öğesi olabilir:
<link rel="describedby" href="/llms.txt"> <link rel="alternate" type="text/markdown" href="/docs/page.html.md">
… ya da bir HTTP yanıt başlığı olabilir; Markdown dosyalarının kendisi gibi HTML olmayan kaynaklar için tek seçenek budur ve tek bir sayfaya dokunmadan web sunucusu veya CDN yapılandırmasında ayarlanabilir:
Link: </docs/page.html.md>; rel="alternate"; type="text/markdown", </docs/llms.txt>; rel="describedby"
Daha önce dosyayı rel="alternate" type="text/plain" ile duyurma tavsiyesine uyduysanız — bizim eski rehberlerimiz de dahil — bunu rel="describedby" ile değiştirin. Spesifikasyonun kendi ilişkisi yokken makul bir gelenekti; artık var.
2. Artık iki .md URL biçimi de kabul ediliyor
v1, bir sayfanın Markdown ikizi için tek bir URL biçimi belirliyordu: tam sayfa URL'sine .md eklenmesi, yani page.html için page.html.md. Uygulamada bazı yayınlama araçları uzantıyı değiştirerek page.md üretti. v2 ikisini de onaylıyor. Dosya adı içermeyen URL'lerde index.html.md veya index.md ekleyin.
Burada taşınacak bir şey yok — hâlihazırda ürettiğiniz biçim artık doğru.
3. Alt yollardaki dosyalar düzgün tanımlandı
v1, kök dışında bir llms.txt bulunmasına izin veriyor ama bunun ne anlama geldiğini söylemiyordu. v2 tanımlıyor: bir dosya, kendi yolunun altındaki sayfaları kapsar ve birden fazlası geçerliyse ajanlar en özgül olanı kullanır. Yani /docs/llms.txt, /docs/ altındaki her şeyi kapsar ve bir dokümantasyon sayfasını okuyan ajan onu kök dosyaya tercih eder.
Bu, bir yolu denetleyip bir ana makineyi denetlemeyen herkes için önemli — GitHub Pages proje sitesi, paylaşımlı alan adındaki bir dokümantasyon bölümü — ve spesifikasyonun yalnızca origin kökünde var olabilen /.well-known/ yerine geleneksel bir dosya adında kalmasının nedeni de bu.
Pratik sonuç: ajanların ilgilendiği kısım dokümantasyonunuzsa, ona özel bir /docs/llms.txt artık gri alan değil, birinci sınıf bir seçenek.
4. Bağlam genişletme araçları çıktı (ve «Optional» mekaniğini yitirdi)
v1, bir llms.txt dosyasını tek bir LLM bağlamına genişleten llms_txt2ctx aracını tanımlıyordu. v2 bunu bırakıyor ve beklentiyi doğrudan ifade ediyor: ajanlar llms.txt dosyasını görüntüler veya içinde arama yapar, sonra ihtiyaç duydukları bağlantıları izler — dolayısıyla bağlantılar LLM dostu içeriğe işaret etmeli ve dosyanın kendisi bağlama sığacak kadar küçük kalmalı.
O araçla birlikte, bu araçlara neyi atlayacaklarını söylemek için var olan ## Optional bölümünün mekanik anlamı da gidiyor. Optional bölümlerine hâlâ izin veriliyor ve bir ajanın atlayabileceği ikincil bağlantılar için hâlâ yararlı bir gelenek — sadece artık otomatik hiçbir şeyi tetiklemiyorlar.
llms-full.txt dosyasının hiçbir sürümde spesifikasyonun parçası olmadığını unutmayın. Yaygın benimsenmiş bir sektör pratiğidir ve büyük dokümantasyon kümeleri için iyi bir fikirdir — yalnızca bir zorunluluk gibi görmeyin.
Bu hafta somut olarak ne yapmalı
- llms.txt dosyanızı gösteren
rel="describedby"ekleyin — şablonunuzda tek satır ya da CDN'de tek bir başlık kuralı. - Markdown ikizleri yayınlıyorsanız bunları
rel="alternate" type="text/markdown"ile duyurun. - Her
rel="alternate" type="text/plain"ipucunurel="describedby"ile değiştirin. - Değerli kısım dokümantasyonunuzsa, ona özel bir
/docs/llms.txtdüşünün. - Doğrulayıcıyı yeniden çalıştırın — artık sayfalarınızın v2 ilişkilerini duyurup duyurmadığını bildiriyor ve alt yollardaki dosyaları v2'nin ajanlar için öngördüğü biçimde izliyor.
Revizyon neden gerekti
Çünkü varsayım artık spekülasyon değil. llms.txt Eylül 2024'te önerildiğinde «ajanlar web sitenizi okuyacak» bir öngörüydü. Bugün dokümantasyon platformları dosyayı otomatik üretiyor, Chrome'un Lighthouse'u agentic browsing denetimleri kapsamında siteleri bu dosya için denetliyor ve yapay zekâ laboratuvarları kendi geliştirici dokümantasyonları için llms.txt yayınlıyor. v2, varsayımları gerçek benimsenmeyle sınandıktan sonra bir önerinin aldığı hâl.