# Bellek Modeli SUMMARY: Bellekler nasıl yapılandırılır — kategoriler, anahtarlar, etiketler, öncelikler, kaynaklar, doğrulama. Bellek Modeli Synapse'in bellek modeli LLM ajanları için tasarlanmıştır — güvenilir geri çağırma için yeterince yapılandırılmış, her alan için yeterince esnek. Bellek Anatomisi [CODE BLOCK] Alanlar | Alan | Tip | Gerekli | Açıklama | |-------|------|----------|-------------| | | string | otomatik | Benzersiz ID (memxxx) | | | enum | ✅ | 8 kategoriden biri | | | string | ✅ | Kararlı tanımlayıcı (güncellemeler için kullanılır) | | | string | ✅ | Bellek içeriği (herhangi bir metin) | | | string[] | – | Arama ve filtreleme için | | | enum | – | low, normal, high, critical (varsayılan: normal) | | | enum | otomatik | user, agent (kim sakladı) | | | bool | otomatik | Bir insan bunu doğruladı mı? | | | float | – | 0.0 - 1.0 (varsayılan: user için 1.0, agent için 0.7) | | | timestamp | – | Bu bellek ne zaman unutulur | | | string | otomatik | Bu hangi mind'e ait | | | timestamp | otomatik | İlk saklandığı zaman | | | timestamp | otomatik | Son değişiklik | Kategoriler Sekiz kategori, yaygın LLM ajan kullanım senaryolarını kapsar: | Kategori | Amaç | Örnek İçerik | |----------|---------|-----------------| | | Kullanıcı kim | "Kullanıcı Michael Schäfer, Berlin'de yazılım mühendisi" | | | Kullanıcı tercihleri | "Öz ve teknik yanıtları tercih eder" | | | Doğrulanabilir bilgiler | "Ofis Berlin'de, saat dilimi Europe/Berlin" | | | Proje durumu | "Synapse v1.5.0 dağıtıldı, v1.6.0 docs üzerinde çalışılıyor" | | | Kullanıcının becerileri | "İleri Python, 10+ yıl" | | | Geçmiş hatalar | "npm sürümünü yükseltmeyi unuttum — CI başarısız oldu" | | | Oturum bağlamı | "Şu anda PR #42 inceleniyor" | | | Çeşitli notlar | "Bir sonraki sprint için önbellekleme için Redis'i dene" | Anahtarlar: Kararlı Tanımlayıcılar alanı kritiktir — yinelenen oluşturmadan bellekleri nasıl güncelleyeceğinizdir. [CODE BLOCK] Anahtar kuralları: - (category, mind) içinde benzersiz olmalı - kullanın - Netlik için kategori ile önekleyin: , - Kararlı tutun — oluşturduktan sonra anahtarları değiştirmeyin Etiketler: Arama İçin Etiketler hızlı filtreleme ve arama sağlar: [CODE BLOCK] Etiket en iyi uygulamaları: - Bellek başına 2-5 etiket (aşırı etiketlemeyin) - Tutarlılık için küçük harf - Proje adları, konular, teknolojiler kullanın - Etiketler büyük/küçük harf duyarsızdır Öncelik Düzeyleri | Öncelik | Ne Zaman Kullanılır | Geri Çağırma Davranışı | |----------|-------------|-----------------| | | Kimlik, yasal, geri alınamaz | Geri çağırmada her zaman en üstte | | | Aktif projeler, temel tercihler | Geri çağırmada öne çıkan | | | Çoğu bellek (varsayılan) | Standart geri çağırma sırası | | | Geçici, bilmek güzel | Özetlenebilir | önceliğe göre (önce critical), sonra yeniliğe göre sıralar. Kaynak: User ve Agent Bellekler ile etiketlenir: - — bir insan tarafından saklandı (JWT veya insan arayüzü ile) - — bir LLM ajanı tarafından saklandı (Mind Key ile) Bu şunları etkiler: - Doğrulama: bellekleri otomatik doğrulanır, bellekleri doğrulanmaz - Güven: varsayılan 1.0, 0.7 - Geri çağırma: doğrulanmamış bellekleri "(unverified)" ile işaretler > [!NOTE] > kaynaklı bellekleri uygun şüpheyle ele alın. Bunlar kullanıcı tarafından doğrudan belirtilmekten ziyade çıkarılmış veya varsayılmış olabilir. Doğrulama bayrağı, bir insanın belleği onayladığını gösterir: - bellekleri: otomatik doğrulanır () - bellekleri: varsayılan doğrulanmamış () Bellekleri şununla doğrulayın: [CODE BLOCK] > [!NOTE] > Doğrulama JWT (insan kimlik doğrulaması) gerektirir, Mind Key (ajan kimlik doğrulaması) değil. Bu, yalnızca insanların bellekleri doğrulanmış olarak işaretleyebilmesini sağlar. Güven alanı (0.0 - 1.0) belleğin ne kadar güvenilir olduğunu gösterir: - 1.0 — kullanıcı tarafından doğrudan belirtilmiş - 0.7 — ajan tarafından çıkarılmış - 0.5 — belirsiz, doğrulama gerekiyor - 0.0 — açıkça şüpheli Saklarken güveni ayarlayın: [CODE BLOCK] Son Kullanma Zamana duyarlı bellekler için ayarlayın: [CODE BLOCK] Süresi dolmuş bellekler tarafından döndürülmez (ama veritabanında hala mevcut). Yakında süresi dolacak bellekleri görmek için kullanın. Bellek Yaşam Döngüsü [CODE BLOCK] Geri Çağırma Davranışı , LLM bağlamı için optimize edilmiş düz metin özeti döndürür: [CODE BLOCK] - Önceliğe göre sıralanır (critical → low), sonra yeniliğe göre - Doğrulanmamış bellekler ile işaretlenir - Bağlam için etiketler dahil edilir - Düz metin (JSON ayrıştırma gerekmez) Sonraki Adımlar - Memory API - Bellek En İyi Uygulamaları - FTS5 Arama