llms.txt nedir, nasıl oluşturulur ve buna ihtiyacınız var mı?

llms.txt nedir ve dosya ne içerir?

llms.txt, bir web sitesinin önemli içeriğine yönelik seçilmiş bir rehber yayınlamak için önerilen bir kuraldır. Genellikle site kökünde, dil modeli araçlarının kullanışlı sayfaları bulmasını ve yorumlamasını kolaylaştırmayı amaçlayan bir Markdown dosyası olarak tanımlanır. Öneri ve örnekler llmstxt.org adresinde mevcuttur.

Fikir kasıtlı olarak basittir: tüm bir siteyi tek bir belgeye kopyalamak yerine kısa bir yönlendirme ve seçilmiş bir bağlantı seti sunar. Bir dosya, ürün belgelerine, şirket genel bakışına, destek materyaline veya bir proje hakkında yetkili sayfalara işaret edebilir. Her giriş, okuyucunun o sayfanın neden önemli olduğunu anlamasına yardımcı olmalıdır.

Bir Web3 projesi için en güçlü adaylar, ürünü, protokolü, token'ı veya güvenlik uygulamalarını doğrudan bir dille açıklayan istikrarlı, herkese açık sayfalardır. Bir bağlantı listesi, bu sayfaların yerine geçmez. Temel bilgiler net değilse, güncel değilse veya erişilemezse, bir dizin dosyası bunu düzeltemez. llms.txt'yi editoryal bir yön levhası olarak düşünün: kullanışlı bilgilerin nerede olduğunu tarif eder, kanıt ve ayrıntıyı ise hedef sayfalar taşır.

llms.txt'nin yararlı olup olmadığını hangi kanıtlar gösterir?

Bir dosyanın temel işini yaptığına dair en net kanıt incelenebilirdir: amaçlanan adreste yayınlanmıştır, doğru bağlantılar içerir ve okuyuculara önemli bilgilere tutarlı bir rota sunar. Bu kontroller dosyanın var olduğunu ve bakımının yapıldığını gösterir; bir AI asistanının onu okuduğunu veya ona güvendiğini göstermez.

llms.txt'yi değerlendirirken üç soruyu ayırın:

• Geçerli ve erişilebilir mi? Genel URL'yi açın ve yanıtın amaçlanan metni görüntülediğini kontrol edin.
• Bir kişi için yararlı mı? Alışık olmayan bir okuyucunun, tahmin yürütmeden projenin anahtar sayfalarını belirleyip belirleyemeyeceğini sorun.
• Harici kullanım kanıtı var mı? Yayınlanmış bir dosyanın bir yanıtta değişikliğe neden olduğunu varsaymak yerine, atfedilebilir bir kaynak veya belgelenmiş bir gözlem arayın.

Her revizyonun tarihli bir kopyasını saklayın ve bağlantıların neden eklendiğini veya kaldırıldığını kaydedin. AI görünürlüğünü izliyorsanız, istemi, platformu, yanıtı ve atıf yapılan kaynakları dosya bakımından ayrı olarak kaydedin. Bu ayrım, nedeni erken atfetmeden gözlemleri tartışmayı mümkün kılar. Daha geniş bir site düzeyinde inceleme için bkz. teknik AEO: schema, llms.txt ve tarayıcılar ve AI görünürlük takibi.

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

llms.txt'yi bir anahtar kelime envanteri olarak değil, güvenilir bir yönlendirmeye ihtiyaç duyan bir okuyucu için yazın. Proje adı ve kısa, tarafsız bir açıklama ile başlayın. Ardından, küçük bir kullanışlı bağlantı kümesini açıklayıcı etiketler altında gruplandırın ve okuyucunun doğru sayfayı seçmesine yardımcı oldukları yerde tek satırlık açıklamalar ekleyin.

Basit bir taslak şöyle görünebilir:

Proje adı

Projenin ve amacının kısa bir açıklaması.

Genel bakış

• Proje hakkında: https://example.com/about — ürün kapsamı ve hedef kullanıcılar. - Belgeler: https://example.com/docs — ürün ve entegrasyon rehberi.

Güven ve politikalar

