Cloudflare Agents SDK'ya ücretsiz katmanda MCP client ve Durable Object desteği eklendi

Ücretsiz katmandaki ajanlar artık pratik hale geliyor

dev.to'da yayımlanan bir anlatıma göre Cloudflare'ın Agents SDK'sı artık ücretsiz katmanda MCP client ve Durable Object desteği sunuyor. Pratikte bu, bir geliştiricinin durum tutan ve araç kullanan bir yapay zeka ajanı oluşturup Cloudflare'ın edge noktalarında çalıştırabileceği, boşta kaldığında sıfıra kadar ölçekleneceği ve kullanım ücretsiz limitleri aşana kadar hiçbir altyapı faturası üretmeyeceği anlamına geliyor.

Üç katman

Yazı, mimariyi iş birliği yapan üç parçaya bölüyor. Workers, işlem gücünü sağlıyor: HTTP isteklerini karşılayan ve ajan mantığını yürüten hafif, küresel ölçekte dağıtık bir JavaScript ve TypeScript runtime. Durable Objects, durumu sağlıyor: ajan durumu, konuşma geçmişi ve bağlam için kullanılan, ACID işlem garantileri sunan tek örnekli, güçlü tutarlılığa sahip nesneler. MCP (Model Context Protocol) client ve server katmanı ise entegrasyonu sağlıyor; ajanların SAP, GitHub ve veritabanları gibi harici servisleri çağırmasına ya da diğer ajanların bağlanabileceği MCP server'ları barındırmasına imkân tanıyor.

Yazarın anlattığı akışta bir Worker istek alıyor, MCP client bir Durable Object'te saklanan bağlamı kullanarak harici servisleri sorguluyor, ajan sonuç üzerinde akıl yürütüyor ve yanıt, yazının iddiasına göre küresel ölçekte bir saniyenin altındaki gecikmeyle geri dönüyor.

MCP server'ı açığa çıkarmak için iki yol

Durum tutan, uzun süre çalışan ajanlar için SDK bir McpAgent temel sınıfı sunuyor. Bu, konuşma durumunu koruması ya da zamanla bilgi biriktirmesi gereken ajanlara uygun; aynı sınıf, tool, resource ve prompt için standart MCP isteklerinin yanı sıra özel HTTP endpoint'leri de hizmete sunabiliyor.

Durumsuz işler için createMcpHandler, /mcp gibi bir route altında herhangi bir Worker'a bağlanabilen bağımsız bir handler oluşturuyor. Yazar, bunu basit ve idempotent işlemler için ya da durumun Cloudflare D1 veya Workers KV gibi harici depolarda tutulduğu durumlarda öneriyor.

Ücretsiz katman gerçekte neye izin veriyor

Yazı, bir mimariye karar vermeden önce bilinmesi değerinde limitleri sıralıyor. Ücretsiz katmandaki Workers, günde 100.000 istek, toplam 10 MB bellek depolaması, istek başına ortalama 50 ms CPU süresi, en fazla 30 saniyelik istek süresi ve 30 benzersiz script alıyor. Durable Objects tarafında 1.000 nesne, tüm nesnelerde toplam 128 MB depolama, nesne başına günde 1.000 okuma ve yazma ve çağrı başına 10 saniyelik üst sınır var.

Uyarılar arasında özel alan adlarının olmaması (yalnızca bir workers.dev alt alan adı), sınırlı tanılama araçları, uptime SLA'sının bulunmaması ve yoğun dönemlerde hız sınırına takılma olasılığı sayılıyor. Yazar, ayda 5 dolarlık ücretli katmanın çoğu limiti kabaca on kat artırdığını belirtiyor. Bu rakamlar Cloudflare'ın fiyatlandırma dokümantasyonundan değil tek bir topluluk yazısından geldiği için garanti değil, başlangıç noktası olarak değerlendirmek gerekiyor.

Tool yığmak yerine Code Mode

Yazının en keskin argümanı tool tasarımıyla ilgili. Arka uçtaki her fonksiyonu ayrı bir tool olarak açığa çıkaran ajanlar — SAP entegrasyonunda 200'den fazla olabiliyor — modelin bağlam penceresini dolduruyor ve tool seçimini güvenilmez hale getiriyor. SDK'nın desteklediği alternatif ise, modelin yazdığı JavaScript kodunu zaman aşımı ve kaynak limitleri olan sandbox'lı bir ortamda çalıştıran tek bir execute_code tool'u.

İddia edilen faydalar: yüzlerce yerine tek bir tool tanımı, işlemlerin dinamik olarak birleştirilmesi, her işlemi önceden tahmin etme zorunluluğunun kalmaması, tool tanımlarına dokunmadan arka uçta değişiklik yapılabilmesi ve açık güvenlik sınırları. SAP için yazar, fonksiyon fonksiyon bir yüzey yerine sorguları ve fonksiyon çağrılarını kuran tek bir soyutlama katmanı tool'u öneriyor.

Kurumsal erişim için OAuth

Bir ajanı iş sistemlerine bağlamak gerçek kimlik doğrulama gerektiriyor. Yazı, standart OAuth 2.0 authorization-code akışını adım adım anlatıyor ve el yapımı uygulamalar yerine yerleşik client kütüphaneleri kullanmayı, token'ları bir Durable Object veya KV'de saklamadan önce şifrelemeyi, token'ları süreleri dolmadan otomatik olarak yenilemeyi ve mümkün olan en dar kapsamları istemeyi öneriyor. Sağlayıcıya özel notlar arasında GitHub token kapsamları, sunucudan sunucuya erişim için Salesforce'un JWT Bearer akışı ve ortama bağlı olarak SAP için SAML Bearer veya client-credentials akışları yer alıyor.

Neden önemli

Üretim kalitesinde bir ajan yayına almanın maliyet tabanı, prototipler ve düşük trafikli iş yükleri için fiilen sıfıra düştü. Ekipleri genellikle ücretli sunuculara iten iki gereksinim — kalıcı durum ve standart bir tool protokolü — artık kredi kartı olmadan kullanılabiliyor ve bir sonraki adım, yönetilmesi gereken bir küme değil 5 dolarlık bir plan. Kısıtlar mali değil operasyonel: Durable Object başına günde 1.000 okuma ve yazma, çok konuşkan bir ajanı hızlıca zorlar; SLA'nın ve ayrıntılı tanılamanın yokluğu ise gerçek kullanıcılar sonuca bağlı olduğunda önem kazanır. Yine de denemeler ve MVP'ler için edge'de barındırılan ajanların ekonomisi anlamlı biçimde değişti.