llms.txt ve llms-full.txt nedir, nasıl yazılır, kim okur?

llms.txt nedir?

llms.txt

Sitenin kök dizininde (/llms.txt) duran, Markdown biçiminde yazılmış bir site özetidir. Yapay zekâ araçlarına hangi sayfada ne olduğunu kısa ve düzenli biçimde anlatır.

llms-full.txt

Aynı dizinde duran ikinci dosyadır. Sitenin önemli içeriğinin tamamını tek bir Markdown dosyasında birleştirir; araç tek istekle bütün metne ulaşır.

Öneri, Eylül 2024'te llmstxt.org adresinde yayımlandı. Yazarı, Answer.AI kurucu ortağı Jeremy Howard'dır. Amaç basitti: bir web sayfası insan için tasarlanır, menü, reklam, çerez uyarısı ve script ile dolar. Dil modeli ise sınırlı bir bağlam penceresiyle çalışır ve bu gürültüyü ayıklamak zorunda kalır.

llms.txt, siteyi yapay zekâ araçlarına kendi diliyle, temiz metin olarak tanıtan bir kapı dosyasıdır. Sitemap.xml nasıl arama motoruna sayfa listesi veriyorsa, llms.txt de dil modeline “bu site ne anlatır, nereye bakmalısın” bilgisini verir. Fark şu: sitemap yalnızca URL listeler, llms.txt açıklama ve öncelik de taşır.

Bu dosya robots.txt'in yerini almaz. robots.txt erişimi düzenler; llms.txt içeriği tanıtır. İkisi birlikte çalışır: önce botlara kapıyı açarsınız, sonra llms.txt ile içeriyi anlatırsınız. Botlara kapının nasıl açılacağını yapay zekâ botlarına site nasıl açılır rehberinde ayrıca anlattık.

llms.txt dosyasını kim okur?

Dürüst cevap: standart gönüllüdür ve henüz gençtir. Bugün en yaygın kullanıcıları geliştirici dokümantasyon siteleridir; Anthropic ve Cloudflare gibi şirketlerin dokümantasyon siteleri llms.txt yayımlar ve birçok dokümantasyon platformu bu dosyayı otomatik üretir.

Büyük arama ürünleri llms.txt'yi resmî bir sıralama sinyali olarak tanımadı. Google tarafı dosyayı kullanmadığını açıkça belirtti. Dolayısıyla llms.txt'nin tek başına sizi ChatGPT'de ya da Google AI Bakışı'nda öne çıkardığı iddiası doğru değildir.

Buna rağmen dosyanın pratik okuyucuları vardır: kullanıcı adına sayfa getiren ajanlar, kod asistanları, özel RAG kurulumları ve bir kullanıcının ChatGPT'ye ya da Claude'a site adresini yapıştırdığı anlar. Bu senaryolarda temiz Markdown, gürültülü HTML'den her zaman daha iyi anlaşılır.

llms.txt'nin maliyeti düşük, olası faydası gerçektir; bu yüzden kurulmasını tavsiye ederiz, ama ondan sihir beklemeyiz. Asıl görünürlük; bot erişimi, yapısal veri ve alıntılanabilir içerikle gelir. Bu bütünün nasıl kurulduğunu Yapay Zekâ Aramasında Görünmek rehberinde anlatıyoruz.

llms.txt nasıl yazılır?

llmstxt.org standardı dosyanın biçimini sabitler. Sıra önemlidir; çünkü dosyayı okuyan araç, bölümleri bu sıraya göre ayrıştırır.

1. 1Dosyanın ilk satırı tek bir H1 başlıktır ve zorunludur. Genellikle site ya da firma adı yazılır.
2. 2Hemen altına bir blockquote (> ile başlayan) kısa özet gelir. Bir-iki cümleyle site ne anlatır, kime hitap eder sorusuna cevap verir.
3. 3İsteğe bağlı olarak başlıksız birkaç paragraf veya liste eklenebilir. Burada bağlam verilir: hizmet bölgesi, uzmanlık alanı, sitenin yapısı.
4. 4Sonra H2 başlıklarla bölümler açılır. Her bölüm, Markdown bağlantı listesinden oluşur: - Sayfa adı: bir cümle açıklama.
5. 5En sona isteğe bağlı bir “Optional” bölümü eklenebilir. Araç bağlam penceresi dolduğunda bu bölümü atlayabilir; ikincil içerik buraya konur.

Bir hizmet işletmesi için iskelet şöyle görünür:

• # Firma Adı — tek H1, dosyanın ilk satırı
• > Firma ne yapar, nerede hizmet verir, kime hitap eder — iki cümlelik blockquote
• ## Hizmetler — her satır: - Hizmet adı: tek cümle açıklama
• ## Rehberler — sitenin teknik/bilgi içerikleri, aynı biçimde
• ## İletişim ve kurumsal — hakkımızda, iletişim, yasal sayfalar
• ## Optional — eski blog yazıları, ikincil sayfalar

Bağlantılar mutlaka tam URL olmalıdır; göreli yol (/hizmetler/x) dosya başka bağlamda okunduğunda kırılır. Açıklamalar sitedeki gerçek içerikle birebir uyumlu olmalıdır. llms.txt'de yazan hizmeti sitede bulamayan araç, dosyaya güvenmeyi bırakır.

llms-full.txt ne zaman gerekir?

llms-full.txt, sitenin önemli sayfalarının tam metnini tek Markdown dosyasında birleştirir. Büyük dokümantasyon siteleri için neredeyse zorunludur; araç tek istekle bütün bilgiye ulaşır.

Küçük bir hizmet sitesi için de anlamlıdır. Sayfa sayısı azsa içeriğin tamamı rahatça sığar ve araç, hizmet detaylarını menülerden ayıklamak zorunda kalmaz. Şart olan, dosyanın güncel kalmasıdır: en sağlıklı yöntem, llms-full.txt'nin her derlemede (build) sayfa içeriğinden otomatik üretilmesidir. Elle kopyalanan dosya birkaç güncelleme sonra siteyle çelişmeye başlar.

Sık yapılan hatalar nelerdir?

• Dosyayı alt klasöre koymak: standart kök dizini (/llms.txt) bekler; /docs/llms.txt çoğu araç tarafından aranmaz.
• Markdown yerine HTML ya da düz reklam metni yazmak: dosya okunabilir ama amacını kaybeder.
• Pazarlama sloganlarıyla doldurmak: araç, cevabına taşıyacağı somut bilgi arar; “sektörün lideri” gibi cümleler işe yaramaz.
• Sitedeki içerikle çelişen bilgi vermek: farklı telefon, farklı hizmet listesi, eski adres.
• Dosyayı bir kez yazıp unutmak: yeni hizmet sayfası eklendiğinde llms.txt güncellenmezse eksik harita sunulur.
• robots.txt'te yapay zekâ botlarını engelleyip llms.txt yayımlamak: kapıyı kapatıp içeride tabela asmak gibidir.
• Yalnızca URL listelemek: açıklamasız bağlantı, sitemap'ten farksızdır; her satıra tek cümle açıklama eklenmelidir.

Yazdığınız dosyayı test etmenin en basit yolu, adresini bir yapay zekâ aracına yapıştırıp “bu site ne yapıyor, hangi hizmetleri veriyor?” diye sormaktır. Aracın cevabı sitenizi doğru anlatıyorsa dosya işini görüyordur.

llms.txt tek başına bir parça; bütünü SEO / GEO / AEO hizmeti sayfasında, diğer parçaları yapısal veri rehberinde ve rehber merkezinde bulabilirsiniz.