• Güvenlik bilgileri: https://example.com/security — yayınlanmış güvenlik ayrıntıları. - Şartlar: https://example.com/terms — geçerli kullanım şartları.

Kendi sitenizden gerçek, herkese açık URL'ler kullanın; yukarıdaki örnek adresler yayınlanacak bağlantılar değil, yer tutuculardır. Farklı soruları yanıtlayan ve güncel tutulabilen sayfaları tercih edin. Belirsiz etiketlerden, tekrarlanan hedeflerden, tanıtımsal üstünlük ifadelerinden ve bağlantılı sayfada desteklenmeyen iddialardan kaçının. Yayınlamadan önce, sayfa sahiplerinin hem ifadeyi hem de hedefi doğrulamasını sağlayın. Doğru açıklamalara sahip kısa bir dosya, güncelleme sorumluluğu olmayan uzun bir envanterden daha sürdürülebilirdir.

Bakım sorunu yaratmadan llms.txt nasıl uygulanır?

llms.txt'yi, atanmış bir sorumlusu olan küçük bir içerik değişikliği olarak uygulayın. İlk olarak, hedef kitle ve amaç üzerinde anlaşın: örneğin, kişilerin veya araçların bir projenin temel ürün ve politika bilgilerini bulmasına yardımcı olmak. Ardından, hedef sayfaları seçin ve her birinin herkese açık, güncel ve amaçlanan doğruluk kaynağı olduğunu onaylayın.

Yayınlamadan önce bu kontrol listesini kullanın:

• Nihai dosya adını ve sunulacağı kök adresi onaylayın.
• Her hedef URL'yi bir tarayıcıda kontrol edin ve doğrudan bir URL'nin mevcut olduğu yönlendirmeleri veya ölü bağlantıları kaldırın.
• Açıklamaları, bağlantılı her sayfanın gerçek içeriğiyle eşleştirin.
• Dosyayı gizli, yayınlanmamış veya güncelliğini yitirmiş materyaller açısından inceleyin.
• Adlandırılmış bir sorumlu ve belge yeniden düzenlemesi veya ürün değişikliği gibi pratik bir inceleme tetikleyicisi atayın.
• Yayınladıktan sonra, genel adresi açın ve onaylanmış sürümle karşılaştırın.

Kaynak dosyayı, diğer site içeriğiyle aynı editoryal iş akışında tutun, böylece güncellemeler birinin izole bir teknik görevi hatırlamasına bağlı olmaz. Yapılandırılmış verilerin bir sayfayı nasıl tanımladığıyla ilgili soru için bkz. AI arama için schema markup. Site bir bütün olarak değerlendiriliyorsa, AI asistanları için alıntılanabilir içerik yararlı bir tamamlayıcı konudur.

LLMs.txt vs schema.org: fark nedir?

llms.txt ve schema.org işaretlemesi farklı editoryal ve teknik roller üstlenir. llms.txt, seçili sayfalara işaret eden seçilmiş bir metin belgesidir; schema.org ise varlıkları ve sayfa içeriğini yapılandırılmış verilerde tanımlamak için bir kelime dağarcığı sağlar. Hiçbiri, sayfanın kendisindeki net, eksiksiz bilgilerin yerine geçecek bir şey olarak ele alınmamalıdır.

Bir sayfada ilgili bir schema.org türünde doğru bir şekilde temsil edilebilecek bilgiler olduğunda schema'yı kullanın. Seçili sayfaların kısa bir haritası okuyucuları yönlendirmeye yardımcı olacağında llms.txt'yi kullanın. Bu seçimler bir arada bulunabilir, ancak her ikisini de eklemek, bir arama motorunun veya AI asistanının bunlardan herhangi birini kullanacağını kendi başına kanıtlamaz. Teknik sinyalleri içerik çalışmasından ayırmaya yardımcı olması için bu rehberle birlikte AI arama için schema markup bölümünü inceleyin.

Web siteniz veya Web3 projeniz için llms.txt gerekli mi?

