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.