Günümüzün yapay zeka odaklı geliştirme ortamında, LLM'lerin kolayca işleyebileceği belgelere sahip olmak esastır. Bu ihtiyacı fark eden Apidog, paylaşılan/yayınlanan API belgelerinizi yapay zeka dostu bir formata dönüştürerek LLMs.txt'yi desteklemektedir. Bu güçlü özellik, yapay zeka araçlarının, yapay zeka sistemlerini genellikle karıştıran HTML ve JavaScript karmaşası olmadan temiz, yapılandırılmış belgelere erişmesini sağlar.
Bunun geliştirme iş akışınız için ne anlama geldiğini ve bunu hemen nasıl kullanabileceğinizi inceleyelim.
LLMs.txt Nedir ve Neden Apidog LLMs.txt'yi Destekler?
Yapay zeka asistanları çevrimiçi web içeriğini işlediğinde, genellikle neyin önemli olduğunu filtrelemekte zorlanırlar. Günümüzdeki çoğu web sayfası, insanlar için faydalı ancak makineler için dikkat dağıtıcı olan stiller, komut dosyaları ve etkileşimli öğelerle doludur. Bu gereksiz komut dosyaları, belirteçleri boşa harcar, yanıt hızını düşürür ve yapay zeka iş akışlarında maliyetleri artırır.
LLMs.txt, 2024'te önerilen yeni bir standarttır ve bu sorunu çözmek için tasarlanmıştır. Arama motorları için sitemap.xml'e benzer şekilde, llms.txt, LLM'ler için bir yol haritasıdır. Belgelerinizin her Markdown (.md) sürümüne bağlantılar içerir ve yapay zekanın gereksiz içeriği atlayıp gerçekten önemli olanlara odaklanmasını sağlar.
Neden Apidog’un LLMs.txt Desteği Önemlidir?
Apidog, otomatik olarak şunları yaparak bir adım daha ileri gider:
- Her belgeleme sayfasının temiz bir
.mdsürümünü oluşturma - Tüm Markdown dosyalarına bağlantılar içeren kapsamlı bir
llms.txtdosyası oluşturma - Tam web optimizasyonu için
sitemap.xmlverobots.txtgibi destekleyici dosyalar dahil etme
Bu, belgelerinizin yapay zeka tüketimi için anında hazır olduğu anlamına gelir; ekstra yapılandırma gerekmez.
Apidog’un Yapay Zeka Dostu API Belgeleri için LLMs.txt Özellikleri
Apidog'un LLMs.txt desteği, API belgelerinizin yapay zeka sistemleriyle nasıl etkileşim kurduğunda temel bir iyileştirmeyi temsil eder:
Kesintisiz Markdown Erişimi
Paylaşılan/yayınlanan her belgeleme sayfasının artık özel bir .md sürümü vardır:
- Anında erişim için URL'ye
.mdekleyin. - Alternatif olarak, sayfadaki sezgisel
Sayfayı KopyalaveyaMarkdown Olarak Görüntüledüğmelerini kullanın.
Site Seviyesinde LLMs.txt Oluşturma
Apidog tarafından yayınlanan API Belgeleri artık bir /llms.txt dosyası içerecektir.
- Belgeleme sitenizin kök dizininde
/llms.txtaracılığıyla erişilebilir. - Mevcut tüm
.mdURL'lerinin yapılandırılmış bir listesini alın - LLM'lerin temel içeriğe öncelik vermesine yardımcı olmak için öz özetler içerir.
Kurulum Gerekmez
- LLMs.txt özelliği, yayınlanan/paylaşılan belgelerde varsayılan olarak etkindir.
- Kodlama veya ayar yapmadan kutudan çıkar.
SEO ve Yapay Zeka Standartlarıyla Uyumlu
| Özellik | LLMs.txt | Sitemap.xml | Robots.txt |
|---|---|---|---|
| Yapay Zeka Okunabilirliği | ✅ Evet | ❌ Hayır | ❌ Hayır |
| SEO Optimizasyonu | ✅ Evet | ✅ Evet | ✅ Evet |
| Otomatik Oluşturuldu | ✅ Apidog Tarafından | ✅ Apidog Tarafından | ✅ Apidog Tarafından |
Bu yığın, belgeleme sitenizi hem yapay zeka araçları hem de geleneksel arama motorları için tamamen optimize eder.
Apidog’un LLMs.txt Özelliği Nasıl Kullanılır?
ChatGPT, Claude, Cursor veya herhangi bir özel LLM arayüzüyle çalışıyor olsanız da, Apidog belgelerinizi bir yapay zeka iş akışına entegre etmek artık her zamankinden daha kolay.
Yöntem 1: Markdown URL'lerini Doğrudan Paylaşın
Web taramayı destekleyen yapay zekalar için:
- Herhangi bir Apidog doküman sayfasına
.mdekleyin.
Örnek:https://apidogsite.com/api-doc.md - Veya belgeleme bağlantısını almak için
Markdown Olarak Görüntüledüğmesini kullanın. - Ardından yapay zekaya şu komutu verin:
https://apidogsite.com/api-doc.md
Yöntem 2: Markdown'ı Kopyalayıp Yapay Zekaya Yapıştırın
Web tarama yeteneği olmayan yapay zeka araçları için:
- Apidog'un yayınlanmış doküman sayfasındaki
Sayfayı Kopyaladüğmesini kullanın. - İçeriği doğrudan yapay zeka aracınıza veya sohbetinize yapıştırın.
- Yapay zekayı yönlendirmek için komutlar yazın.
Komut örneği:
[Buraya Markdown içeriğini yapıştırın]
LLMs.txt, API belgelerinizi yapay zeka araçlarının okumasını kolaylaştırırken, Apidog MCP Sunucusu bir adım daha ileri gider. Yapay zeka asistanlarına API spesifikasyonlarınıza doğrudan erişim sağlar; böylece API'nizin tam yapısını anlayabilir, doğru kod oluşturabilir ve daha akıllıca yardımcı olabilirler.
Belgeleri manuel olarak kopyalayıp yapıştırmanıza gerek yok. Daha akıllı, yapay zeka destekli geliştirme iş akışları oluşturmanın kesintisiz bir yolu.
Apidog’un LLMs.txt Desteği Hakkında SSS
S1: LLMs.txt özelliği nasıl devre dışı bırakılır?
Bu özelliği devre dışı bırakmak istiyorsanız, projeye girebilir, Dokümanları Paylaş -> Doküman Sitelerini Yayınla -> LLM dostu Özellikler'e tıklayarak ilgili işlemleri gerçekleştirebilirsiniz.
S2: LLMs.txt'nin etkinleştirilmesi belgelerin güvenliğini etkileyecek mi?
Hayır, LLMs.txt herhangi bir özel veya yayınlanmamış bilgiyi ifşa etmez.
Yalnızca zaten kamuya açık olarak yayınlanmış API belgelerinden içerik içerir. LLMs.txt özelliği, mevcut HTML sayfalarının yalnızca bir Markdown sürümünü sağlar; görünür olanlarda herhangi bir değişiklik yoktur.
Yayınlanan belgeleriniz korunuyorsa (örneğin, parola, IP izin listesi veya e-posta izin listesi ile), birisi .md sürümüne veya LLMs.txt dosyasına erişmeye çalıştığında aynı kimlik doğrulama gereksinimleri hala geçerlidir.
S3: Çevrimiçi belgelerim bir parola, IP izin listesi veya e-posta izin listesi ile korunuyorsa, LLMs.txt özelliğini kullanmaya devam edebilir miyim?
Evet, hala kullanabilirsiniz.
Ancak, LLMs.txt dosyası ve belgelerinizin Markdown (.md) sürümleri aynı erişim denetimlerini izlediğinden, kimlik doğrulaması hala gereklidir. Bu, yapay zeka asistanlarının, erişimleri yoksa bu .md dosyalarını doğrudan URL aracılığıyla alamayacağı anlamına gelir.
Bunun etrafından dolaşmak için, siz (veya erişimi olan kullanıcılar) Markdown içeriğini kolayca kopyalamak ve ardından seçtiğiniz yapay zeka aracına yapıştırmak için "Sayfayı kopyala" özelliğini kullanabilirsiniz.
S4: Apidog uygulamasında "Sayfayı kopyala" ve diğer düğmeleri neden göremiyorum?
Sayfayı kopyala düğmesi ve ilgili özellikler yalnızca paylaşılan veya yayınlanan çevrimiçi belgelerde mevcuttur.
Bu özelliklere erişmek için, önce belgelerinizi yayınlamanız ve ardından bir web tarayıcısında görüntülemeniz gerekir; Apidog masaüstü uygulamasında değil.
S5: Yapay zeka asistanının "Arama" özelliğini etkinleştirdim — neden web sayfası içeriğini doğrudan URL'lerden okuyamıyor?
"Arama" özelliği "Web Tarama" ile aynı değildir.
- Arama, yapay zekanın, girdilerinize göre konuları aramak için arama motorlarını kullanmasına ve ardından bulduğu sonuçları özetlemesine olanak tanır.
- Öte yandan Web Tarama, yapay zekanın doğrudan belirli bir URL'den içeriğe erişmesine ve okumasına olanak tanır.
S6: Yapay zeka URL'ler aracılığıyla Markdown dosyalarına erişemezse ne yapmalıyım?
Yapay zeka, .md dosyasını doğrudan URL'den okuyamazsa, çevrimiçi belgelerdeki "Sayfayı kopyala" düğmesini kullanabilirsiniz. Bu, tam Markdown içeriğini manuel olarak kopyalamanıza ve daha fazla kullanım için yapay zeka asistanına yapıştırmanıza olanak tanır.
S7: LLMs.txt'yi etkinleştirdikten sonra yapmam gereken başka bir şey var mı?
Ek bir çalışma gerekmez. LLMs.txt özelliğini etkinleştirdikten sonra, sistem otomatik olarak LLMs.txt dosyasını ve her belgeleme sayfası için karşılık gelen bir Markdown (.md) sürümünü oluşturacaktır. Yalnızca orijinal belgelerinizi her zamanki gibi güncellemeye ve sürdürmeye devam etmeniz gerekir.
S8: LLMs.txt'nin doğru çalışıp çalışmadığını nasıl kontrol edebilirim?
Bunu, yayınlanmış belgeleme sitenizin kök dizinindeki /llms.txt yolunu ziyaret ederek doğrulayabilirsiniz. Sayfa, belgeleme bağlantılarınızın yapılandırılmış bir listesini görüntülüyorsa, bu, özelliğin başarıyla etkinleştirildiği ve beklendiği gibi çalıştığı anlamına gelir.
S9: LLMs.txt karmaşık veya derinlemesine iç içe geçmiş şema referanslarını nasıl ele alır?
Apidog bunu işlemek için akıllı özyinelemeli iniş ayrıştırması kullanır. Şemalarınızdaki çok seviyeli iç içe geçmiş referansları otomatik olarak genişletirken, belgeleri iyi yapılandırılmış ve yapay zeka için okunması kolay tutar. Bu, karmaşık şemaların bile hem insanlar hem de yapay zeka araçları için açıkça sunulmasını ve erişilebilir olmasını sağlar.
Sonuç: Yapay Zeka Çağı için API Belgelerini Dönüştürmek
Apidog'un LLMs.txt uygulaması, API belgelerini gerçekten yapay zeka hazır hale getirmede önemli bir ilerlemeyi temsil eder. Temiz Markdown dışa aktarımları ve kapsamlı dizin oluşturma sağlayarak, Apidog insan tarafından okunabilir belgeler ile makine tarafından optimize edilmiş içerik arasındaki boşluğu kapatır.
Bu sadece teknik bir iyileştirme değil; geliştirme ekiplerinin yapay zekayı iş akışları boyunca nasıl kullanabileceği konusunda bir dönüşümdür:
- API spesifikasyonlarınıza göre doğru kod oluşturmak için yapay zekayı etkinleştirerek geliştirmeyi hızlandırın
- Yapay zeka araçlarının API yapınızı doğru yorumlamasını sağlayarak yanlış anlamaları azaltın
- Gereksiz HTML ve JavaScript gürültüsünü ortadan kaldırarak belirteç maliyetlerini düşürün
- Yapay zeka ile belgeleme paylaşımını sorunsuz hale getirerek işbirliğini geliştirin
Apidog'un LLMs.txt desteği ile API belgeleriniz, hem insan geliştiriciler hem de yapay zeka asistanları için daha iyi yazılımları daha hızlı oluşturmak için birlikte çalışan güçlü bir varlık haline gelir.
Bu özellikleri bugün kullanmaya başlayın: Markdown bağlantılarını yapay zeka araçlarıyla paylaşın, belgeleme içeriğini doğrudan yapay zeka konuşmalarına kopyalayın ve geliştirme sürecinizde yeni bir verimlilik seviyesi deneyimleyin.