Muhtemelen kullanışlı bir web sitesi yayınlamak için bir ön koşul olarak llms.txt'ye ihtiyacınız yoktur. Sitenizde birkaç önemli herkese açık kaynak olduğunda, bu kaynakların birbirinden keşfedilmesi zor olduğunda ve birisi dosyayı doğru tutabildiğinde oluşturmayı düşünün. Küçük bir sitenin zaten net bir gezinme yapısı ve birkaç yetkili sayfası varsa, bu sayfaları iyileştirmek daha kullanışlı bir ilk adım olabilir.

Bir Web3 projesi için, bir okuyucunun ürün, ağ, belgeler, yönetişim, güvenlik açıklamaları ve şartlar hakkında güvenilir bilgilere hızlıca ulaşıp ulaşamayacağını sorun. Bir sayfayı yalnızca herkese açık, güncel ve amaçlanan yönlendirmeyle ilgili olduğunda ekleyin. Dosyayı, bağlantılı kanıt bu ifadeyi desteklemediği sürece bir projenin denetlendiğini, onaylandığını veya doğrulandığını ima etmek için kullanmayın.

Pratik bir karar, kısa bir sürüm taslağı hazırlamak, yazma sürecinin dışındaki bilgili bir kişiden anahtar sayfaları bulmasını istemek ve tereddüte neden olan etiketleri revize etmektir. Test zayıf veya eksik hedef sayfaları ortaya çıkarırsa, önce bunları ele alın. Dosya, site menüsünün ötesinde anlamlı bir gezinme eklemiyorsa, onu dışarıda bırakın ve site değiştiğinde kararı tekrar gözden geçirin.

llms.txt'nin kanıtlayamadıkları ve bundan sonra ne yapılmalı?

Yayınlanmış bir llms.txt dosyası yalnızca sitenizin belirli bir bağlantı ve açıklama seti sunduğunu onaylar; bir platformun bunları getirdiğinin, kabul ettiğinin veya kullandığının kanıtı değildir. Hiç kimse Google'ın, bir AI asistanının veya başka bir üçüncü tarafın dosyayı okuyacağını, bağlantılı bir sayfaya atıf yapacağını veya projenizi sunma şeklini değiştireceğini vaat edemez; bu sistemler kendi erişimlerini, seçimlerini ve sunumlarını kontrol eder.

Kararı dosyanın değeriyle orantılı tutun. Yüzeye çıkarmaya değer istikrarlı sayfalarınız varsa, iş mütevazıdır: onları seçin, doğru bir şekilde tanımlayın, dosyayı yayınlayın ve kaynak sayfalarla birlikte bakımını yapın. Bu sayfalar eksik veya tutarsızsa, bir harita düzenlemeden önce kaynak materyali düzeltin. Pratik bir inceleme, size onaylanmış bir URL listesi, taslak metin, gelecekteki güncellemeler için bir sorumlu ve neyin kontrol edildiğine dair bir kayıt bırakmalıdır.

Bağımsız bir inceleme isterseniz, Premium Promotions'e site URL'nizi, yetkili olarak değerlendirdiğiniz sayfaları ve hassas veya güncelliğini yitirmiş bilgilerle ilgili endişelerinizi gönderin. Önerilen hedefleri ve açıklamaları kontrol edecek, ekibiniz için boşlukları işaretleyecek ve onayınız için yayına hazır bir taslak döndüreceğiz.

Nasıl çalışır

1. Amacı belirleyinDosyanın kime yardım etmesi gerektiğini ve hangi bilgileri bulabilmeleri gerektiğini yazın. Hedefi, sayfa seçimine rehberlik edecek kadar spesifik tutun.
2. Kaynak sayfaları seçinProjenin yetkili bilgilerini temsil eden herkese açık, güncel sayfaları toplayın. Her sayfa sahibinden içeriği ve URL'yi onaylamasını isteyin.
3. Haritayı taslak haline getirinKısa bir giriş, açıklayıcı başlıklar ve doğru bağlantı açıklamaları ekleyin. Tekrarlayan veya tanıtımsal girişleri kaldırın.
4. Kontrol edin ve yayınlayınHer hedefi ve nihai kök adresi doğrulayın. Yayınlanan dosyayı onaylanmış taslakla karşılaştırın.
5. Kaydı koruyunBir sorumlu atayın ve önemli bir sayfa değiştiğinde, taşındığında veya artık yetkili olmadığında dosyayı güncelleyin.