Michael JohnsonCloudflare, 2 Ekim 2026’da AI Gateway üzerinden AI ajanları ve uygulamaları için bir web arama arayüzü olan Web Search API’yi tanıttı. Şirket başlangıçta Ceramic.ai, Exa ve Linkup’ı entegre etti. 8 Ekim’de kontrol edilen ve 2 Ekim’de güncellenen resmî genel bakış dokümantasyonu, ürünü açık beta olarak tanımlıyor.
Geliştiriciler için temel yenilik, mevcut model iş akışına arama ekleyebilmek. AI Gateway entegrasyonunun açıklamasına göre arama istekleri, model istekleriyle aynı günlüklerden, analizlerden, faturalandırma ve erişim denetimi araçlarından yararlanıyor. Böylece arama, bir ajanın görev yürütme sürecinde izlenebilir ayrı bir aşama olarak ele alınabiliyor.
Bir ajanın arama isteğine neden ihtiyacı var?
Cloudflare, duyurusunda pratik bir soruna dikkat çekiyor: Bir ajan, gereken sayfanın adresini tahmin edebilir ve yanlış URL’ye yapılan istek 404 hatası döndürebilir. Arama aracı farklı bir yol sunar: Bir sorgu oluşturulur, ilgili materyallerin adresleri alınır ve bulunan bilgiler yanıt hazırlanırken kullanılır.
İkinci kullanım senaryosu, model eğitildikten sonra ortaya çıkan değişikliklerle çalışmaktır. Cloudflare özellikle güncel olaylardan, değişen API’lerden ve yeni araç sürümlerinden söz ediyor. Kod yazmaya yardımcı olan bir ajan için belirli bir kitaplık sürümüne ait dokümantasyonu veya yeni eklenmiş bir parametreyi aramak yararlı olabilir. Bu süreçte arama, bağlam oluşturacak materyali sağlar; hangi sonuçların modele aktarılacağına ise uygulama karar verir.
Ekiplere yönelik pratik öneri: Bulunan alıntıyla birlikte URL’sini ve arama sorgusunu da saklayın. Böylece yanıtı incelerken ajanın hangi materyale dayandığını belirleyebilirsiniz. Sürüme bağlı görevlerde, ürün adını ve gereken sürümü arama sorgusuna açıkça eklemek de yararlıdır.
Yeni API nasıl entegre edilir?
Dokümantasyon iki çağrı yöntemi açıklıyor: harici bir arka uçtan REST API ve Cloudflare Workers içinde AI binding. Sağlayıcı, provider parametresiyle seçiliyor. Üç hizmet de sonuçları başlıklar, URL’ler ve açıklamalardan oluşan ortak bir biçimde döndürüyor. Bu, uygulamanın yanıt işleme bölümünde sağlayıcı değiştirmeyi kolaylaştırıyor.
Ortak biçim, özel bir arama aracı bağdaştırıcısı oluşturmayı kolaylaştırıyor. Bu bağdaştırıcının görevi, ajanın sorgusunu almak, seçilen sağlayıcıyı çağırmak ve seçilen sonuçları modele aktarmak. Uygulama düzeyinde, sonuç açıklamasının ne zaman yeterli olacağına, bulunan sayfanın ne zaman açılıp belirli bir iddianın doğrulanması gerekeceğine ayrıca karar verilmelidir.
AI Gateway’in yerleşik sunucu tarafı araçları, lansman duyurusunda gelecekte sunulacak bir özellik olarak belirtiliyor. Cloudflare, web aramasının bu araçlardan ilki olacağını söylüyor. Lansmanda gösterilen senaryo, araç çağrısının işlenmesi ve arama yanıtının modele gönderilecek bir sonraki isteğe aktarılması için özel bir orkestrasyon öngörüyor.
Hangi koşullar doğrulandı?
Dokümantasyondaki ödeme koşullarına göre istekler, Cloudflare’ın ek ücret almaksızın ilgili sağlayıcının herkese açık API fiyatı üzerinden AI Gateway kredileriyle ödenebiliyor. Kendi Anahtarını Getir (Bring Your Own Key) seçeneği, yani arama sağlayıcısının API anahtarını kullanmak da destekleniyor. Ekip, bu yöntemi seçerse harcamaları nereden takip edeceğini ve faturalandırılan tutarları nasıl karşılaştıracağını önceden belirlemeli.
Kontrol edilen duyuruda ve genel bakış sayfasında belirli fiyatlar ya da sayısal istek kotaları yer almıyor. Bu nedenle entegrasyon bütçesi, seçilen sağlayıcının tarifesi kontrol edildikten sonra hesaplanmalı. Kabul testlerini kendi görevlerinize göre oluşturmak yararlıdır: uygun kaynakların oranı, yanıt süresi, tamamlanan görev başına arama isteği sayısı ve hata işleme.
Veri saklama da ayrı bir konu. Cloudflare, Zero Data Retention açıklamasında, ZDR desteği sunan iş ortaklarını belirteceğini söylüyor. Belirli bir arama rotasında sağlayıcının saklama koşulları ve AI Gateway günlük ayarları ayrıca kontrol edilmeli: duyuru, arama sorgularının gözlemlenebilirlik sistemine kaydedileceğini de doğruluyor.
Sağlayıcılar ayrıca Cloudflare’ın Verified bots gerekliliklerine uymayı taahhüt ediyor: botlarını tanımlamak, robots.txt ve tarama yönergelerini dikkate almak, makul bir istek sıklığını korumak ve site sahiplerinin tercihlerine saygı göstermek. Web Search API genel bakışı, her sonuç için kaynak bağlantısının zorunlu olduğunu doğruluyor.
Geliştiriciler için bu lansman, web aramasını bir ajana bağlamak ve kullanımını ortak bir çerçevede izlemek için anlaşılır bir başlangıç noktası sunuyor. Değerlendirmeye az sayıda gerçek görevle başlamak, sağlayıcıyı açıkça seçmek ve yanıtlardaki bağlantıları saklamak iyi bir yaklaşım. Bulunan materyallerin uygulamanın belirli işleri yürütmesine ne ölçüde yardımcı olacağını bu kararlar belirleyecek.