Skip to content
← Tüm bölümler

Bölüm 05

Depo arketipleri

Bir ajan tek bir satırı bile değiştirmeden önce, sonrasındaki her şeyi şekillendiren tek bir karar verir: bu ne tür bir depo? Çıkarsadığı arketip, çalışmanın geri kalanında içinde akıl yürüteceği sınırı belirler — nasıl kuruluma alındığını, bir planın ne kadar ileriye uzandığını ve durumun nerede saklandığını. Yanlış anlarsanız, ajan çalışmayı yanlış yüzeye göre kapsamlandırır; bu, uzun vadeli görevlerde driftin en yaygın kaynağıdır. Doğru anlarsanız, ajan saatlerce otonom çalışabilir; çünkü planlar, kuruluma alma ve durum kodun gerçek şekliyle örtüşür.

DWP üç arketip tanır. Depoların çoğu birincisine girer; ikincisi, pek çoğunu koordine eden ekipler için vardır; üçüncüsü ise otonom ajanların uzun ömürlü çalışma alanlarını kapsar.

Bireysel depo

Yaygın durum: kendi kendine yeten bir kod tabanı — bir uygulama, bir kütüphane veya bir servis. Akıl yürütülecek tek bir tutarlı yüzey vardır; bu nedenle planlar doğrudan depodaki kod üzerinde çalışır ve kuruluma alma, deponun kendi yapısını ve kurallarını okur. Ajan tüm kod tabanını bağlam olarak tutar ve onu baştan sona işler.

Özellikler:

  • Tek, tutarlı bir kod tabanı.
  • Planlar bu depodaki dosyaları değiştirir.
  • .dwp/ çalışma alanı depo kökünde yaşar.

Orkestratör merkezi

Koordinasyon durumu: görevi diğer depoları yönetmek olan bir depo. Burada iş birimi bir dosya değil, bir alt depodur; bu nedenle planlar alt depolarda alt planlar başlatabilir ve kuruluma alma, tek bir kod tabanı yerine merkezin yönetilen depolar kaydını okur. Ajan sınırlar ve el değiştirmeler üzerine akıl yürütür — hangi deponun hangi işe sahip olduğu ve durumlarının nasıl tutarlı kaldığı.

Özellikler:

  • Birden çok alt depoyu koordine eder.
  • Planlar alt planlara devredebilir.
  • Yönetilen depoların bir kaydını tutar.
  • Merkez kökündeki .dwp/ çalışma alanı, depolar arası durumu izler.

Ajan çalışma alanı

v2.2’de eklenen üçüncü arketip, bir depoya gelmeden önce bir çalışma alanı olan bir şeyi tanımlar: otonom bir ajanın uzun ömürlü evi. Bir OpenClaw çalışma alanı, bir Hermes servis dizini, bir kişisel asistan daemon’ının veri dizini, bir bulut ajanının kalıcı birimi — her birinin yürütülecek planları, kullanılacak araçları ve sürdürülecek belleği vardır; ancak sevk edilecek bir kod tabanı olmayabilir.

Temel kavrayış şudur: harness, özellikle bir depo değil, bir çalışma alanıdır. DWP’nin bir depoya kurduğu her öğe — AGENTS.md, docs/, .agents/, .dwp/ — bir çalışma alanı karşılığına sahiptir. Metodolojinin yüzeyi temiz bir şekilde eşlenir: kök AGENTS.md’nin yerine daimi bağlam dosyaları geçer, .agents/’ın yerine bir platform skill dizini geçer ve çalışma alanı kökündeki .dwp/ klasörü değişmez. Değişen, git’in rolüdür. Bir depoda, git günlüğü durumu taşır ve planları oturumlar genelinde devam ettirilebilir kılar. Git içermeyen bir çalışma alanında, bu işi state.json üstlenir — bu nedenle makine tarafından okunabilir durum katmanı, ajan çalışma alanları için zorunludur.

Pratik getiri, gece boyunca gözetimsiz planlardır. OpenClaw sınıfı platformlarda, bir kalp atışı veya cron dönüşü ajanı uyarır, DWP devam protokolünü çalıştırır, sonraki atomik görevi yürütür, state.json’u günceller ve verir. Plan — oturum değil — sürekliliğin birimidir. Çok günlük bir plan, yeniden başlatmaları, model değişikliklerini ve oturum sınırlarını aşar; çünkü sonraki dönümün ihtiyaç duyduğu her şey plan dosyalarındadır: hedef, işaretlenmiş ilerleme, kapı kayıtları ve mevcut görevin içindeki tam kontrol noktası.

Özellikler:

  • Otonom ajan platformunun çalışma dizini.
  • Çalışma alanı kökünde AGENTS.md, .agents/ ve .dwp/.
  • Git önerilir, zorunlu değildir.
  • state.json, git yokken ve herhangi bir gözetimsiz çalıştırma için zorunludur.
  • Planlar genellikle zamanlanmış kalp atışı veya cron tarafından yönlendirilen gözetimsiz çalışır.

Sınıflandırma sezgisel kuralı

Üç arketip disk üzerinde farklı görünür ve ajan doğrulayabileceği sinyallere göre aralarında karar verir — kendisine söylenen bir etikete göre değil. Aşağıdaki karar ağacı yolu gösterir; kısacası, platform kimliği sinyalleri mevcutsa ajan çalışma alanı, yalnızca kanıtlar gerektirdiğinde orkestratör merkezi ve aksi takdirde bireysel depo olarak sınıflandırın.

Bir ajan önce ajan çalışma alanı sinyallerini aramalıdır: bir platform kimlik dosyası (OpenClaw’ın SOUL.md veya HEARTBEAT.md’si gibi), birincil uygulama yığını yok ve ağırlıklı olarak ajanın kendi durumu olan içerik. Bunlar yoksa, orkestratör sinyallerini arar: birden çok iç içe git deposu veya alt modül, yönetilen depoların bir kaydı veya manifesti veya harici depolara işaret eden yapılandırma. Her ikisinin yokluğunda, hedefi bireysel depo olarak ele alır — güvenli varsayılan, çünkü var olmayan sınırlar genelinde bir planı aşırı kapsamlandırmak, var olan bir sınır içinde çalışmaktan daha kötüdür.

Kuruluma alma nasıl farklılaşır

Arketip, göstermelik bir etiket değildir; ajanın neyi okuduğunu, planın neye dokunabileceğini ve durumun nerede kaydedildiğini değiştirir.

Yön Bireysel Orkestratör Ajan çalışma alanı
Kapsam Bu depo Birden çok depo Çalışma alanı ve planları
Kuruluma alma Depo yapısı Merkez kaydı Platform dosyaları + çalışma alanı kuralları
Plan hedefi Yerel dosyalar Alt planlar Yerel veya harici depolar
Durum Yerel .dwp/ Depolar arası .dwp/ .dwp/ + state.json (git olmadan zorunlu)

Pratik etki şudur: bireysel depo ajanı tek bir kod tabanı hakkında baştan sona akıl yürütürken, orkestratör ajanı depolar arası koordinasyon hakkında akıl yürütür ve ajan çalışma alanı ajanı oturumlar arası süreklilik hakkında akıl yürütür — neyin planlandığı, neyin çalıştığı, neyin engellendiği ve sırada neyin geldiği.

Arketipi doğru belirlemek, bir ajanın gözetimsiz olarak saatlerce otonom çalışmasını sağlayan şeydir: planları, kuruluma almayı ve durumu doğru sınıra göre kapsamlandırır; böylece ajan ilk görevden sonuncusuna kadar doğru yüzey üzerinde çalışır.