{"title":"Bellek Modeli","slug":"memory-model","category":"concepts","summary":"Bellekler nasıl yapılandırılır — kategoriler, anahtarlar, etiketler, öncelikler, kaynaklar, doğrulama.","audience":["human","llm"],"tags":["concept","memory","model","structure"],"difficulty":"intermediate","updated":"2026-06-27","word_count":684,"read_minutes":3,"lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Bellek Modeli\n\nSynapse'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.\n\n## Bellek Anatomisi\n\n```json\n{\n \"id\": \"mem_abc123\",\n \"category\": \"project\",\n \"key\": \"project_synapse_status\",\n \"content\": \"Synapse v1.5.0 deployed on vps1. CI green.\",\n \"tags\": [\"synapse\", \"deployment\", \"v1.5.0\"],\n \"priority\": \"high\",\n \"source\": \"agent\",\n \"verified\": false,\n \"confidence\": 0.85,\n \"expires_at\": null,\n \"mind_id\": \"m_xyz789\",\n \"created_at\": \"2026-06-27T...\",\n \"updated_at\": \"2026-06-27T...\"\n}\n```\n\n## Alanlar\n\n| Alan | Tip | Gerekli | Açıklama |\n|-------|------|----------|-------------|\n| `id` | string | otomatik | Benzersiz ID (mem_xxx) |\n| `category` | enum | ✅ | 8 kategoriden biri |\n| `key` | string | ✅ | Kararlı tanımlayıcı (güncellemeler için kullanılır) |\n| `content` | string | ✅ | Bellek içeriği (herhangi bir metin) |\n| `tags` | string[] | – | Arama ve filtreleme için |\n| `priority` | enum | – | low, normal, high, critical (varsayılan: normal) |\n| `source` | enum | otomatik | user, agent (kim sakladı) |\n| `verified` | bool | otomatik | Bir insan bunu doğruladı mı? |\n| `confidence` | float | – | 0.0 - 1.0 (varsayılan: user için 1.0, agent için 0.7) |\n| `expires_at` | timestamp | – | Bu bellek ne zaman unutulur |\n| `mind_id` | string | otomatik | Bu hangi mind'e ait |\n| `created_at` | timestamp | otomatik | İlk saklandığı zaman |\n| `updated_at` | timestamp | otomatik | Son değişiklik |\n\n## Kategoriler\n\nSekiz kategori, yaygın LLM ajan kullanım senaryolarını kapsar:\n\n| Kategori | Amaç | Örnek İçerik |\n|----------|---------|-----------------|\n| `identity` | Kullanıcı kim | \"Kullanıcı Michael Schäfer, Berlin'de yazılım mühendisi\" |\n| `preference` | Kullanıcı tercihleri | \"Öz ve teknik yanıtları tercih eder\" |\n| `fact` | Doğrulanabilir bilgiler | \"Ofis Berlin'de, saat dilimi Europe/Berlin\" |\n| `project` | Proje durumu | \"Synapse v1.5.0 dağıtıldı, v1.6.0 docs üzerinde çalışılıyor\" |\n| `skill` | Kullanıcının becerileri | \"İleri Python, 10+ yıl\" |\n| `mistake` | Geçmiş hatalar | \"npm sürümünü yükseltmeyi unuttum — CI başarısız oldu\" |\n| `context` | Oturum bağlamı | \"Şu anda PR #42 inceleniyor\" |\n| `note` | Çeşitli notlar | \"Bir sonraki sprint için önbellekleme için Redis'i dene\" |\n\n## Anahtarlar: Kararlı Tanımlayıcılar\n\n`key` alanı kritiktir — yinelenen oluşturmadan bellekleri nasıl güncelleyeceğinizdir.\n\n```python\n# First store\nstore(\"project\", \"project_synapse_status\", \"v1.4.0 deployed\", priority=\"high\")\n\n# Update with same key (overwrites, doesn't duplicate)\nstore(\"project\", \"project_synapse_status\", \"v1.5.0 deployed\", priority=\"high\")\n```\n\n**Anahtar kuralları:**\n\n- (category, mind) içinde benzersiz olmalı\n- `snake_case` kullanın\n- Netlik için kategori ile önekleyin: `preference_communication`, `mistake_npm_version`\n- Kararlı tutun — oluşturduktan sonra anahtarları değiştirmeyin\n\n## Etiketler: Arama İçin\n\nEtiketler hızlı filtreleme ve arama sağlar:\n\n```bash\n# Find all memories with tag \"docker\"\nGET /memory/by-tag?tag=docker\n\n# FTS5 search within tagged subset\nGET /memory/search?q=swarm&tag=docker\n```\n\n**Etiket en iyi uygulamaları:**\n\n- Bellek başına 2-5 etiket (aşırı etiketlemeyin)\n- Tutarlılık için küçük harf\n- Proje adları, konular, teknolojiler kullanın\n- Etiketler büyük/küçük harf duyarsızdır\n\n## Öncelik Düzeyleri\n\n| Öncelik | Ne Zaman Kullanılır | Geri Çağırma Davranışı |\n|----------|-------------|-----------------|\n| `critical` | Kimlik, yasal, geri alınamaz | Geri çağırmada her zaman en üstte |\n| `high` | Aktif projeler, temel tercihler | Geri çağırmada öne çıkan |\n| `normal` | Çoğu bellek (varsayılan) | Standart geri çağırma sırası |\n| `low` | Geçici, bilmek güzel | Özetlenebilir |\n\n`/memory/recall` önceliğe göre (önce critical), sonra yeniliğe göre sıralar.\n\n## Kaynak: User ve Agent\n\nBellekler `source` ile etiketlenir:\n\n- `user` — bir insan tarafından saklandı (JWT veya insan arayüzü ile)\n- `agent` — bir LLM ajanı tarafından saklandı (Mind Key ile)\n\nBu şunları etkiler:\n\n- **Doğrulama**: `user` bellekleri otomatik doğrulanır, `agent` bellekleri doğrulanmaz\n- **Güven**: `user` varsayılan 1.0, `agent` 0.7\n- **Geri çağırma**: `/memory/recall` doğrulanmamış bellekleri \"(unverified)\" ile işaretler\n\n> [!NOTE]\n> `agent` kaynaklı bellekleri uygun şüpheyle ele alın. Bunlar kullanıcı tarafından doğrudan belirtilmekten ziyade çıkarılmış veya varsayılmış olabilir.\n\n## Doğrulama\n\n`verified` bayrağı, bir insanın belleği onayladığını gösterir:\n\n- `user` bellekleri: otomatik doğrulanır (`true`)\n- `agent` bellekleri: varsayılan doğrulanmamış (`false`)\n\nBellekleri şununla doğrulayın:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n -H \"Authorization: Bearer YOUR_JWT\"\n```\n\n> [!NOTE]\n> 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.\n\n## Güven\n\n`confidence` alanı (0.0 - 1.0) belleğin ne kadar güvenilir olduğunu gösterir:\n\n- 1.0 — kullanıcı tarafından doğrudan belirtilmiş\n- 0.7 — ajan tarafından çıkarılmış\n- 0.5 — belirsiz, doğrulama gerekiyor\n- 0.0 — açıkça şüpheli\n\nSaklarken güveni ayarlayın:\n\n```json\n{\n \"category\": \"preference\",\n \"key\": \"prefers_dark_mode\",\n \"content\": \"User seems to prefer dark mode (based on their IDE screenshots)\",\n \"confidence\": 0.5,\n \"source\": \"agent\"\n}\n```\n\n## Son Kullanma\n\nZamana duyarlı bellekler için `expires_at` ayarlayın:\n\n```json\n{\n \"category\": \"context\",\n \"key\": \"current_meeting_topic\",\n \"content\": \"Discussing Q3 roadmap\",\n \"expires_at\": \"2026-06-28T00:00:00Z\"\n}\n```\n\nSüresi dolmuş bellekler `/memory/recall` tarafından döndürülmez (ama veritabanında hala mevcut). Yakında süresi dolacak bellekleri görmek için `/memory/expiring?within=7d` kullanın.\n\n## Bellek Yaşam Döngüsü\n\n```\n ┌─────────────────┐\n │ Create │\n │ POST /memory │\n └────────┬────────┘\n │\n ▼\n ┌─────────────────┐\n │ Active │ ◀──── PUT /memory/:id (update)\n │ (in recall) │\n └────────┬────────┘\n │\n ┌────────────┼────────────┐\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ Expired │ │ Verified │ │ Deleted │\n │ (in DB) │ │ (flag) │ │ (gone) │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Geri Çağırma Davranışı\n\n`GET /memory/recall`, LLM bağlamı için optimize edilmiş düz metin özeti döndürür:\n\n```\nMind: Michael's Mind\nMemories: 12 total (10 verified, 2 unverified)\n\n[001] identity (CRITICAL) [verified]\n user_name\n Michael Schäfer\n Tags: person, identity\n\n[002] preference (HIGH) [verified]\n communication_style\n Prefers concise technical responses\n Tags: communication\n\n[003] project (HIGH) [unverified]\n synapse_status\n v1.5.0 deployed, working on v1.6.0 docs\n Tags: synapse, deployment\n\n...\n```\n\n- Önceliğe göre sıralanır (critical → low), sonra yeniliğe göre\n- Doğrulanmamış bellekler `[unverified]` ile işaretlenir\n- Bağlam için etiketler dahil edilir\n- Düz metin (JSON ayrıştırma gerekmez)\n\n## Sonraki Adımlar\n\n- [Memory API](/docs/api/memory)\n- [Bellek En İyi Uygulamaları](/docs/guides/memory-best-practices)\n- [FTS5 Arama](/docs/concepts/fts5-search)\n","content_html":"

Bellek Modeli

\n

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.

\n

Bellek Anatomisi

\n
{\n  "id": "mem_abc123",\n  "category": "project",\n  "key": "project_synapse_status",\n  "content": "Synapse v1.5.0 deployed on vps1. CI green.",\n  "tags": ["synapse", "deployment", "v1.5.0"],\n  "priority": "high",\n  "source": "agent",\n  "verified": false,\n  "confidence": 0.85,\n  "expires_at": null,\n  "mind_id": "m_xyz789",\n  "created_at": "2026-06-27T...",\n  "updated_at": "2026-06-27T..."\n}

Alanlar

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
AlanTipGerekliAçıklama
idstringotomatikBenzersiz ID (mem_xxx)
categoryenum✅8 kategoriden biri
keystring✅Kararlı tanımlayıcı (güncellemeler için kullanılır)
contentstring✅Bellek içeriği (herhangi bir metin)
tagsstring[]–Arama ve filtreleme için
priorityenum–low, normal, high, critical (varsayılan: normal)
sourceenumotomatikuser, agent (kim sakladı)
verifiedboolotomatikBir insan bunu doğruladı mı?
confidencefloat–0.0 - 1.0 (varsayılan: user için 1.0, agent için 0.7)
expires_attimestamp–Bu bellek ne zaman unutulur
mind_idstringotomatikBu hangi mind'e ait
created_attimestampotomatikİlk saklandığı zaman
updated_attimestampotomatikSon değişiklik
\n

Kategoriler

\n

Sekiz kategori, yaygın LLM ajan kullanım senaryolarını kapsar:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
KategoriAmaçÖrnek İçerik
identityKullanıcı kim"Kullanıcı Michael Schäfer, Berlin'de yazılım mühendisi"
preferenceKullanıcı tercihleri"Öz ve teknik yanıtları tercih eder"
factDoğrulanabilir bilgiler"Ofis Berlin'de, saat dilimi Europe/Berlin"
projectProje durumu"Synapse v1.5.0 dağıtıldı, v1.6.0 docs üzerinde çalışılıyor"
skillKullanıcının becerileri"İleri Python, 10+ yıl"
mistakeGeçmiş hatalar"npm sürümünü yükseltmeyi unuttum — CI başarısız oldu"
contextOturum bağlamı"Şu anda PR #42 inceleniyor"
noteÇeşitli notlar"Bir sonraki sprint için önbellekleme için Redis'i dene"
\n

Anahtarlar: Kararlı Tanımlayıcılar

\n

key alanı kritiktir — yinelenen oluşturmadan bellekleri nasıl güncelleyeceğinizdir.

\n
# First store\nstore("project", "project_synapse_status", "v1.4.0 deployed", priority="high")\n\n# Update with same key (overwrites, doesn't duplicate)\nstore("project", "project_synapse_status", "v1.5.0 deployed", priority="high")

Anahtar kuralları:

\n\n

Etiketler: Arama İçin

\n

Etiketler hızlı filtreleme ve arama sağlar:

\n
# Find all memories with tag "docker"\nGET /memory/by-tag?tag=docker\n\n# FTS5 search within tagged subset\nGET /memory/search?q=swarm&tag=docker

Etiket en iyi uygulamaları:

\n\n

Öncelik Düzeyleri

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ÖncelikNe Zaman KullanılırGeri Çağırma Davranışı
criticalKimlik, yasal, geri alınamazGeri çağırmada her zaman en üstte
highAktif projeler, temel tercihlerGeri çağırmada öne çıkan
normalÇoğu bellek (varsayılan)Standart geri çağırma sırası
lowGeçici, bilmek güzelÖzetlenebilir
\n

/memory/recall önceliğe göre (önce critical), sonra yeniliğe göre sıralar.

\n

Kaynak: User ve Agent

\n

Bellekler source ile etiketlenir:

\n\n

Bu şunları etkiler:

\n\n
`agent` kaynaklı bellekleri uygun şüpheyle ele alın. Bunlar kullanıcı tarafından doğrudan belirtilmekten ziyade çıkarılmış veya varsayılmış olabilir.

Doğrulama

\n

verified bayrağı, bir insanın belleği onayladığını gösterir:

\n\n

Bellekleri şununla doğrulayın:

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"
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

\n

confidence alanı (0.0 - 1.0) belleğin ne kadar güvenilir olduğunu gösterir:

\n\n

Saklarken güveni ayarlayın:

\n
{\n  "category": "preference",\n  "key": "prefers_dark_mode",\n  "content": "User seems to prefer dark mode (based on their IDE screenshots)",\n  "confidence": 0.5,\n  "source": "agent"\n}

Son Kullanma

\n

Zamana duyarlı bellekler için expires_at ayarlayın:

\n
{\n  "category": "context",\n  "key": "current_meeting_topic",\n  "content": "Discussing Q3 roadmap",\n  "expires_at": "2026-06-28T00:00:00Z"\n}

Süresi dolmuş bellekler /memory/recall tarafından döndürülmez (ama veritabanında hala mevcut). Yakında süresi dolacak bellekleri görmek için /memory/expiring?within=7d kullanın.

\n

Bellek Yaşam Döngüsü

\n
                  ┌─────────────────┐\n                  │     Create      │\n                  │  POST /memory   │\n                  └────────┬────────┘\n                           │\n                           ▼\n                  ┌─────────────────┐\n                  │     Active      │ ◀──── PUT /memory/:id (update)\n                  │  (in recall)    │\n                  └────────┬────────┘\n                           │\n              ┌────────────┼────────────┐\n              │            │            │\n              ▼            ▼            ▼\n        ┌──────────┐ ┌──────────┐ ┌──────────┐\n        │ Expired  │ │ Verified │ │ Deleted  │\n        │ (in DB)  │ │ (flag)   │ │ (gone)   │\n        └──────────┘ └──────────┘ └──────────┘

Geri Çağırma Davranışı

\n

GET /memory/recall, LLM bağlamı için optimize edilmiş düz metin özeti döndürür:

\n
Mind: Michael's Mind\nMemories: 12 total (10 verified, 2 unverified)\n\n[001] identity (CRITICAL) [verified]\n  user_name\n  Michael Schäfer\n  Tags: person, identity\n\n[002] preference (HIGH) [verified]\n  communication_style\n  Prefers concise technical responses\n  Tags: communication\n\n[003] project (HIGH) [unverified]\n  synapse_status\n  v1.5.0 deployed, working on v1.6.0 docs\n  Tags: synapse, deployment\n\n...
\n

Sonraki Adımlar

\n\n","urls":{"html":"/docs/concepts/memory-model","text":"/docs/concepts/memory-model?format=text","json":"/docs/concepts/memory-model?format=json","llm":"/docs/concepts/memory-model?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}