Cloudflare Agents ile ajanlar arası devirde bağlamı kim taşıyor?

Bir satın alma talebi geldiğinde ilk ajan belgeyi okuyor, ikinci ajan tedarikçi kaydını kontrol ediyor, üçüncüsü ödeme öncesi eksikleri özetliyor. Her biri kendi işini doğru yapmış olabilir. Yine de satın alma uzmanı ekrana baktığında şu sorunun cevabını bulamıyor: Bu talep şu anda kimin üzerinde ve hangi bilgiye dayanarak ilerledi? Birden fazla ajan çalıştırmak, tek bir ajanın yükünü bölüyor. İşin sahipliğini ise kendiliğinden açıklamıyor.

Cloudflare Agents SDK, Cloudflare Durable Objects üzerinde kalıcı durum tutan ajan örnekleri kurmak için açık kaynak bir araç takımı. Her ajan örneğinin adreslenebilir bir kimliği, kendi depolaması ve yaşam döngüsü var. Gerçek zamanlı iletişim, zamanlanmış işler, araç bağlantıları ve çok adımlı süreçler için yapı taşları sunuyor. Modelin araçlarla düşünme döngüsünü hazır almak isteyenler için ayrıca Think katmanı var. SDK ile Think aynı şey değil: ilki çalıştırma zemini ve bileşenleri, ikincisi daha belirgin bir ajan davranışı biçimi sağlıyor.

Bu yazının odağı hız veya kesinti sonrasında toparlanma değil. Daha sıradan bir durum: iş, iki ajan arasında el değiştirdiğinde kaydın neye benzediği.

Aynı sistemde iki ayrı sınır

Durable Object örneği başına ayrı depolama tutmak yararlı bir özellik. Satın alma ajanının konuşma durumu, tedarikçi doğrulama ajanının durumuyla gelişigüzel karışmaz. Ama kayıtların ayrılması, iş kararının nasıl birleştirileceğini söylemez. Talebin bütçesi bir örnekte, tedarikçi durumu başka bir örnekte ve son onay üçüncü bir sistemdeyse, ekibin hepsini birbirine bağlayan bir iş kimliğine ihtiyacı var.

Örneğin talep_431 kaydı, başlangıçta verilen bir iş kimliği olsun. Ajanlar arası her devirde bu kimlik taşınır. Devir mesajı yalnızca “kontrol edildi” demez; kontrol edilen belge sürümünü, kullanılan tedarikçi kaydının zamanını, sonucu ve belirsiz kalan noktayı da belirtir. Böylece sonraki ajan kendi görevi için gereken veriyi alır, öncekinin tüm konuşma geçmişini kopyalamak zorunda kalmaz. Hassas verileri her ara mesaja taşımamak hem yetki alanını hem de kayıt yükünü daraltır.

Cloudflare’ın ajan belgeleri, Agent sınıfını durum ve iletişim gerektiren uygulamalar için, Workflows’u ise sohbet olmayan uzun ve adımlı süreçler için ayrı yollar olarak anlatıyor. Bu fark, çok ajanlı bir işte önemli: sürekli yaşayan ajanlar bir görevin çeşitli parçalarını ele alabilir, ancak hangi adımın tamamlandığını ve sırada ne olduğunu ayrıca bir süreç kaydında tutmak çoğu zaman daha anlaşılırdır.

Devir bir sohbet mesajı değildir

Satın alma örneğinde birinci ajan faturaya benzeyen bir dosyadan tutar çıkarıyor. İkinci ajan tedarikçi bilgilerini kontrol ediyor. İlk ajan “tutar 40 bin” diye yazdıysa ve belge sonradan yenilendiyse, ikinci ajanın yalnızca bu cümleyi okuması yeterli olmaz. Devir sözleşmesinde kaynak belgenin kimliği, sürümü ve güvenilir kabul edilen alanlar açıkça yer almalı. Alan yoksa sonraki ajan tahmin ederek doldurmamalı; işi eksik bilgi durumuna taşımalı.

Burada iki kayıt tutulabilir. İlki ajanların kendi teknik durumu: hangi araç çağrıldı, yanıt geldi mi, işlem tekrar denenebilir mi? İkincisi işin ortak durumu: talep alındı, belge incelendi, tedarikçi kontrolü bekleniyor, insan onayı gerekli veya sonuçlandı. İkinci kayıt, işi devralacak kişinin anlayacağı dille yazılmalı. Bir ajan başka bir ajana iç düşünce metnini aktarsa bile bu metin tek başına denetlenebilir karar kaydı olmaz.

