{"title":"Bellek En İyi Uygulamaları","slug":"memory-best-practices","category":"guides","summary":"Etkili geri çağırma için bellekleri nasıl yapılandırırsınız — kategoriler, anahtarlar, etiketler, öncelikler.","audience":["human","llm"],"tags":["guide","memory","best-practices","patterns"],"difficulty":"intermediate","updated":"2026-06-27","word_count":581,"read_minutes":3,"lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Bellek En İyi Uygulamaları\n\nBellekleri nasıl yapılandırdığınız ne kadar yararlı olduklarını belirler. Bu rehber, LLM'in doğru zamanda doğru bilgiyi geri çağırabilmesi için kategorize etme, etiketleme ve önceliklendirme desenlerini kapsar.\n\n## Kategoriler: En Spesifiği Seçin\n\n| Kategori | Kullanım | Örnek |\n|----------|---------|---------|\n| `identity` | Kullanıcı adı, rol, iletişim bilgisi | `\"user_name\": \"Michael Schäfer\"` |\n| `preference` | Beğeniler, beğenmemeler, çalışma tarzı | `\"communication\": \"Prefers concise responses\"` |\n| `fact` | Doğrulanabilir bilgiler | `\"office_location\": \"Berlin, Germany\"` |\n| `project` | Proje durumu, kararlar | `\"project_synapse\": \"v1.5.0 deployed\"` |\n| `skill` | Kullanıcının becerileri | `\"skill_python\": \"Advanced, 10+ years\"` |\n| `mistake` | Kaçınılacak geçmiş hatalar | `\"mistake_npm_version\": \"Always bump version\"` |\n| `context` | Oturumla ilgili bağlam | `\"current_focus\": \"Working on docs system\"` |\n| `note` | Çeşitli notlar | `\"note_idea\": \"Try Redis for caching\"` |\n\n> [!TIP]\n> Şüphede kaldığınızda, doğrulanabilir bilgiler için `fact`, diğer her şey için `note` kullanın. Aşırı kategorize etmeyin — kafa karıştırıcı bir `context`'ten daha iyi net bir `fact`.\n\n## Anahtarlar: Anlamlı Tanımlayıcılar\n\n`key` alanı belleğin tanımlayıcısıdır. Anlamlı, kararlı anahtarlar kullanın:\n\n**İyi anahtarlar:**\n- `user_name`\n- `project_synapse_status`\n- `preference_communication_style`\n- `mistake_npm_version_bump`\n\n**Kötü anahtarlar:**\n- `mem_001` (anlamlı değil)\n- `temp` (tanımlayıcı değil)\n- `2026-06-27-note` (tarih geri çağırmaya yardımcı olmaz)\n\n### Anahtar adlandırma kuralları\n\n- `snake_case` (alt çizgili küçük harf)\n- Kategori ile önekleyin: `preference_*`, `project_*`, `mistake_*`\n- Fiil değil, tanımlayıcı isim kullanın\n- 50 karakterin altında tutun\n\n## Etiketler: Arama ve Filtreleme İçin\n\nEtiketler hızlı filtreleme ve arama sağlar. Bellek başına 2-5 etiket ekleyin:\n\n```json\n{\n \"category\": \"project\",\n \"key\": \"project_synapse_status\",\n \"content\": \"Synapse v1.5.0 deployed. Next: v1.6.0 with docs system.\",\n \"tags\": [\"synapse\", \"deployment\", \"status\", \"v1.5.0\"]\n}\n```\n\n### Etiket desenleri\n\n- **Proje adları**: `synapse`, `synapse-mcp`, `synapse-chat`\n- **Konular**: `deployment`, `ci`, `database`, `auth`\n- **Durum**: `active`, `completed`, `blocked`\n- **Öncelik göstergeleri**: `urgent`, `long-term`\n\n> [!NOTE]\n> Etiketler büyük/küçük harf duyarsızdır. Tutarlılık için küçük harf kullanın.\n\n## Öncelikler: Gerçekçi Olun\n\n| Öncelik | Kullanım | Belleklerin %'si |\n|----------|---------|---------------|\n| `critical` | Kullanıcı kimliği, yasal bilgiler, geri alınamaz kararlar | ~5% |\n| `high` | Aktif projeler, önemli tercihler | ~20% |\n| `normal` | Çoğu bilgi, not, bağlam | ~65% |\n| `low` | Geçici, bilmek güzel | ~10% |\n\n> [!WARNING]\n> Her şeyi `critical` olarak işaretlemeyin. Her şey kritikse, hiçbir şey kritik değildir. `critical`'ı unutulursa gerçek zarara yol açacak şeyler için ayırın.\n\n## Ne Zaman Saklama, Ne Zaman Saklamama\n\n### Her zaman sakla\n\n- Kullanıcı kimliği (ad, e-posta, rol)\n- Uzun vadeli tercihler\n- Proje kararları ve gerekçeler\n- Geçmiş hatalar ve alınan dersler\n- Kullanıcıya verilen taahütler\n\n### Saklama\n\n- Geçici durum (bunun yerine değişkenler kullanın)\n- Birebir sohbet geçmişi (sohbet sistemi bunu ele alır)\n- Hassas veriler (parolalar, API anahtarları)\n- Kolayca türetilebilir bilgiler (mevcut tarih, dosya içerikleri)\n- Geçici bağlam (düşük öncelikli `context` kategorisini kullanın)\n\n## Bellekleri Güncelleme\n\nAynı `category` + `key` ile `POST /memory` mevcut belleği günceller:\n\n```python\n# Initial store\nstore(\"project\", \"project_synapse_status\", \"v1.4.0 deployed\", priority=\"high\")\n\n# Later: update with same key\nstore(\"project\", \"project_synapse_status\", \"v1.5.0 deployed. CI green.\", priority=\"high\")\n```\n\n> [!TIP]\n> Yinelenen oluşturmadan güncelleyebilmeniz için kararlı anahtarlar kullanın. LLM, bilgiler değiştikçe yeni bellekler oluşturmak yerine aynı anahtarı yeniden POST yapmalıdır.\n\n## Bellek Yaşam Döngüsü\n\n```\nCreate → Active → Stale → Archive → Delete\n```\n\n- **Create**: Tam bağlamla POST /memory\n- **Active**: Sık geri çağır, gerektiğinde güncelle\n- **Stale**: Hala ilgili ama aktif kullanılmıyor (düşük öncelik?)\n- **Archive**: Önceliği `low` yap, tarihsel referans için tut\n- **Delete**: Artık ilgili değilse DELETE /memory/:id\n\n### Periyodik temizlik\n\n```python\n# Find memories not updated in 90 days\nold_memories = requests.get(\n f\"{URL}/memory/search?q=*\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}\n)\n\nfor mem in old_memories[\"results\"]:\n if is_stale(mem, days=90):\n # Either delete or lower priority\n if is_obsolete(mem):\n delete_memory(mem[\"id\"])\n else:\n update_memory(mem[\"id\"], priority=\"low\")\n```\n\n## Desen: Bellek Kalıtımı\n\nHiyerarşik bağlam için (proje → alt proje → görev):\n\n```python\n# Parent project\nstore(\"project\", \"project_synapse\", \"Main Synapse project\", \n tags=[\"synapse\", \"parent\"], priority=\"high\")\n\n# Sub-project (tags link to parent)\nstore(\"project\", \"project_synapse_docs\", \"Docs system for Synapse\",\n tags=[\"synapse\", \"docs\", \"synapse-parent\"], priority=\"high\")\n\n# Specific task (tags link to sub-project)\nstore(\"project\", \"task_docs_loader\", \"Implement docs-loader.ts\",\n tags=[\"synapse\", \"docs\", \"task\"], priority=\"normal\")\n```\n\nLLM daha sonra `q=synapse+docs` arayarak tüm ilgili bellekleri bulabilir.\n\n## Desen: Karar Günlüğü\n\nKararları gerekçeleriyle saklayın, böylece LLM onları yeniden tartışmaz:\n\n```python\nstore(\"fact\", \"decision_postgres_over_sqlite\",\n \"Chose PostgreSQL over SQLite for production. Reason: concurrent writes, \"\n \"FTS5 native support, better backup story. Date: 2026-06-15. Decided by: Michael.\",\n tags=[\"decision\", \"database\", \"postgres\", \"sqlite\"],\n priority=\"high\")\n```\n\n## Desen: Hata Önleme\n\nHataları özel önleme talimatlarıyla saklayın:\n\n```python\nstore(\"mistake\", \"mistake_forget_version_bump\",\n \"Forgot to bump package.json version after changes. npm publish failed. \"\n \"FIX: Always run `npm version patch` before pushing. \"\n \"CI fails with 'version already exists' if you forget.\",\n tags=[\"npm\", \"ci\", \"publish\", \"version\"],\n priority=\"high\")\n```\n\n## Kaçınılacak Anti-Desenler\n\n> [!WARNING]\n> - **Sohbet günlüklerini saklama** — sohbet sistemi bunu ele alır\n> - **Tam dosyaları saklama** — betik deposu veya harici depolama kullanın\n> - **Geçici durumu saklama** — değişkenler kullanın\n> - **Gizli bilgileri saklama** — ortam değişkenleri kullanın\n> - **Bellekleri çoğaltma** — kararlı anahtarlar kullanın\n> - **Aşırı etiketleme** — bellek başına 2-5 etiket idealdir\n> - **Her şey kritik** — önceliklerde gerçekçi olun\n\n## Sonraki Adımlar\n\n- [Memory API](/docs/api/memory)\n- [Kalıcı LLM Ajanı](/docs/guides/persistent-llm-agent)\n- [Bellek Etiketleme Stratejisi](/docs/llm-cookbook/memory-tagging-strategy)\n","content_html":"

Bellek En İyi Uygulamaları

\n

Bellekleri nasıl yapılandırdığınız ne kadar yararlı olduklarını belirler. Bu rehber, LLM'in doğru zamanda doğru bilgiyi geri çağırabilmesi için kategorize etme, etiketleme ve önceliklendirme desenlerini kapsar.

\n

Kategoriler: En Spesifiği Seçin

\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
KategoriKullanımÖrnek
identityKullanıcı adı, rol, iletişim bilgisi"user_name": "Michael Schäfer"
preferenceBeğeniler, beğenmemeler, çalışma tarzı"communication": "Prefers concise responses"
factDoğrulanabilir bilgiler"office_location": "Berlin, Germany"
projectProje durumu, kararlar"project_synapse": "v1.5.0 deployed"
skillKullanıcının becerileri"skill_python": "Advanced, 10+ years"
mistakeKaçınılacak geçmiş hatalar"mistake_npm_version": "Always bump version"
contextOturumla ilgili bağlam"current_focus": "Working on docs system"
noteÇeşitli notlar"note_idea": "Try Redis for caching"
\n
Şüphede kaldığınızda, doğrulanabilir bilgiler için `fact`, diğer her şey için `note` kullanın. Aşırı kategorize etmeyin — kafa karıştırıcı bir `context`'ten daha iyi net bir `fact`.

Anahtarlar: Anlamlı Tanımlayıcılar

\n

key alanı belleğin tanımlayıcısıdır. Anlamlı, kararlı anahtarlar kullanın:

\n

İyi anahtarlar:

\n\n

Kötü anahtarlar:

\n\n

Anahtar adlandırma kuralları

\n\n

Etiketler: Arama ve Filtreleme İçin

\n

Etiketler hızlı filtreleme ve arama sağlar. Bellek başına 2-5 etiket ekleyin:

\n
{\n  "category": "project",\n  "key": "project_synapse_status",\n  "content": "Synapse v1.5.0 deployed. Next: v1.6.0 with docs system.",\n  "tags": ["synapse", "deployment", "status", "v1.5.0"]\n}

Etiket desenleri

\n\n
Etiketler büyük/küçük harf duyarsızdır. Tutarlılık için küçük harf kullanın.

Öncelikler: Gerçekçi Olun

\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
ÖncelikKullanımBelleklerin %'si
criticalKullanıcı kimliği, yasal bilgiler, geri alınamaz kararlar~5%
highAktif projeler, önemli tercihler~20%
normalÇoğu bilgi, not, bağlam~65%
lowGeçici, bilmek güzel~10%
\n
Her şeyi `critical` olarak işaretlemeyin. Her şey kritikse, hiçbir şey kritik değildir. `critical`'ı unutulursa gerçek zarara yol açacak şeyler için ayırın.

Ne Zaman Saklama, Ne Zaman Saklamama

\n

Her zaman sakla

\n\n

Saklama

\n\n

Bellekleri Güncelleme

\n

Aynı category + key ile POST /memory mevcut belleği günceller:

\n
# Initial store\nstore("project", "project_synapse_status", "v1.4.0 deployed", priority="high")\n\n# Later: update with same key\nstore("project", "project_synapse_status", "v1.5.0 deployed. CI green.", priority="high")
Yinelenen oluşturmadan güncelleyebilmeniz için kararlı anahtarlar kullanın. LLM, bilgiler değiştikçe yeni bellekler oluşturmak yerine aynı anahtarı yeniden POST yapmalıdır.

Bellek Yaşam Döngüsü

\n
Create → Active → Stale → Archive → Delete
\n

Periyodik temizlik

\n
# Find memories not updated in 90 days\nold_memories = requests.get(\n    f"{URL}/memory/search?q=*",\n    headers={"Authorization": f"Bearer {KEY}"}\n)\n\nfor mem in old_memories["results"]:\n    if is_stale(mem, days=90):\n        # Either delete or lower priority\n        if is_obsolete(mem):\n            delete_memory(mem["id"])\n        else:\n            update_memory(mem["id"], priority="low")

Desen: Bellek Kalıtımı

\n

Hiyerarşik bağlam için (proje → alt proje → görev):

\n
# Parent project\nstore("project", "project_synapse", "Main Synapse project", \n      tags=["synapse", "parent"], priority="high")\n\n# Sub-project (tags link to parent)\nstore("project", "project_synapse_docs", "Docs system for Synapse",\n      tags=["synapse", "docs", "synapse-parent"], priority="high")\n\n# Specific task (tags link to sub-project)\nstore("project", "task_docs_loader", "Implement docs-loader.ts",\n      tags=["synapse", "docs", "task"], priority="normal")

LLM daha sonra q=synapse+docs arayarak tüm ilgili bellekleri bulabilir.

\n

Desen: Karar Günlüğü

\n

Kararları gerekçeleriyle saklayın, böylece LLM onları yeniden tartışmaz:

\n
store("fact", "decision_postgres_over_sqlite",\n      "Chose PostgreSQL over SQLite for production. Reason: concurrent writes, "\n      "FTS5 native support, better backup story. Date: 2026-06-15. Decided by: Michael.",\n      tags=["decision", "database", "postgres", "sqlite"],\n      priority="high")

Desen: Hata Önleme

\n

Hataları özel önleme talimatlarıyla saklayın:

\n
store("mistake", "mistake_forget_version_bump",\n      "Forgot to bump package.json version after changes. npm publish failed. "\n      "FIX: Always run `npm version patch` before pushing. "\n      "CI fails with 'version already exists' if you forget.",\n      tags=["npm", "ci", "publish", "version"],\n      priority="high")

Kaçınılacak Anti-Desenler

\n

Sonraki Adımlar

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