llms.txt nedir, nasıl hazırlanır?

llms.txt, bir sitenin kök dizininde /llms.txt adresinde yayınlanan, Markdown biçiminde yazılmış bir içerik haritasıdır. Dosya, siteyi bir başlıkla tanıtır, bir cümlelik özet verir ve önemli sayfaları kısa açıklamalarla listeler.

Dosyanın amacı, bir dil modeline siteyi baştan sona taratmadan sitenin ne olduğunu ve nerede ne bulunduğunu anlatmaktır. HTML sayfalarında gezinme menüsü, reklam ve şablon metni gibi gürültü bulunur; llms.txt bu gürültüyü tamamen dışarıda bırakır.

Biçim serbest değildir ama katı da değildir. Yaygın kalıp şudur: birinci düzey başlıkta site adı, hemen altında tek satırlık alıntı biçiminde özet, ardından ikinci düzey başlıklarla gruplanmış bağlantı listeleri. Her bağlantı satırı, bağlantının ardından iki nokta üst üste ve tek cümlelik açıklama içerir.

llms.txt bir erişim kontrol dosyası değildir. İçine yazılan hiçbir şey bir botu engellemez veya bir sayfayı gizlemez; erişim kontrolü robots.txt ve HTTP başlıklarının işidir.

Üç dosya üç ayrı soruyu cevaplar ve birbirinin yerine geçmez. robots.txt “neye erişebilirsin” sorusunu, sitemap.xml “hangi adresler var” sorusunu, llms.txt ise “bu adreslerde ne var ve neden önemli” sorusunu cevaplar.

Bir sitede üçünün de bulunması gerekir. Yalnızca llms.txt yayınlamak, botların siteye erişimini sağlamaz; yalnızca sitemap yayınlamak ise adres listesi verir ama anlam vermez.

En değerli bölüm, dosyanın ilk on satırıdır. Kurum adı, ne yaptığı, kime hizmet verdiği ve nerede olduğu bu satırlarda net biçimde yazılmalıdır; modelin varlık çözümlemesi için ihtiyaç duyduğu bilgi budur.

İkinci değerli bölüm doğrulanabilir kurum bilgileridir. E-posta, telefon, adres ve varsa bağlı olunan ana kuruluş açıkça yazılmalıdır. Farklı bir alan adından e-posta kullanılıyorsa bu ilişki açıklanmalıdır, aksi hâlde model iki ayrı varlık görür.

Üçüncü bölüm sayfa dizinidir. Her bağlantıya tek cümlelik açıklama eklenir ve açıklama sayfanın gerçekten ne içerdiğini söyler; pazarlama sloganı yerine içerik tarifi yazılır.

Fiyat, kapsam ve süre gibi sayısal bilgiler dosyada açıkça yer almalıdır. Modeller sayısal ve doğrulanabilir bilgiyi belirgin biçimde daha çok alıntılar; “uygun fiyatlı” ifadesi hiçbir cevaba giremez.

llms.txt elle yazıldığında kaçınılmaz olarak eskir. Fiyat, paket kapsamı veya sayfa listesi değiştiğinde dosyayı güncellemeyi hatırlamak gerekir ve bu adım pratikte atlanır.

Doğru yaklaşım, dosyayı sitenin içerik kaynağından üretmektir. İçerik tek bir kaynakta tutuluyorsa, llms.txt ve llms-full.txt aynı kaynaktan derleme anında üretilebilir; böylece fiyat değiştiğinde dosya kendiliğinden güncellenir.

llms-full.txt ayrı bir dosyadır ve sitedeki metnin tamamını düz metin olarak içerir. Amacı, bir modelin siteyi tek istekle bağlam penceresine alabilmesidir; sayfa sayfa gezinmeye gerek kalmaz.

Her iki dosya da text/plain olarak sunulmalı ve makul bir önbellek süresiyle yayınlanmalıdır. HTML olarak sunulan bir llms.txt, düz metin bekleyen istemcilerde işe yaramaz.

Hiçbir motor llms.txt dosyasını okuduğunu veya sıralamada dikkate aldığını taahhüt etmemiştir. Dosyanın sıralama etkisi konusunda doğrulanmış bir veri yoktur ve bunu iddia eden içeriklere temkinli yaklaşmak gerekir.

Buna karşılık dosyanın maliyeti çok düşük, riski ise sıfırdır. Otomatik üretildiğinde bakım yükü yoktur ve yanlış yapılandırılması siteye zarar vermez.

Ölçülebilir dolaylı faydası vardır: kurum bilgilerini tek yerde, net ve makine okunur biçimde beyan etmek, kullanıcı sitenizi bir modele okuttuğunda alınan cevabın doğruluğunu belirgin biçimde artırır.

Doğru beklenti şudur: llms.txt bir sıralama aracı değil, bir netlik aracıdır. Görünürlüğü asıl artıran şey cevap odaklı içerik, yapısal veri ve kaynaklar arası tutarlılıktır.