TLDR: Çoğu ajan sıfırlanır ve unutur. İşte benim oluşturduğum tam hafıza yığını; ajanlarım yeniden başlatmalar arasında bağlam paylaşsın, birbirlerine basmadan koordine olsun ve kararları aylarca saklasın diye.
Kimsenin çözmediği sorun
Tipik bir AI ajanı hafıza düzeneği şöyledir: Önemli şeyleri sistem istemine tıkıştır. Bağlam penceresinin dolmamasını um. Sıfırla ve her şeyi kaybet.
6 ay boyunca yüzlerce oturum boyunca iki koordineli ajan (Ella OpenClaw'da, Lyra Hermes'te) çalıştırdım. Onları faydalı kılan en büyük şey modeller veya araçlar değil. Hafıza mimarisi.
Lyra gece 2'de bir düzeltme gönderdiğinde, Ella sabah bunu biliyor. Ocak'ta sırların nasıl saklanması gerektiğine karar verdiğimde, her iki ajan da Temmuz'da hâlâ bu kararı takip ediyor. Bir oturum görev ortasında çöktüğünde, bir sonraki oturum tam kaldığı yerden devam ediyor.
İşte tam 4 katmanlı sistem.
Katman 1: Oturum içi bağlam
Her oturum iki dosyayı okuyarak başlar. Kimlik dosyası, ajanın sürekli kimliğidir. Yapılandırmaya gömülü bir sistem istemi değil. Düzenleyebileceğim gerçek bir işaretleme dosyası. Ajanın nasıl davranması gerektiğini, neye öncelik verdiğini, sormadan asla ne yapmadığını ve diğer ajanlarla ilişkisini tutar.
Hafıza indeks dosyası, oturumlar arasında hatırlanmaya değer her şeyin indeksidir. Bir vektör veritabanı değil. Gömmeler değil. Tek tek hafıza dosyalarını işaret eden düz bir içindekiler tablosu. Her hafıza dosyası, bir adı, açıklaması, türü ve kısa bir gövdesi olan kısa bir nottur. İndeks her zaman yüklenir. Tek tek dosyalar, ilgili olduğunda talep üzerine okunur.
Neden işaretleme? Çünkü okuyabilir, düzenleyebilir ve hata ayıklayabilirim. Bir ajan yanlış davranmaya başladığında, indeksi açar ve kötü talimatı bulurum. Bir davranışı değiştirmek istediğimde, dosyayı düzenlerim. API yok. Kontrol paneli yok. Yeniden eğitim yok.
Katman 2: Oturum sonrası saklama (Hindsight)
Yalnızca işaretleme hafızasının sorunu: yalnızca birinin açıkça yazdıklarını yakalar. En değerli bağlam örtüktür. Bir çalışma sırasında alınan kararlar. Bir görevden çıkarılan gerçekler. Önemli olduğu ortaya çıkan şeyler.
Hindsight, localhost'ta çalışan yerel bir gerçek saklama arka ucudur. Her anlamlı oturumun sonunda, ajan otomatik olarak seçilmiş bir dizi saklanmış gerçeği adlandırılmış bir bankaya iter. Her ajanın kendi bankası vardır.
Saklananlar: oturum sırasında alınan kararlar, kullanıcı veya proje hakkında bariz olmayan gerçekler, başarısızlık desenleri ve benimsediğimiz düzeltmeler ile kullanıcının onayladığı veya düzelttiği tercihler.
Yeni bir oturum başladığında, ajan cevap vermeden önce Hindsight ilgili bağlam için sorgulanır. Transkriptler üzerinde tam metin araması değildir. Ajanın ileriye taşımaya değer olduğunu öğrendiği, türe göre etiketlenmiş seçilmiş gerçeklerdir.
Önerilen yol: Hindsight gerçeği, insan incelemesi, hafıza indeks girişi. Bir insan onay kapısı ile otomatik saklama.
Katman 3: Paylaşılan uzun vadeli durum (Nexus)
İkinci bir ajan eklediğinizde tek ajanlı hafıza bozulur. Sürüklenirler. Biri X'in mevcut proje durumu olduğunu düşünür. Diğeri Y'yi düşünür. Bir hafta içinde birbirleriyle çelişirler.
Çözüm, her iki ajanın da okuyup yazdığı paylaşılan, incelenebilir bir durum dosyasıdır. Nexus adını verdiğim bir Obsidian kasası kullanıyoruz. Her iki ajanın da her anlamlı turdan sonra ekleme yaptığı canlı bağlam günlüğü, bir proje durum dosyası, bir kararlar günlüğü ve uzun görevler sırasında birkaç araç çağrısında bir güncellenen ajan başına çalışma bağlamı kontrol noktası tutar.
Canlı bağlam dosyası gerçek zamanlı el sıkışmadır. Değişmez kural: her cevaptan önce oku. Her anlamlı turdan sonra ona ekle.
Lyra gece 2'de bir PR'ı bitirdiğinde ve Ella sabah sorumu yanıtlıyorsa, Ella zaten biliyordur. Günlüğü okumuştur. Mesaj geçişi yok. Ajanlar arası API yok. Yoklama yok. Bir paylaşılan dosya, iki ajan, yalnızca ekleme günlüğü.
Katman 4: Aranabilir bilgi (gbrain)
İlk üç katman epizodik hafızayı işler. Ne oldu, neye karar verildi, ileriye taşınması gereken ne var. gbrain anlamsal katmandır. Nexus kasası üzerinde bir MCP sunucusu olarak çalışan derlenmiş bir vikidir. Yazılmış her şey üzerinde tam metin ve anlamsal arama.
Bir ajan bir araştırma sorusunu yanıtlaması, önceki bir sentezi bulması veya daha önce bir sorun sınıfını nasıl ele aldığımıza bakması gerektiğinde, her dosyayı yeniden okumak yerine gbrain'i sorgular. Çıktı, kaynakçası olan sıralanmış bir ilgili sayfalar listesidir. Ajan ilgili olanı okur. Tüm kasayı bağlama dökmez.
Hafıza ile hatırlama arasındaki fark budur. Katman 1'den 3'e ajanın taşıdığını işler. Katman 4, ajanın bakabileceği şeyi işler.
Ajanlar arası senkronizasyon değişmezi
İki ajan, bir canlı bağlam dosyası. Risk: birbirlerinin üzerine yazarlar veya birbirlerinin girişlerini kaçırırlar. Çalıştırdığımız değişmez: her giriş, ajan adı, kanal, tür ve bir satırlık özet ile imzalanır. Yalnızca ekleme. Başkasının girişini asla düzenleme. Lyra ilgili bir şey kaydettiyse, Ella bir sonraki cevapta bunu açıkça kabul eder. Önemli kararlar için, her iki ajan da bir zaman damgası ve gerekçe ile kararlar günlüğüne yazar.
Bu, yüzlerce oturum boyunca çalıştı. Bir çatışmamız oldu: bir devir teslim sırasında her iki ajanın da aynı dakika içinde ekleme yaptığı bir yarış durumu. Çözüm: her iki girişi oku, bir sonraki turda uzlaştır. Otomatik birleştirme gerekmez.
Bunun yerini aldığı şey
Bu mimariden önce: her biri kendi bayat bağlamına sahip beş bağlantısız sohbet oturumu. Birbirleriyle çelişen ajanlar çünkü hiçbiri diğerinin ne bildiğini göremiyordu. Üç hafta önce verdiğim talimatlar, unutuldu. Kafamda yaşayan kararlar, bir dosyada değil.
Sonra: her cevaptan önce kendilerini bilgilendiren iki ajan. Hiçbirinin inkar edemeyeceği paylaşılmış bir durum günlüğü. Aylarca süren bağlam sıfırlamalarına dayanan saklanmış kararlar. Düzenleyip doğrulayabileceğim bir dosyadaki her davranış tercihi.
Dürüst takas: bu sistem disiplin gerektirir. Bir şeyleri yazmalısınız. Dosyaları korumalısınız. Kalıcı hale gelmeden önce neyin saklandığını gözden geçirmelisiniz. Sihirli, her zaman açık bir sistem değildir. Dikişlerde yapılandırılmış manuel disiplin artı otomasyondur.
Nasıl başlanır
Bu sistemin birinci sürümünü çalıştırmak için iki ajana veya tam bir kasaya ihtiyacınız yok.
Adım 1: Bir kimlik dosyası artı bir hafıza indeksi. Bunları oluşturun. Oturum başlangıcında okuyun. Ajanı aynı şey için ikinci kez düzelttiğinizde her davranış tercihini indekse yazın.
Adım 2: Bir paylaşılmış durum dosyası. Birden fazla ajan çalıştırıyorsanız veya Claude'u birden çok pencerede kullanıyorsanız, bir canlı bağlam dosyası oluşturun. Her oturum sonunda ona ekler ve başında okur.
Adım 3: Bir saklama kuralı. Bir oturum, hayatta kalması gereken bir karar ürettiğinde, bunu manuel olarak indekse yazın. Desene güvenene kadar bunu elle yapın. Ardından işaretlemeyi otomatikleştirin.
Adım 4: Gerçek başına dosya, tek bir büyük belge değil. İndeks, tek tek dosyaları işaret eder. Bu, diğerlerine dokunmadan bayat bir hafızayı silmeyi kolaylaştırır.
Tam 4 katmanlı yığının stabilize olması yaklaşık 6 ay sürdü. Katman 1 ve 3 bir hafta sonu sürdü. Oradan başlayın.
Çıkarım
Çoğu ajan hafıza düzeneği, fazladan adımlarla bağlam penceresi yönetimidir. Pencere sıfırlanana veya ikinci bir ajan ekleyene kadar çalışırlar.
Dayanıklı ajan hafızası bir altyapı sorunudur, bir istem sorunu değil. Cevap, farklı zaman ufuklarına sahip birden çok katmandır: oturum içi bağlam, oturumlar arası gerçekler, paylaşılan durum, aranabilir bilgi.
Bizimki tamamen düz işaretleme. Vektör veritabanı yok. Gömmeler yok. Yeniden eğitim yok. Sadece açabileceğim, düzenleyebileceğim ve hata ayıklayabileceğim dosyalar.
Gerçekten faydalı olan ajanlar, en büyük bağlam penceresine sahip olanlar değil. Önemli olanı hatırlayan ve önemsiz olanı unutanlardır.
Gerçek işe emanet etmek istediğiniz ajanlar oluşturuyorsanız, daha fazla araç eklemeden önce hafıza mimarisiyle başlayın.
Referans verilen araçlar
Hindsight (yerel hafıza saklama): https://github.com/vectorize-io/hindsight
gbrain (derlenmiş viki / anlamsal arama): https://github.com/garrytan/gbrain
OpenClaw (ajan çalışma zamanı): https://openclaw.ai
Hermes (ajan çalışma zamanı): hermes-agent.nousresearch.com
