llms-full.txt Nedir? llms.txt'ten Farkı ve Ne Zaman Gerekir
Kısaca: llms-full.txt, llms.txt'nin kapsamlı versiyonu olarak önerilen bir dosyadır; llms.txt'de yalnızca özet bilgi varken, llms-full.txt'de tüm dokümantasyon, API referansları ve detaylı içerik yer alır. Henüz resmi bir standart değildir ve büyük AI sağlayıcılarının bunu kullandığına dair doğrulanmış kanıt yoktur. Boyut kısıtı olmadığı için büyük dosyalar oluşturabilir; ancak bu, LLM'lerin gerçekten okuyup işleyeceği anlamına gelmez.
llms-full.txt Kavramının Ortaya Çıkışı
llms.txt önerisi 2024 yılında ortaya çıktığında, temel fikir bir sitenin önemli bilgilerini LLM'lere özetlemekti. Ancak bazı geliştiriciler ve dokümantasyon siteleri şunu fark etti: özet yeterli olmayabilir. Bir AI aracı, kullanıcı talebine göre daha detaylı bilgiye ihtiyaç duyabilir—örneğin bir API'nin tüm endpoint'leri, parametre açıklamaları veya kod örnekleri.
Bu noktada llms-full.txt fikri doğdu: llms.txt'de site hakkında kısa bir rehber sunarken, llms-full.txt'de tüm içeriği düz metin formatında toplamak. Böylece bir LLM veya AI aracı, gerektiğinde tam bilgiye tek dosyadan erişebilir.
Ancak şunu belirtmek gerekir: llms-full.txt de llms.txt gibi resmi bir standart değildir. OpenAI, Anthropic, Google veya Perplexity gibi büyük sağlayıcıların bu dosyayı sıralama, atıf veya eğitim için kullandığına dair doğrulanmış açıklama yoktur. Dolayısıyla bu dosyayı oluşturmak, deneysel bir yaklaşımdır.
llms.txt ile llms-full.txt Arasındaki Fark
| Özellik | llms.txt | llms-full.txt |
|---|---|---|
| Amaç | Sitenin özet bilgisi, yapı, ana konular | Tüm içeriğin düz metin hali (dokümantasyon, API, makaleler) |
| Boyut | Genelde birkaç KB – birkaç yüz satır | Onlarca MB olabilir (içerik hacmine göre) |
| Kullanım senaryosu | Hızlı bağlam, site haritası, genel bilgi | Detaylı sorgular, kod örnekleri, tam referans |
| Güncelleme sıklığı | Site yapısı değiştiğinde | İçerik her güncellendiğinde (otomasyon gerekir) |
Kısacası: llms.txt bir "içindekiler" sayfası gibi, llms-full.txt ise tüm kitabın tek dosyada birleştirilmiş halidir.
Boyut ve Format Sorunları
Dosya Boyutu
llms-full.txt'nin en büyük sorunu boyuttur. Orta ölçekli bir dokümantasyon sitesinde yüzlerce sayfa varsa, bunların hepsini düz metne çevirdiğinizde 10–50 MB arası bir dosya oluşabilir. Büyük bir e-ticaret veya içerik sitesinde bu 100 MB'ı bile geçebilir.
Sorun şu: çoğu LLM'nin bağlam penceresi (context window) sınırlıdır. Örneğin GPT-4 Turbo 128.000 token (~96.000 kelime) alabilir; Claude 3.5 Sonnet 200.000 token destekler. Ancak bu, tüm dosyanın okunacağı anlamına gelmez—LLM yalnızca ihtiyaç duyduğu bölümleri alır veya dosya çok büyükse hiç okumayabilir.
Format ve Yapı
llms-full.txt düz metin (plain text) olmalıdır. Markdown kullanılabilir, ancak HTML, JSON veya XML gibi yapılandırılmış formatlar önerilmez—çünkü LLM'ler bu dosyayı doğrudan okuyacak, parse etmeyecek.
Örnek bir yapı:
# Ürün Dokümantasyonu - Tam Versiyon
## API Referansı
### GET /api/users
Tüm kullanıcıları listeler.
Parametreler:
- limit (integer): Maksimum sonuç sayısı
- offset (integer): Başlangıç noktası
Örnek yanıt:
{
"users": [...]
}
### POST /api/users
Yeni kullanıcı oluşturur.
...
## Kullanım Kılavuzu
### Kurulum
...
### Yapılandırma
...
Her bölüm açıkça başlıklandırılmalı, kod örnekleri ve açıklamalar net olmalıdır. Ancak dosya çok büyükse, LLM'nin hangi bölümü okuyacağını kontrol edemezsiniz.
Güncelleme ve Otomasyon
llms-full.txt'yi manuel güncellemek pratik değildir. İçerik her değiştiğinde dosyayı yeniden oluşturan bir script gerekir. Örneğin:
- Dokümantasyon sitesi Markdown dosyalarından oluşuyorsa, tüm .md dosyalarını birleştiren bir build script
- CMS tabanlı sitede, tüm içeriği API'den çekip düz metne dönüştüren bir cron job
- Statik site oluşturucular (Hugo, Jekyll, Docusaurus) için özel bir plugin veya hook
Aksi takdirde dosya hızla eskir ve yanlış bilgi içerir.
Ne Zaman llms-full.txt Mantıklıdır?
llms-full.txt her site için gerekli değildir. Aşağıdaki durumlarda düşünülebilir:
- Kapsamlı API dokümantasyonu: Yüzlerce endpoint, parametre ve örnek varsa, llms.txt'de bunların hepsini özetlemek zordur. llms-full.txt, bir AI aracının tüm API'yi taramasını sağlar.
- Teknik kütüphane veya framework: Geliştiricilerin sık sık detaylı soru sorduğu projeler (örneğin React, Django, Kubernetes dokümantasyonu). Ancak bu sitelerin zaten arama ve yapılandırılmış verileri vardır; llms-full.txt ek bir deney olabilir.
- Dahili bilgi tabanları: Şirket içi AI asistanları için tüm prosedür, politika ve teknik dokümanları tek dosyada toplamak. Burada dosya boyutu daha kontrollüdür ve LLM'nin bağlamına sığabilir.
- Araştırma ve arşiv projeleri: Tüm içeriği LLM'lere açmak istiyorsanız ve boyut sorunu yoksa.
Ancak şu durumlarda mantıklı değildir:
- Sitenizde binlerce blog yazısı, ürün sayfası veya kullanıcı içeriği varsa—dosya çok büyük olur ve LLM'ler bunu verimli işleyemez.
- İçerik sık değişiyorsa ve otomasyonunuz yoksa—dosya sürekli güncel tutulmalıdır.
- Zaten yapılandırılmış veri (schema.org), sitemap ve iyi bir arama API'niz varsa—LLM'ler bunları kullanabilir, ayrı bir dosyaya ihtiyaç duymayabilir.
Büyük AI Sağlayıcıları llms-full.txt Kullanıyor mu?
Hayır, en azından 2025 başı itibarıyla doğrulanmış bir kullanım yok. OpenAI, Anthropic, Google, Perplexity gibi şirketler llms.txt veya llms-full.txt'yi resmi olarak desteklediklerini açıklamadılar. Bu dosyalar, topluluk tarafından önerilen deneysel yaklaşımlardır.
Dolayısıyla llms-full.txt oluşturmanın, ChatGPT veya Gemini'de daha iyi sıralama veya atıf getireceğine dair garanti yoktur. Ancak bazı özel AI araçları (örneğin şirket içi RAG sistemleri) bu dosyayı kullanabilir—bu durumda faydalı olabilir.
Pratik Öneriler
- Önce llms.txt ile başlayın: Sitenizin yapısını ve ana konularını özetleyin. Bu, çoğu kullanım senaryosu için yeterlidir.
- llms-full.txt'yi yalnızca gerektiğinde ekleyin: Detaylı dokümantasyon veya API referansınız varsa ve bunu LLM'lere sunmak istiyorsanız.
- Boyutu kontrol edin: Dosya 10 MB'ı geçiyorsa, bölümlere ayırmayı düşünün (örneğin llms-full-api.txt, llms-full-guides.txt).
- Otomasyonu kurun: İçerik her değiştiğinde dosyayı yeniden oluşturan bir script yazın.
- Beklentilerinizi gerçekçi tutun: Bu dosya, AI araçlarının sitenizi daha iyi anlamasına yardımcı olabilir, ancak sıralama veya görünürlük garantisi vermez.
Sık Sorulan Sorular
llms-full.txt dosyası ne kadar büyük olabilir?
Teknik bir üst sınır yoktur, ancak pratik olarak 50 MB'ın üzeri çoğu LLM'nin bağlam penceresine sığmaz. Dosya çok büyükse, AI araçları bunu tamamen okumak yerine yalnızca ilgili bölümleri alır veya hiç okumayabilir. Eğer dosyanız 10 MB'ı geçiyorsa, bölümlere ayırmayı veya yalnızca kritik içeriği dahil etmeyi düşünün.
llms-full.txt'yi robots.txt'de engellemeli miyim?
Hayır, aksine bu dosyayı LLM'lerin erişimine açık tutmak istersiniz. Ancak dosya çok büyükse ve sunucu yükü oluşturuyorsa, rate limiting (hız sınırlaması) uygulayabilirsiniz. robots.txt'de engellemek, dosyanın amacını ortadan kaldırır.
llms-full.txt ile sitemap.xml arasındaki fark nedir?
sitemap.xml, arama motorlarına hangi URL'lerin var olduğunu söyler; içeriği değil, yalnızca linkleri listeler. llms-full.txt ise içeriğin kendisini düz metin olarak sunar. Sitemap, tarama için; llms-full.txt ise LLM'lerin doğrudan okuyup işlemesi için tasarlanmıştır. İkisi birbirini tamamlar, birbirinin yerine geçmez.
llms-full.txt'yi kim kullanmalı?
Kapsamlı API dokümantasyonu, teknik kütüphane veya framework dokümantasyonu sunan siteler ile şirket içi AI asistanları için bilgi tabanı oluşturan ekipler. Genel blog siteleri, e-ticaret platformları veya sık değişen içerikli siteler için genelde pratik değildir. Önce llms.txt ile başlayın; yalnızca detaylı içerik sunma ihtiyacı varsa llms-full.txt'yi düşünün.