{"title":"Bellek Etiketleme Stratejisi","slug":"memory-tagging-strategy","category":"llm-cookbook","summary":"Etkili arama ve filtreleme için bellekleri nasıl etiketlersiniz — ölçeklenen etiketleme sistemi.","audience":["llm"],"tags":["cookbook","tagging","memory","strategy"],"difficulty":"intermediate","updated":"2026-06-27","word_count":338,"read_minutes":2,"lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Bellek Etiketleme Stratejisi\n\nEtiketler, ölçeklenebilir bellek alımının sırrıdır. Bu rehber, doğru olanların doğru zamanda geri gelmesi için bellekleri nasıl etiketleyeceğinizi gösterir.\n\n## Etiketler Neden Önemli\n\nEtiketler olmadan düz tam metin aramanız vardır. Etiketlerle, yapılandırılmış gezinmeniz vardır:\n\n```bash\n# Without tags: search everything\nGET /memory/search?q=docker\n\n# With tags: filter by project + technology\nGET /memory/search?q=deployment&tag=synapse&tag=docker\n```\n\nEtiketler şunları sağlar:\n\n- **Hızlı filtreleme** — `GET /memory/by-tag?tag=production`\n- **Kapsamlı arama** — `?q=auth&tag=project-x`\n- **Gruplama** — bir proje için tüm \"mistake\" belleklerini bulma\n- **Çapraz referans** — etiket paylaşan bellekler ilişkilidir\n\n## Etiketleme Şeması\n\n### Proje etiketleri\n\nProje adlarını etiket olarak kullanın:\n\n```\nsynapse, synapse-mcp, synapse-chat, synapse-sdk\n```\n\n### Teknoloji etiketleri\n\nTeknoloji adları kullanın:\n\n```\ndocker, kubernetes, postgres, fastify, react, typescript\n```\n\n### Konu etiketleri\n\nKonu kategorileri kullanın:\n\n```\ndeployment, ci-cd, auth, database, frontend, backend, security\n```\n\n### Durum etiketleri\n\nDurum göstergeleri kullanın:\n\n```\nactive, completed, blocked, deprecated\n```\n\n### Tip etiketleri\n\nTip göstergeleri kullanın:\n\n```\ndecision, mistake, pattern, reference, todo\n```\n\n## Etiketleme Kuralları\n\n### Kural 1: Bellek başına 2-5 etiket\n\nÇok az etiket = zayıf keşfedilebilirlik. Çok fazla = gürültü.\n\n```json\n// Good: 3 relevant tags\n{ \"tags\": [\"synapse\", \"deployment\", \"docker\"] }\n\n// Bad: 1 tag (too narrow)\n{ \"tags\": [\"synapse\"] }\n\n// Bad: 10 tags (noise)\n{ \"tags\": [\"synapse\", \"deployment\", \"docker\", \"vps1\", \"2026\", \"june\", \"ssh\", \"git\", \"main\", \"production\"] }\n```\n\n### Kural 2: Küçük harf, tireli\n\n```\n✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey\n```\n\n### Kural 3: Tutarlı kelime dağarcığı kullanın\n\nBir etiketleme kelime dağarcığı oluşturun ve ona sadık kalın:\n\n```\n# Project vocabulary\nsynapse, synapse-mcp, synapse-chat\n\n# NOT: synapse_project, synapseProject, SYNAPSE\n```\n\n### Kural 4: Arama niyetiyle etiketleyin\n\nSorun: \"Bu belleği nasıl arayacağım?\"\n\n```json\n// Storing a deployment decision\n{\n \"content\": \"Decided to use Docker Swarm for Synapse deployment\",\n \"tags\": [\"synapse\", \"deployment\", \"docker\", \"swarm\", \"decision\"]\n}\n\n// You'll likely search: ?q=docker+swarm or ?tag=deployment\n```\n\n## Desenler\n\n### Desen 1: Proje + Konu\n\n```json\n{ \"tags\": [\"synapse\", \"deployment\"] }\n{ \"tags\": [\"synapse\", \"auth\"] }\n{ \"tags\": [\"synapse-mcp\", \"tools\"] }\n```\n\nArama: `?tag=synapse` (tüm Synapse proje bellekleri)\nArama: `?tag=synapse&q=deployment` (Synapse'ta dağıtım bellekleri)\n\n### Desen 2: Tip + Alan\n\n```json\n{ \"tags\": [\"mistake\", \"deployment\"] }\n{ \"tags\": [\"decision\", \"database\"] }\n{ \"tags\": [\"pattern\", \"auth\"] }\n```\n\nArama: `?tag=mistake` (tüm hatalar)\nArama: `?tag=mistake&q=deployment` (dağıtım hataları)\n\n### Desen 3: Hiyerarşik\n\nBir proje içindeki alt projeler için:\n\n```json\n{ \"tags\": [\"synapse\", \"synapse-docs\", \"markdown\"] }\n{ \"tags\": [\"synapse\", \"synapse-mcp\", \"mcp\"] }\n{ \"tags\": [\"synapse\", \"synapse-admin\", \"ui\"] }\n```\n\nArama: `?tag=synapse` (tüm Synapse)\nArama: `?tag=synapse-docs` (sadece docs alt projesi)\n\n### Desen 4: Durum izleme\n\n```json\n// Active project\n{ \"tags\": [\"synapse\", \"active\"], \"priority\": \"high\" }\n\n// Completed project\n{ \"tags\": [\"synapse-v1\", \"completed\"], \"priority\": \"low\" }\n\n// Blocked\n{ \"tags\": [\"synapse-v2\", \"blocked\"], \"priority\": \"high\" }\n```\n\n## Yaygın Kullanım Senaryoları\n\n### Bir proje hakkındaki tüm kararları bul\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=decision&tag=synapse\"\n```\n\n### Bir alandaki tüm hataları bul\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=mistake&tag=deployment\"\n```\n\n### Aktif çalışmayı bul\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/by-tag?tag=active\"\n```\n\n### Bir teknoloji hakkındaki bellekleri bul\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=postgres+performance&tag=database\"\n```\n\n## Etiket Bakımı\n\n### Periyodik inceleme\n\n```python\n# Find rarely-used tags (candidates for cleanup)\ntags = requests.get(f\"{URL}/memory/tags\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}).json()\n\nfor tag, count in tags.items():\n if count < 2:\n print(f\"Rare tag: {tag} ({count} memories)\")\n```\n\n### Etiketleri birleştirme\n\nTutarsız etiketleriniz varsa (`docker` ve `Docker`), bunları birleştirin:\n\n```python\n# Find all memories with \"Docker\" tag\nmems = requests.get(f\"{URL}/memory/by-tag?tag=Docker\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}).json()\n\n# Update each to use \"docker\" instead\nfor mem in mems[\"results\"]:\n tags = [t.lower() for t in mem[\"tags\"]]\n update_memory(mem[\"id\"], tags=list(set(tags)))\n```\n\n## En İyi Uygulamalar\n\n> [!TIP]\n> - **Kelime dağarcığını erken oluşturun** — 1. günden itibaren tutarlı etiketler\n> - **Arama niyetiyle etiketleyin** — bunu daha sonra nasıl bulacaksınız?\n> - **2-5 etiket tatlı noktadır** — çok az veya çok fazla kötüdür\n> - **Küçük harf + tireler** — `CI/CD` değil `ci-cd`\n> - **Periyodik olarak inceleyin** — yinelenenleri birleştirin, kullanılmayanları kaldırın\n\n## Sonraki Adımlar\n\n- [Bellek En İyi Uygulamaları](/docs/guides/memory-best-practices)\n- [FTS5 Arama](/docs/concepts/fts5-search)\n- [Görev Odaklı İş Akışı](/docs/llm-cookbook/task-driven-workflow)\n","content_html":"

Bellek Etiketleme Stratejisi

\n

Etiketler, ölçeklenebilir bellek alımının sırrıdır. Bu rehber, doğru olanların doğru zamanda geri gelmesi için bellekleri nasıl etiketleyeceğinizi gösterir.

\n

Etiketler Neden Önemli

\n

Etiketler olmadan düz tam metin aramanız vardır. Etiketlerle, yapılandırılmış gezinmeniz vardır:

\n
# Without tags: search everything\nGET /memory/search?q=docker\n\n# With tags: filter by project + technology\nGET /memory/search?q=deployment&tag=synapse&tag=docker

Etiketler şunları sağlar:

\n\n

Etiketleme Şeması

\n

Proje etiketleri

\n

Proje adlarını etiket olarak kullanın:

\n
synapse, synapse-mcp, synapse-chat, synapse-sdk

Teknoloji etiketleri

\n

Teknoloji adları kullanın:

\n
docker, kubernetes, postgres, fastify, react, typescript

Konu etiketleri

\n

Konu kategorileri kullanın:

\n
deployment, ci-cd, auth, database, frontend, backend, security

Durum etiketleri

\n

Durum göstergeleri kullanın:

\n
active, completed, blocked, deprecated

Tip etiketleri

\n

Tip göstergeleri kullanın:

\n
decision, mistake, pattern, reference, todo

Etiketleme Kuralları

\n

Kural 1: Bellek başına 2-5 etiket

\n

Çok az etiket = zayıf keşfedilebilirlik. Çok fazla = gürültü.

\n
// Good: 3 relevant tags\n{ "tags": ["synapse", "deployment", "docker"] }\n\n// Bad: 1 tag (too narrow)\n{ "tags": ["synapse"] }\n\n// Bad: 10 tags (noise)\n{ "tags": ["synapse", "deployment", "docker", "vps1", "2026", "june", "ssh", "git", "main", "production"] }

Kural 2: Küçük harf, tireli

\n
✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey

Kural 3: Tutarlı kelime dağarcığı kullanın

\n

Bir etiketleme kelime dağarcığı oluşturun ve ona sadık kalın:

\n
# Project vocabulary\nsynapse, synapse-mcp, synapse-chat\n\n# NOT: synapse_project, synapseProject, SYNAPSE

Kural 4: Arama niyetiyle etiketleyin

\n

Sorun: "Bu belleği nasıl arayacağım?"

\n
// Storing a deployment decision\n{\n  "content": "Decided to use Docker Swarm for Synapse deployment",\n  "tags": ["synapse", "deployment", "docker", "swarm", "decision"]\n}\n\n// You'll likely search: ?q=docker+swarm or ?tag=deployment

Desenler

\n

Desen 1: Proje + Konu

\n
{ "tags": ["synapse", "deployment"] }\n{ "tags": ["synapse", "auth"] }\n{ "tags": ["synapse-mcp", "tools"] }

Arama: ?tag=synapse (tüm Synapse proje bellekleri)\nArama: ?tag=synapse&q=deployment (Synapse'ta dağıtım bellekleri)

\n

Desen 2: Tip + Alan

\n
{ "tags": ["mistake", "deployment"] }\n{ "tags": ["decision", "database"] }\n{ "tags": ["pattern", "auth"] }

Arama: ?tag=mistake (tüm hatalar)\nArama: ?tag=mistake&q=deployment (dağıtım hataları)

\n

Desen 3: Hiyerarşik

\n

Bir proje içindeki alt projeler için:

\n
{ "tags": ["synapse", "synapse-docs", "markdown"] }\n{ "tags": ["synapse", "synapse-mcp", "mcp"] }\n{ "tags": ["synapse", "synapse-admin", "ui"] }

Arama: ?tag=synapse (tüm Synapse)\nArama: ?tag=synapse-docs (sadece docs alt projesi)

\n

Desen 4: Durum izleme

\n
// Active project\n{ "tags": ["synapse", "active"], "priority": "high" }\n\n// Completed project\n{ "tags": ["synapse-v1", "completed"], "priority": "low" }\n\n// Blocked\n{ "tags": ["synapse-v2", "blocked"], "priority": "high" }

Yaygın Kullanım Senaryoları

\n

Bir proje hakkındaki tüm kararları bul

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=decision&tag=synapse"

Bir alandaki tüm hataları bul

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=mistake&tag=deployment"

Aktif çalışmayı bul

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/by-tag?tag=active"

Bir teknoloji hakkındaki bellekleri bul

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=postgres+performance&tag=database"

Etiket Bakımı

\n

Periyodik inceleme

\n
# Find rarely-used tags (candidates for cleanup)\ntags = requests.get(f"{URL}/memory/tags",\n    headers={"Authorization": f"Bearer {KEY}"}).json()\n\nfor tag, count in tags.items():\n    if count < 2:\n        print(f"Rare tag: {tag} ({count} memories)")

Etiketleri birleştirme

\n

Tutarsız etiketleriniz varsa (docker ve Docker), bunları birleştirin:

\n
# Find all memories with "Docker" tag\nmems = requests.get(f"{URL}/memory/by-tag?tag=Docker",\n    headers={"Authorization": f"Bearer {KEY}"}).json()\n\n# Update each to use "docker" instead\nfor mem in mems["results"]:\n    tags = [t.lower() for t in mem["tags"]]\n    update_memory(mem["id"], tags=list(set(tags)))

En İyi Uygulamalar

\n

Sonraki Adımlar

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