Temel sorunun tespiti
- Yapay zeka ajanları, insanlardan farklı olarak CSS, istemci tarafı JS ve görsellere hiç ihtiyaç duymuyor
- Bu unsurlar sadece token tüketiyor ve gerçekte neredeyse hiç faydalı bilgi sunmuyor
- Ajanların ihtiyaç duyduğu şey yalnızca temiz ve yapılandırılmış metin
Vercel’in çözümü
- İçerik anlaşması (Content Negotiation) HTTP mekanizmasının kullanılması
- Aynı URL’de, istemci isteğine göre farklı format döndürülmesi
- İnsanlar (tarayıcı) → tam HTML + CSS + JS deneyimi
- Yapay zeka ajanları → Markdown sunumu
- Ayrı bir site veya içerik çoğaltması olmadan uygulanması
Çalışma şekli (Accept başlığı tabanlı)
- Ajanların gönderdiği örnek başlık
Accept: text/markdown, text/html, */*- → Markdown’ı en önce tercih ettiğini açıkça belirtir
- Vercel middleware’i Accept başlığını inceler
- Markdown tercih edilirse → Next.js route handler’a iletilir
- Contentful rich-text içeriği Markdown’a dönüştürülerek yanıt verilir
- Kod blokları: sözdizimi vurgulama işaretleri korunur
- Başlıklar: hiyerarşik yapı korunur
- Bağlantılar: olduğu gibi korunur
Etkiler ve sayılar
- Tipik bir blog yazısı
- HTML sürümü: yaklaşık 500KB
- Markdown sürümü: yaklaşık 2KB
- Boyut azaltma oranı: %99,6
- Faydalar
- Token bütçesi verimliliğini en üst düzeye çıkarır → işaretleme yerine gerçek bilgiye odaklanılır
- İstek başına daha fazla içerik işlenebilir
- Daha hızlı çalışma + token sınırına daha az ulaşma
Teknik bakım
- Next.js 16’nın remote cache’i + paylaşılan slug kullanımı
- Contentful içeriği güncellendiğinde HTML ve Markdown sürümlerinin aynı anda yenilenmesi → senkronizasyon korunur
Ajanların keşfini destekleme
- Markdown formatında özel bir site haritası sunulması
- İçerdiği bilgiler: yayın tarihi, içerik türü, HTML/Markdown sürümlerinin doğrudan bağlantıları vb.
- Ajanlar kullanılabilir tüm içeriğin haritasını anlayabilir → en uygun formatı seçmeleri kolaylaşır
Sonuç olarak anlamı
- İnsanların ve yapay zekanın web’i tüketme biçimlerinin temelden farklı olduğunu kabul ediyor
- Her istemciye optimize edilmiş deneyim sunan pratik bir örnek
- Hem insanlar hem de yapay zeka için web anlayışının önemli bir başlangıç noktası
2 yorum
Böyle şeyleri örnek almak iyi olabilir.
Gelecekte web, UI/UX olmayan bir biçime dönüşebilir sanırım..