E-ticaret storefront'ları bugüne kadar temel olarak insanlar ve arama motorları için tasarlanıyordu. Yeni commerce mimarisinde üçüncü bir tüketici ortaya çıkıyor: AI agent'lar.
Bir AI agent'ın mağazayla çalışabilmesi için ürün sayfasındaki butonları insan gibi tahmin ederek tıklaması ideal yöntem değildir. Agent'ın mağazanın hangi işlemleri desteklediğini makine tarafından anlaşılabilir biçimde keşfedebilmesi gerekir.
UCP nedir?
UCP, yani Universal Commerce Protocol, AI agent'lar ile commerce sistemleri arasında standart bir iletişim katmanı oluşturmayı amaçlayan protocol yaklaşımıdır.
Bir agent farklı mağazalara girdiğinde her mağazanın ürün yapısı, sepet davranışı, checkout akışı ve commerce capabilities'i farklı olabilir. Agent'ın her site için özel entegrasyon yazması ölçeklenebilir değildir.
Protocol yaklaşımında storefront kendi yeteneklerini açıklar.
/.well-known/ucp neden önemli?
Agent mağazaya geldiğinde “Bu siteyle nasıl konuşacağım?” sorusunun cevabını HTML'i reverse-engineer ederek aramak yerine belirli discovery endpoint'inden alabilir.
Capability negotiation nedir?
Agent capabilities ile merchant capabilities karşılaştırılır ve ortak yetenek seti üzerinden işlem yürütülür. Bu klasik API version negotiation mantığına benzer.
Bu WebMCP ile aynı şey mi?
Tam olarak değil.
Discovery → Agent mağazanın yeteneklerini öğrenir.
Protocol → Sistemler nasıl konuşacağını belirler.
Storefront Actions → Commerce işlemi gerçekleştirilir.
Neden DOM automation yeterli değil?
Browser agent'ı butonu bulup click yapabilir. Ancak theme veya UI değişirse interaction bozulabilir. Standard commerce action UI'dan bağımsızdır.
Storefront artık UI değil interface de olmak zorunda
Storefront aynı anda hem presentation layer hem machine interaction surface haline geliyor.
SEO ile benzerlik nerede?
Arama motorları için semantic HTML, canonical, structured data, sitemap ve robots directives kullanıyoruz.
SEO'da machine-readable content neyse, agentic commerce'te machine-readable capabilities benzer role sahip olabilir.
Ürün verisi yine kritik
Agent mağazanın commerce action'larını kullanabilse bile kötü product data'yı düzeltemez. Ürün verisi semantic, güncel ve yapılandırılmış olmalıdır.
AI-ready storefront nasıl düşünülmeli?
| Katman | Soru |
|---|---|
| Product Data | Agent ürünü anlayabiliyor mu? |
| Structured Data | Ürün makine tarafından okunabilir mi? |
| Discovery | Storefront capability'leri bulunabiliyor mu? |
| Actions | Commerce işlemleri standardize mi? |
| State | Cart tutarlı mı? |
| Checkout | Transaction güvenli mi? |
| Policies | Shipping/return açık mı? |
| Observability | Agent interaction ölçülüyor mu? |
Headless storefront'lar ne yapmalı?
Headless architecture kullanan markalar product schema, cart state, commerce actions, analytics ve agent discovery katmanlarını bilinçli tasarlamalıdır.
Headless'ın avantajı tam kontroldür. Dezavantajı da tam kontroldür.
AI commerce için storefront audit checklist
- Product data semantic olarak yeterli mi?
- Variant bilgileri açık mı?
- Price ve availability güncel mi?
- Shipping bilgisi makine tarafından anlaşılabilir mi?
- Return policy structured mı?
- Cart action'ları UI component'lerinden ayrılmış mı?
- Cart state tek source of truth mu?
- Mutation'lar idempotent mi?
- Checkout business rule'ları frontend'e bağımlı mı?
- UCP discovery destekleniyor mu?
- Agent interaction analytics'te ayrılabiliyor mu?
- Rate limiting var mı?
- Riskli işlemler için authorization uygulanıyor mu?
Bugün marka ne yapmalı?
Önce commerce foundation temizlenmeli:
- ürün verisi,
- variant modeli,
- fiyat/stok doğruluğu,
- structured policies,
- cart consistency,
- standard commerce actions,
- checkout business rules,
- analytics.
Agentic commerce kötü commerce architecture'ın üzerine eklenen bir chatbot değildir; iyi commerce architecture'ın yeni bir consumer'ıdır.
UCP gibi protokolleri neden önemsemeliyiz?
Yeni agent kanalları için her platforma özel entegrasyon yazmak yüksek bakım ve schema çeşitliliği yaratır.
Ortak protokol yaklaşımı discovery ve capability negotiation'ı standardize etmeye çalışır.
Capability negotiation
Agent:
- ne destekliyorsun?
- hangi sürüm?
- hangi action?
- hangi auth?
sorularını machine-readable biçimde cevaplayabilmelidir.
Discovery endpoint'in güvenlik sınırı
Public discovery capability metadata sunabilir; private customer/order data vermemelidir.
Discovery ile authorization ayrılmalıdır.
Action contract
Örnek:
product.search
cart.create
cart.add_line
checkout.start
Her action schema, errors, auth ve idempotency davranışı tanımlamalıdır.
Version compatibility
Backward compatibility veya negotiated version olmadan ecosystem kırılır.
Headless storefront etkisi
Protocol endpoint storefront framework'ten bağımsız commerce backend/BFF katmanında tutulabilir.
Observability
- agent identity,
- capability,
- latency,
- conversion,
- error
ayrı raporlanabilir.
Commerce state consistency
Protocol “price 100” derken storefront “price 120” dememelidir. Her iki yüzey aynı canonical pricing/inventory service'ten beslenmelidir.
Hazırlık checklist
- canonical product identity,
- stable cart API,
- authorization,
- idempotent mutations,
- structured policy,
- source-aware order metadata,
- rate limit,
- audit log.
Protokol desteği ile agent-ready olmak aynı şey değildir
Endpoint'i açmak yeterli değildir. Altta:
- yanlış product identity,
- stale stock,
- güvenilmez policy,
- idempotent olmayan cart API
varsa protocol yalnız mevcut problemi daha fazla kanala taşır.
Önce commerce core contract'ları temizlenmelidir.
Sonuç
Storefront mimarisi giderek yalnız insanlara render edilen sayfalar değil, AI sistemlerinin keşfedebildiği ve capability negotiation yapabildiği commerce endpoints haline geliyor.
Reliefers olarak özel Shopify ve storefront projelerinde önemli architecture kriterlerinden biri agent readiness olmalı. Product data, structured commerce information, standard actions ve transaction güvenliği birlikte tasarlanmadığında yalnız protocol desteği gerçek bir avantaj yaratmaz.