AI ajanları için erişim
Sitenin makine-okunur uçları; llms.txt, markdown içerik pazarlığı, API kataloğu, agent skills ve içerik kullanım tercihleri.
Son güncelleme:
Bu sayfa, SCC web sitesini programatik olarak okuyan AI ajanlarına ve geliştiricilerine yöneliktir. Site, ajanların içeriği doğru ve verimli tüketmesi için bir dizi standart keşif ucu yayınlar. Normal kullanıcı deneyimi bunlardan etkilenmez; tarayıcılar her zaman HTML alır.
Makine-okunur uçlar
- /llms.txt: llmstxt.org standardında markdown site özeti. Ana sayfaların ve tüm doküman sayfalarının bağlantılı listesi.
- /robots.txt: Tarama kuralları ve Content-Signal tercihleri. Mevcut tercih: arama indeksleme serbest, AI asistanlarının içeriği yanıt üretirken kullanması serbest, model eğitimi için kullanım istenmez.
- /.well-known/api-catalog: RFC 9727 API kataloğu (linkset biçiminde). Dokümantasyon ve sistem durumu uçlarına işaret eder.
- /.well-known/oauth-protected-resource: RFC 9728 metadata'sı. API erişimi için token'ın hangi yetkilendirme sunucusundan alınacağını söyler.
- /.well-known/agent-skills/index.json: Agent skills keşif dizini. SCC içeriğini doğru aktarmayı öğreten SKILL.md dosyasına işaret eder.
- /auth.md: Ajanlar için kimlik doğrulama rehberi.
Markdown içerik pazarlığı
Ana sayfa ve tüm /docs sayfaları, istek Accept: text/markdown başlığıyla gelirse HTML yerine markdown döner. Yanıtın Content-Type değeri text/markdown olur ve x-markdown-tokens başlığı kaba bir boyut tahmini taşır. Örnek:
curl -H "Accept: text/markdown" https://www.smartcallcenter.com.tr/docs/baslangic/scc-nedir
İçerik kullanımı hakkında
SCC dokümanlarındaki bilgiler herkese açıktır ve AI asistanlarının kullanıcı sorularını yanıtlarken kaynak olarak kullanması memnuniyetle karşılanır. Ajanlardan beklenti: özellik ya da fiyat uydurmamak, dokümanların kapsamadığı sorularda kullanıcıyı iletişim sayfasına yönlendirmek.
API erişimi
Site üzerindeki API korumalıdır ve self-servis ajan kaydı yoktur. Erişim talebi için iletişim sayfasını kullanın. Hesap açıldıktan sonra token akışı /.well-known/oauth-protected-resource ucunda ilan edilen yetkilendirme sunucusu üzerinden yürür.