Eksiksiz llms.txt Kılavuzu (Örneklerle): Biçim, Barındırma ve Yapay Zeka Tarayıcıları Nasıl Kullanır

llms.txt, alan adınızın köküne (https://yourdomain.com/llms.txt) yerleştirdiğiniz ve yapay zeka modellerine en önemli içeriğinizin temiz, seçilmiş bir haritasını veren düz metin Markdown dosyasıdır. Bu, Answer.AI'dan Jeremy Howard tarafından Eylül 2024'te tanıtılan önerilen bir kuraldır — resmi bir web standardı değildir — ve şu anda hiçbir büyük yapay zeka sağlayıcısı onu okuduklarını ya da bir tane bulundurmanın sıralamalarınızı iyileştirdiğini garanti etmez.

Bu baştaki dürüstlük önemlidir, çünkü çoğu llms.txt kılavuzu onu aşırı över. Bu kılavuz, dosyayı tam olarak nasıl yazacağınızı, nerede barındıracağınızı, robots.txt ve sitemap.xml ile nasıl ilişkili olduğunu ve bugün gerçekçi olarak neyi yapıp neyi yapmadığını gösterecek. Daha geniş stratejik resmi istiyorsanız, bununla birlikte web sitenizi yapay zekada keşfedilebilir yapma kılavuzumuzu okuyun.

llms.txt Nedir ve Hangi Sorunu Çözer?

Büyük bir dil modelinin siteniz hakkında bilgiye ihtiyacı olduğunda iki sorunla karşılaşır. Birincisi, HTML sayfaları gürültülüdür: gezinme menüleri, çerez afişleri, reklamlar, JavaScript ve alt bilgiler gerçek içeriği gömer. İkincisi, modeller sınırlı bir bağlam penceresi içinde çalışır, dolayısıyla tüm sitenizi alamazlar. Karmaşık HTML'i çıkarım zamanında temiz sinyale dönüştürmek pahalı ve hataya açıktır.

llms.txt, seçimi model için yaparak buna çözüm sunar. Bir tarayıcının hangi sayfaların önemli olduğunu tahmin etmesine izin vermek yerine, temel kaynaklarınızı sade dille açıklamalarla listeleyen kısa, yapılandırılmış bir Markdown belgesi verirsiniz. Bunu, pikselleri işleyen tarayıcılar için değil, metin okuyan makineler için özel olarak yazılmış bir içindekiler tablosu olarak düşünün.

Kapsam konusunda kesin olmakta fayda var. llms.txt, çıkarım zamanı getirmesine yöneliktir — bir yapay zeka asistanının bir soruyu yanıtladığı ve ürününüz, belgeleriniz ya da politikalarınız hakkında ilgili, güncel bilgi çekmek istediği an. Bir eğitim verisi kontrol mekanizması olarak tasarlanmamıştır. O iş hâlâ robots.txte ve daha yeni yapay zekaya özgü tarayıcı yönergelerine aittir.

llms.txt Dosya Biçimi

Belirtim, basit, insanca okunabilir bir Markdown yapısı tanımlar. Zorunlu bir kısmı ve birkaç isteğe bağlı kısmı vardır ve sıralama sabittir, böylece ayrıştırıcılar ona güvenebilir.

Biçim, sırasıyla:

1. Projenin veya sitenin adını taşıyan bir H1. Bu, kesinlikle zorunlu olan tek satırdır.
2. Kısa bir özet içeren bir alıntı bloğu (>). Sitenin veya projenin ne olduğunu açıklayan bir iki cümle. İsteğe bağlı ama şiddetle önerilir.
3. Sıfır veya daha fazla paragraf ek bağlam (başlık olmadan), bir modelin dosyanın geri kalanını yorumlaması için ihtiyaç duyduğu ayrıntı.
4. H2 bölümleri, her biri bir Markdown bağlantı listesi içeren. Her liste öğesi bir köprüdür, isteğe bağlı olarak bir iki nokta ve kısa bir açıklama ile takip edilir.
5. Bir ## Optional bölümü. Buradaki bağlantılar açıkça atlanabilir olarak işaretlenmiştir — dar bir bağlam bütçesine sahip bir model, esas hiçbir şey kaybetmeden bunları düşürebilir.

Temel tasarım seçimi, her şeyin standart Markdown olmasıdır. Bu, aynı dosyanın bir metin düzenleyicide bir insan tarafından okunabilir ve bir model tarafından önemsizce ayrıştırılabilir olması anlamına gelir, çünkü LLM'ler zaten Markdown'da akıcıdır.

Tamamlayıcı Kalıp: llms-full.txt ve .md Sayfaları

llms.txt ile birlikte sıklıkla iki ilgili kural ortaya çıkar:

• llms-full.txt — yalnızca bağlantıları değil, gerçek tam metin içeriğini barındıran tek, daha büyük bir dosya. Bir modelin her şeye tek bir getirmede sahip olmasını istediğinizde, çok daha büyük bir dosya pahasına kullanışlıdır.
• Sayfaların temiz .md sürümleri — herhangi bir HTML sayfasının Markdown kopyasını aynı URL'de .md eklenmiş olarak sunma pratiği (örneğin about.html.md). llms.txtnizdeki bağlantılar bu temiz sürümlere işaret edebilir, böylece bir model asla HTML ayrıştırmak zorunda kalmaz.

Çalışılmış Örnek Dosyalar

İşte küçük bir SaaS ürünü için asgari bir llms.txt. Bu, herkesin üretebilmesi gereken temel çizgidir.

# Acme Analytics

> Acme Analytics is a privacy-first web analytics tool for small
> teams. It is cookieless, GDPR-compliant, and self-hostable.

Acme replaces heavyweight analytics suites with a single lightweight
script. Pricing is flat-rate per site with no event caps.

## Docs

- [Quick Start](https://acme.example/docs/quickstart.md): Install the
  script and see your first data in under five minutes.
- [API Reference](https://acme.example/docs/api.md): Full REST API for
  querying metrics programmatically.
- [Self-Hosting Guide](https://acme.example/docs/self-host.md): Run
  Acme on your own infrastructure with Docker.

## Product

- [Features](https://acme.example/features.md): What Acme measures and
  how it protects visitor privacy.
- [Pricing](https://acme.example/pricing.md): Flat monthly pricing per
  tracked site.

## Optional

- [Changelog](https://acme.example/changelog.md): Release history.
- [Company](https://acme.example/about.md): Team and founding story.

İkinci bir örnek, bu kez bir yazılım ürünü yerine yerel bir hizmet işletmesi için. Açıklamaların, bir yapay zeka asistanının bir müşteri sorusunu doğrudan yanıtlamak için ihtiyaç duyacağı olguları nasıl taşıdığına dikkat edin.

# Harbor Dental Clinic

> Harbor Dental is a family dental practice in Portland, Oregon,
> offering general, cosmetic, and emergency dentistry since 2004.

## Services

- [General Dentistry](https://harbordental.example/general.md):
  Cleanings, fillings, crowns, and preventive care.
- [Emergency Care](https://harbordental.example/emergency.md):
  Same-day appointments for pain, breaks, and lost fillings.
- [Cosmetic Dentistry](https://harbordental.example/cosmetic.md):
  Whitening, veneers, and Invisalign.

## Visit

- [Hours & Location](https://harbordental.example/contact.md): Open
  Mon-Fri 8am-5pm at 120 Harbor St, Portland OR 97201.
- [New Patients](https://harbordental.example/new-patients.md):
  Insurance accepted, intake forms, and what to expect.

## Optional

- [Patient Reviews](https://harbordental.example/reviews.md)
- [Blog](https://harbordental.example/blog.md)

Üçüncüsü, hâlâ geçerli olan mutlak asgariye indirgenmiş — bir H1 ve bir bölüm. Bu meşrudur; kullanılabilir bir dosyaya sahip olmak için her bölüme ihtiyacınız yoktur.

# Jane Doe — Freelance Illustrator

> Editorial and children's book illustrator based in Berlin,
> available for commissions.

## Links

- [Portfolio](https://janedoe.example/work.md): Selected published work.
- [Rates & Contact](https://janedoe.example/contact.md): Commission
  pricing and how to get in touch.

Nerede Barındırılır

Dosyayı alan adınızın kökünde barındırın: https://yourdomain.com/llms.txt. Bu, tıpkı robots.txt gibi, kuralın belirttiği tek konumdur. Bir alt dizine koymayın ve yeniden adlandırmayın — araçlar tam olarak o yolu arar.

Birkaç pratik barındırma notu:

• Onu text/plain (veya text/markdown) içerik türüyle sunun; çoğu statik barındırıcı bunu .txt dosyası için otomatik yapar.
• Kanonik URL'de HTTP 200 döndürdüğünden ve kimlik doğrulama, coğrafi engelleme veya bir robots.txt disallow kuralıyla engellenmediğinden emin olun.
• Birden fazla alt alan adı çalıştırıyorsanız (örneğin docs. ve app.), her alt alan adı o ana kapsamlanmış kendi llms.txtine sahip olabilir.
• Onu sürüm kontrolünde tutun ve önemli URL'leriniz değiştiğinde, tıpkı bir site haritasını sürdürdüğünüz gibi güncelleyin.

llms.txt, robots.txt ve sitemap.xml'den Nasıl Farklıdır

Bu üç dosya da alan adı kökünde yaşar ve hepsi otomatik istemcilere seslenir; kafa karıştırmalarının nedeni tam olarak budur. Farklı sorunları çözerler ve ikame değil, tamamlayıcıdırlar. Üçünü de tutun.

Zihinsel model: sitemap.xml "işte var olan her şey" der, robots.txt "işte erişebileceğin ve erişemeyeceğin şeyler" der ve llms.txt "işte gerçekten önemli olan ve ne anlama geldiği" der. Bir site haritası kapsamlı ve açıklamasızdır; bir llms.txt seçici ve açıklamalıdır.

Tarama kontrolü hakkında önemli bir açıklama. llms.txt hiç kimseyi hiçbir şeyden engellemez — hiçbir izin vermez ve hiçbirini geri almaz. Yapay zeka şirketlerinin sitenizi eğitim için tarayıp taramadığını kontrol etmek istiyorsanız, bu robots.txt kullanıcı aracısı kuralları (GPTBot, ClaudeBot, Google-Extended gibi botlar için) ve giderek artan biçimde ayrı, önerilen bir ai.txt tarzı izinler katmanı aracılığıyla yapılır. llms.txti bir onay ya da vazgeçme dosyası olarak ele almayın.

Yapay Zeka Tarayıcıları ve Asistanları Onu Gerçekte Nasıl Kullanır

İşte dürüstlüğün elzem olduğu yer, çünkü teknik olarak mümkün olanla üretimde teyit edilen arasındaki uçurum geniştir.

Bugün ne oluyor. Giderek büyüyen bir geliştirici odaklı araç kümesi llms.txt okur. Belge platformları, çeşitli yapay zeka kodlama asistanları ve IDE entegrasyonları ve bazı getirme çerçeveleri, onları bir alan adına yönlendirdiğinizde /llms.txt getirir, sonra hangi sayfaların bağlama çekileceğine karar vermek için kullanır. Bir belge URL'sini bir yapay zeka kodlama aracına yapıştırıp doğru referans sayfaları hızla bulmasını izlediyseniz, bir llms.txt bunun nedeni olabilir.

Teyit edilmeyen ne. Bunu yazdığım sırada, büyük tüketici yapay zeka arama ürünleri, genel web yanıtlarında llms.txti bir sıralama veya getirme sinyali olarak kullanmaya kamuya açık olarak taahhüt etmemiştir. Bazı büyük sağlayıcılardan kişilerin kamuya açık açıklamaları şüpheci olmuştur; zaten HTML'den ölçekte içerik çıkardıklarını belirtmişlerdir. Dolayısıyla bir llms.txt yayımlamanın tek başına, genel amaçlı bir yapay zeka asistanının yanıtlarında sizi daha sık alıntılatacağını beklememelisiniz.

Yine de neden değebilir. Maliyet neredeyse sıfırdır — küçük bir Markdown dosyasıdır — ve pratik yararlı bir egzersizi zorlar: sitenizdeki hangi on ya da yirmi URL'nin değerinizi gerçekten temsil ettiğine karar vermek ve her biri için bir satırlık bir açıklama yazmak. O netlik, dosyayı kim okursa okusun HTML'inize, meta verilerinize ve içerik stratejinize yardımcı olur. Ve benimseme büyürse, zaten konumlanmış olursunuz. Bu, daha geniş generative engine optimization mantığının altındaki aynı düşük maliyetli, yüksek opsiyonaliteli mantıktır: içeriği yapay zeka sistemlerinin nasıl tükettiği için optimize edersiniz çünkü keşfin gittiği yer orasıdır.

Yapay zeka sistemlerinin şu anda teyit edilmiş etkiyle ayrıştırdığı içerik için, yapılandırılmış veri llms.txtten daha fazla ağır iş yapar. Yapay zeka arama motorlarının gerçekten okuduğu şema işaretlemesi analizimize bakın — geçerli şemayı temiz bir llms.txt ile eşleştirmek hem teyit edilmiş hem de yeni ortaya çıkan kanalları kapsar.

Mevcut Benimseme ve Sınırlamalar

Beklentileri ayarlı tutmak için, işte durum sade terimlerle.

• Bir öneridir, bir zorunluluk değil. Yönetici bir kurum, uygunluk testi ya da bir tane bulundurmamanın cezası yoktur. Belirtim kamuya açık bir depoda yaşar ve gelişir.
• Okumak tüketiciler için isteğe bağlıdır. Onu okuyan herhangi bir araç ya da model bunu tercihen yapar. Çoğu yapmaz.
• Bir sıralama sinyali değildir. Hiçbir arama veya yapay zeka sağlayıcısı görünürlüğü etkilediğini teyit etmemiştir. Aksini iddia eden her şeyi olgu değil, pazarlama olarak ele alın.
• Kayabilir. Bir site haritası gibi, ölü ya da güncelliğini yitirmiş URL'lere işaret eden bir llms.txt, hiç olmamasından daha kötüdür. Bakım gerektirir.
• İyi içeriğin ya da yapılandırılmış verinin yerini almaz. Bir işaretçi dosyasıdır. İşaret ettiği sayfalar zayıfsa, işaretçi yardımcı olmaz.

Bunların hiçbiri llms.txti kötü bir fikir yapmaz. Onu düşük riskli, geleceğe dönük bir hijyen pratiği yapar — 2006'da bir site haritası eklemeye, garantili bir büyüme kaldıracından daha yakın. Onu yayımlayın, doğru tutun ve ekosistemin yetişmesine izin verin.

Sıkça Sorulan Sorular

llms.txt resmi bir web standardı mı?

Hayır. Eylül 2024'te tanıtılan ve kamuya açık bir belirtimde sürdürülen önerilen bir kuraldır, ancak W3C veya IETF gibi herhangi bir standart kuruluşu tarafından onaylanmamıştır. RFC 9309 olarak resmileştirilen robots.txtin aksine, llms.txtin resmi bir statüsü yoktur ve hiçbir sağlayıcı onu desteklemekle yükümlü değildir.

llms.txt eklemek Google veya yapay zeka arama sıralamalarımı iyileştirir mi?

İyileştirdiğine dair kanıt yoktur ve hiçbir büyük sağlayıcı onu genel web yanıtları için bir sıralama veya getirme sinyali olarak teyit etmemiştir. Onu bir SEO taktiği olarak değil, düşük maliyeti ve gelecek potansiyeli için ekleyin. Gerçek görünürlük kazanımları hâlâ kaliteli içerikten, yapılandırılmış veriden ve teknik sağlıktan gelir.

llms.txt'im varsa robots.txt ve sitemap.xml'e hâlâ ihtiyacım var mı?

Evet, kesinlikle. Üç dosya farklı, tamamlayıcı amaçlara hizmet eder: sitemap.xml keşif için tüm URL'lerinizi listeler, robots.txt tarayıcı erişimini ve izinlerini kontrol eder ve llms.txt temel içeriğinizi yapay zeka okuması için seçer ve açıklar. llms.txt hiçbir izin vermez, dolayısıyla asla robots.txtin yerini alamaz.

llms.txt dosyası tam olarak nerede yer almalı?

Alan adınızın kökünde, https://yourdomain.com/llms.txt adresinde sunulan ve düz metin ya da Markdown içerik türüyle HTTP 200 döndüren. Bir alt dizinde ya da kimlik doğrulamanın arkasında olmamalıdır. Birden fazla alt alan adınız varsa, her biri o ana kapsamlanmış kendi dosyasını barındırabilir.

Bir llms.txt dosyası ne kadar uzun olmalı?

Kısa ve seçilmiş tutun — genellikle en önemli on ila otuz URL'niz, her biri bir satırlık açıklamayla. Tüm mesele seçiciliktir, dolayısıyla her sayfayı listelemeye direnin. Bağlantılar yerine tam metin sağlamak istiyorsanız, birincil llms.txtin yalın bir dizin olarak kalması için ayrı bir llms-full.txt dosyası kullanın.

Bütün bunları tek başınıza elle yazıp sürdürmek zorunda değilsiniz. emax.studio gibi araçlar, llms.txtinizin işaret etmesi gereken yapay zeka için optimize edilmiş içeriği — temiz sayfalar, yapılandırılmış özetler ve yanıtla başlayan metin — üretebilir, böylece dosya gerçekten alıntılanmaya değer materyale bağlanır.

İlk yapay zeka destekli pazarlama kampanyanızı emax.studio üzerinde oluşturun — ücretsiz plan mevcut.