Cloudflare’ın ajan araçları yaklaşımı sohbet edebilen alt ajanların bir üst ajan tarafından araç gibi çağrılmasını mümkün kılıyor. Bu, dar kapsamlı araştırma ya da özet çıkarma işleri için kullanışlı olabilir. Fakat alt ajanın cevabı, muhasebe sistemindeki bir kaydın veya yetkili kişinin onayının yerine geçmez. Hangi ajan hangi kaynağı okuyabilir, hangi ajan dış sisteme yazabilir soruları uygulamanın yetki tasarımında çözülmeli. Bir üst ajanın alt ajanı çağırabilmesi, ona sınırsız karar yetkisi verildiği anlamına gelmez.

Biten görevi kim kabul ediyor?

Tedarikçi kontrolünün sonucu “eşleşme bulundu” olabilir. Satın alma sürecinin sonucu ise bundan daha geniştir. Bütçe, sözleşme koşulları ve istisnalar ayrı değerlendirmeler ister. Onay yetkisi insandaysa, ajan bu adımı sessizce tamamlanmış işaretlememeli. Bekleyen onayı açık bir durum olarak saklamak ve karar geldiğinde ilgili verinin hâlâ güncel olup olmadığını kontrol etmek gerekir. Devir sırasında oluşan gecikme, iş verisinin geçerliliğini değiştirebilir.

Cloudflare Workflows uzun adımlı ve insan müdahalesi gerektiren akışları yürütmek için kullanılabilir. Bu olanak iş akışını görünür kılmaya yardım eder, fakat hangi kişiye hangi tutar için onay yetkisi verildiğini kendiliğinden tanımlamaz. Bu kurallar değişirse ajan kodunu, iş akışı koşullarını ve ekipteki görev tanımını birlikte gözden geçirmek gerekir. Yalnızca kod tarafını güncellemek, eski onay tablosunu kullanan başka bir sistemle çelişki yaratabilir.

Böyle bir kurulumda başarının ölçüsü, kaç ajanın konuştuğu değil, işin herhangi bir anında tek bir kayıttan şu dört soruya cevap verilebilmesidir: Talep kime ait? Son doğrulanan veri ne? Sıradaki adım ne? Bir hata çıkarsa hangi insan karar verecek? Bu sorulara yanıt yoksa daha fazla ajan, daha fazla görünmez devir noktası demektir.

Küçük bir uygulama sınaması

İlk denemede üç ajanlı büyük bir sistem kurmak gerekmiyor. Tek bir talep türü seçilebilir. Bir ajan veriyi okur, bir başkası yalnızca doğrulama yapar; dış sisteme yazma yetkisi verilmez. Ortak iş kimliği, devir kayıtlarının alanları ve insanın işi durdurabileceği nokta yazılı hale getirilir. Ardından kasıtlı olarak eksik belge ve eski tedarikçi kaydıyla sınama yapılır. Ajanlar eksikliği dürüstçe gösterebiliyor mu, yoksa birbirlerinin varsayımlarını kesin bilgi gibi mi tekrar ediyor?

Bu denemenin çıktısı gösterişli bir sohbet dökümü değil, devredilebilir bir iş kaydı olmalı. Her kararın dayandığı kaynak görülebilmeli. Hata halinde talep kaybolmamalı; yeniden deneme aynı işi ikinci kez yaratmamalı. İnsan devraldığında teknik oturumları tek tek açmadan neyin beklendiğini anlayabilmeli. Böylece araç seçimi, bir organizasyon problemine verilen somut yanıtla sınanır.

Cloudflare Agents ajanların durumunu ve iletişimini kurmak için esnek bir zemin sunuyor. Ancak ajanlar arası devrin kime bağlı olduğu ve sonucun kimin sorumluluğunda kaldığı ayrı bir organizasyon katmanı gerektiriyor. Bu katmanı dosyalarla görünür kılmaya çalışan agentic-organization, AI ajanlarını organizasyon şemasında birinci sınıf üye olarak yönetmek için self-hosted, dosya tabanlı bir platformdur.