llms.txt önerisi nedir?

llms.txt, bir web sitesinin kök dizinine konan ve dil modellerine sitenin ne olduğunu, hangi sayfaların önemli olduğunu kısa bir Markdown belgesiyle anlatmayı amaçlayan bir dosyadır. Fikir 2024’te Jeremy Howard tarafından llmstxt.org üzerinde yayımlandı ve topluluk tarafından geliştirilmeye devam ediyor.

Önemli bir ayrım: llms.txt topluluk tarafından geliştirilen resmî olmayan bir öneridir. Bir erişim izni, robots.txt alternatifi veya yapay zekâ sistemlerinde görünürlük garantisi değildir. Hiçbir arama motoru ya da yapay zekâ şirketi bu dosyayı okuyacağını taahhüt etmek zorunda değildir. Bu araç yalnız dosyayı biçim kurallarına uygun yazmanıza yardım eder; dokümantasyon siteleri, geliştirici ürünleri ve kapsamlı rehber yayımlayan ekipler için düzenli bir içindekiler listesi sunar.

Nasıl kullanılır?

  1. Site veya proje adını girin. Bu, dosyadaki tek H1 başlığı olur.
  2. Siteyi bir iki cümleyle anlatan kısa özeti yazın; alıntı bloğu olarak eklenir.
  3. İsterseniz kullanım notlarını ekleyin. Boş satırla ayrılan her blok ayrı paragraf olur; bu alanda başlık kullanılamaz.
  4. Bağlantı gruplarını yazın: ## Başlık satırı yeni grup başlatır, altındaki her satır Başlık | URL | açıklama biçimindedir. Açıklama isteğe bağlıdır.
  5. Kısa bağlamda atlanabilecek sayfaları İsteğe bağlı kutusuna yazın; bu kutu doluysa en sona ## Optional bölümü eklenir.
  6. Oluştur düğmesine basın, uyarıları inceleyin, ardından dosyayı kopyalayın veya llms.txt olarak indirip sitenizin köküne yükleyin.

İsterseniz llms-full.txt taslağını da açabilirsiniz. Bu taslak her bağlantı için başlık ve kaynak satırı içerir; sayfa içeriğini sizin yapıştırmanız için açık bir yer tutucu bırakır.

Bağlantı grupları ve açıklamalar

Üretilen dosya önerideki sırayı izler: önce # Ad, sonra > özet, ardından başlıksız açıklama paragrafları ve son olarak H2 başlıklı bağlantı listeleri. Her bağlantı - Başlık: açıklama biçiminde yazılır.

  • URL’ler mutlak HTTP veya HTTPS olmalıdır; javascript:, ftp: ya da göreli yol reddedilir ve satır numarasıyla gösterilir.
  • Etiketteki [, ] ve ters eğik çizgi kaçırılır. URL’deki parantez, boşluk ve açılı ayraçlar yüzde kodlamasına çevrilir; böylece bağlantı Markdown’da erken kapanmaz.
  • Türkçe harfler başlık ve etiketlerde aynen korunur, ASCII’ye çevrilmez. URL yolundaki Türkçe harfler tarayıcının standart URL kodlamasıyla yazılır.
  • Bağlantısı olmayan grup ve boş isteğe bağlı kutu gereksiz başlık üretmez; boş grup için uyarı verilir.
  • Aynı URL iki kez girilirse, HTTP bağlantısı varsa veya aynı başlık tekrar ediyorsa uyarı gösterilir.
  • Sonuç, tek H1, konum ve liste biçimi açısından ayrıca yapı denetiminden geçirilir.

Örnek ve yorum

Aşağıdaki girdiyi düşünün: ad Örnek Mobilya, özet El yapımı ahşap mobilya üreten atölye. ve bağlantı alanında şu satırlar:

## İçerik rehberi
Bakım [yağ] rehberi | https://example.com/bakim_(ahsap) | Ahşap bakımı
Ürünler | https://example.com/urunler

Araç şu çıktıyı üretir:

# Örnek Mobilya

> El yapımı ahşap mobilya üreten atölye.

## İçerik rehberi

- [Bakım \[yağ\] rehberi](https://example.com/bakim_%28ahsap%29): Ahşap bakımı
- [Ürünler](https://example.com/urunler)

Başlıktaki Türkçe harfler değişmedi. Etiketteki köşeli ayraçlar kaçırıldığı ve URL’deki parantezler kodlandığı için iki bağlantı da doğru ayrıştırılır. İsteğe bağlı kutu boş olduğu için ## Optional bölümü oluşmadı. Satırlardan birine javascript:alert(1) yazsaydınız dosya üretilmez, ilgili satır hata olarak işaretlenirdi.

robots.txt’den farkı

robots.txt, tarayıcılara hangi yolları taramamaları gerektiğini söyleyen yerleşik bir standarttır ve Google gibi arama motorları tarafından belgelenmiş biçimde yorumlanır. llms.txt ise hiçbir şeyi engellemez veya izin vermez; yalnızca okumayı kolaylaştıran bir özet ve bağlantı listesidir.

Bir yapay zekâ tarayıcısını durdurmak istiyorsanız robots.txt kurallarını kullanın; robots.txt oluşturucu aracı bu iş için ayrı bot seçenekleri sunar. Gizli içerik için parola veya sunucu erişim denetimi gerekir. llms.txt dosyasına bir sayfa eklememek o sayfanın okunmayacağı anlamına gelmez, eklemek de atıf alınacağını garanti etmez.

Sınırlar ve gizlilik

  • En fazla 200 bağlantı ve 100.000 karakterlik çıktı desteklenir; sınır aşılırsa kırpma yapılmaz, açık hata verilir.
  • Sayfalarınız taranmaz, bağlantıların çalışıp çalışmadığı denetlenmez ve sayfaların .md karşılıkları uydurulmaz.
  • Biçim, llmstxt.org önerisinin 28 Eylül 2026’da incelenen v2 sürümüne göre sabitlenmiştir; öneri değişirse araç güncellenir.
  • OpenAI, Google veya başka bir sağlayıcının onayı, eğitimden çıkarma ya da atıf garantisi iddia edilmez.
  • Girdiler tarayıcıda işlenir ve sunucuya gönderilmez. Paylaşım bağlantısına girdileri eklerseniz bağlantıyı alan herkes içeriği görebilir.

Sık sorulan sorular

llms.txt dosyasını nereye koymalıyım?

Öneriye göre dosya sitenin kökünde, örneğin https://example.com/llms.txt adresinde yayımlanır. UTF-8 düz metin olarak sunulması yeterlidir.

llms.txt yapay zekâ botlarını engeller mi?

Hayır. Dosya bir erişim kuralı değildir. Botları engellemek için robots.txt, gizli içerik için sunucu tarafı erişim denetimi kullanılmalıdır.

Optional bölümü ne işe yarar?

Öneride ## Optional başlığı altındaki bağlantılar, kısa bağlam gerektiğinde atlanabilecek ikincil kaynaklar olarak tanımlanır. Kutu boşsa bu başlık hiç üretilmez.

llms-full.txt taslağı neden sayfa içeriğini içermiyor?

Araç sayfalarınıza istek göndermez. Taslak, her bağlantı için başlık ve kaynak satırı ile bir yer tutucu bırakır; içeriği kendiniz yapıştırırsınız.

Türkçe başlıklar sorun çıkarır mı?

Hayır. Markdown UTF-8 metni destekler; İçerik rehberi gibi başlıklar aynen korunur. URL yolundaki Türkçe harfler standart yüzde kodlamasıyla yazılır.

Yayın: · Güncelleme: