{"title":"Praktik Terbaik Memori","slug":"memory-best-practices","category":"guides","summary":"Cara menstrukturkan memori untuk recall yang efektif — kategori, key, tag, prioritas.","audience":["human","llm"],"tags":["guide","memory","best-practices","patterns"],"difficulty":"intermediate","updated":"2026-06-27","word_count":632,"read_minutes":3,"lang":"id","translated":true,"requested_lang":"id","content_markdown":"\n# Praktik Terbaik Memori\n\nBagaimana Anda menstrukturkan memori menentukan seberapa berguna memori tersebut.\nPanduan ini mencakup pola untuk mengkategorikan, menandai, dan memprioritaskan\nmemori sehingga LLM dapat recall informasi yang tepat pada waktu yang tepat.\n\n## Kategori: Pilih yang Paling Spesifik\n\n| Kategori | Gunakan Untuk | Contoh |\n|----------|---------|---------|\n| `identity` | Nama pengguna, peran, info kontak | `\"user_name\": \"Michael Schäfer\"` |\n| `preference` | Suka, tidak suka, gaya kerja | `\"communication\": \"Prefers concise responses\"` |\n| `fact` | Fakta yang dapat diverifikasi | `\"office_location\": \"Berlin, Germany\"` |\n| `project` | Status proyek, keputusan | `\"project_synapse\": \"v1.5.0 deployed\"` |\n| `skill` | Keahlian pengguna | `\"skill_python\": \"Advanced, 10+ years\"` |\n| `mistake` | Error masa lalu yang harus dihindari | `\"mistake_npm_version\": \"Always bump version\"` |\n| `context` | Konteks yang relevan dengan sesi | `\"current_focus\": \"Working on docs system\"` |\n| `note` | Catatan lain-lain | `\"note_idea\": \"Try Redis for caching\"` |\n\n> [!TIP]\n> Jika ragu, gunakan `fact` untuk info yang dapat diverifikasi dan `note` untuk\n> yang lainnya. Jangan berlebihan mengkategorikan — lebih baik memiliki `fact`\n> yang jelas daripada `context` yang membingungkan.\n\n## Key: Identifier Bermakna\n\nField `key` adalah identifier memori. Gunakan key yang bermakna dan stabil:\n\n**Key yang baik:**\n- `user_name`\n- `project_synapse_status`\n- `preference_communication_style`\n- `mistake_npm_version_bump`\n\n**Key yang buruk:**\n- `mem_001` (tidak bermakna)\n- `temp` (tidak deskriptif)\n- `2026-06-27-note` (tanggal tidak membantu recall)\n\n### Konvensi penamaan key\n\n- `snake_case` (huruf kecil dengan garis bawah)\n- Awali dengan kategori: `preference_*`, `project_*`, `mistake_*`\n- Gunakan kata benda deskriptif, bukan kata kerja\n- Jaga di bawah 50 karakter\n\n## Tag: Untuk Pencarian dan Pemfilteran\n\nTag memungkinkan pemfilteran dan pencarian cepat. Tambahkan 2-5 tag per memori:\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### Pola tag\n\n- **Nama proyek**: `synapse`, `synapse-mcp`, `synapse-chat`\n- **Topik**: `deployment`, `ci`, `database`, `auth`\n- **Status**: `active`, `completed`, `blocked`\n- **Indikator prioritas**: `urgent`, `long-term`\n\n> [!NOTE]\n> Tag tidak case-sensitive. Gunakan huruf kecil untuk konsistensi.\n\n## Prioritas: Realistis\n\n| Prioritas | Gunakan Untuk | % Memori |\n|----------|---------|---------------|\n| `critical` | Identitas pengguna, info hukum, keputusan ireversibel | ~5% |\n| `high` | Proyek aktif, preferensi penting | ~20% |\n| `normal` | Sebagian besar fakta, catatan, konteks | ~65% |\n| `low` | Efemeral, bagus untuk diketahui | ~10% |\n\n> [!WARNING]\n> Jangan tandai semuanya `critical`. Jika semuanya critical, tidak ada yang critical.\n> Simpan `critical` untuk hal-hal yang akan menyebabkan kerugian nyata jika dilupakan.\n\n## Kapan Menyimpan vs Tidak Menyimpan\n\n### Selalu simpan\n\n- Identitas pengguna (nama, email, peran)\n- Preferensi jangka panjang\n- Keputusan proyek dan rasional\n- Kesalahan masa lalu dan pelajaran yang dipetik\n- Komitmen yang dibuat kepada pengguna\n\n### Jangan simpan\n\n- State sementara (gunakan variabel sebagai gantinya)\n- Riwayat percakapan verbatim (sistem chat menangani ini)\n- Data sensitif (kata sandi, API key)\n- Fakta yang mudah diturunkan (tanggal saat ini, konten file)\n- Konteks efemeral (gunakan kategori `context` dengan prioritas rendah)\n\n## Memperbarui Memori\n\nPOST `/memory` dengan `category` + `key` yang sama memperbarui memori yang ada:\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> Gunakan key yang stabil sehingga Anda dapat memperbarui tanpa membuat duplikat.\n> LLM harus POST ulang key yang sama saat info berubah, bukan membuat memori baru.\n\n## Siklus Hidup Memori\n\n```\nCreate → Active → Stale → Archive → Delete\n```\n\n- **Create**: POST /memory dengan konteks penuh\n- **Active**: Recall sering, perbarui sesuai kebutuhan\n- **Stale**: Masih relevan tetapi tidak aktif digunakan (prioritas lebih rendah?)\n- **Archive**: Tetapkan prioritas ke `low`, simpan untuk referensi historis\n- **Delete**: DELETE /memory/:id saat tidak lagi relevan\n\n### Pembersihan berkala\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## Pola: Warisan Memori\n\nUntuk konteks hierarkis (proyek → subproyek → tugas):\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 kemudian dapat mencari `q=synapse+docs` untuk menemukan semua memori terkait.\n\n## Pola: Log Keputusan\n\nSimpan keputusan dengan rasional sehingga LLM tidak membahasnya ulang:\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## Pola: Penghindaran Kesalahan\n\nSimpan kesalahan dengan instruksi penghindaran spesifik:\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## Anti-Pola yang Harus Dihindari\n\n> [!WARNING]\n> - **Menyimpan log percakapan** — sistem chat menangani ini\n> - **Menyimpan seluruh file** — gunakan penyimpanan skrip atau penyimpanan eksternal\n> - **Menyimpan state efemeral** — gunakan variabel\n> - **Menyimpan rahasia** — gunakan variabel lingkungan\n> - **Menduplikasi memori** — gunakan key yang stabil\n> - **Tag berlebihan** — 2-5 tag per memori adalah ideal\n> - **Semuanya critical** — realistis dengan prioritas\n\n## Langkah Berikutnya\n\n- [Memory API](/docs/api/memory)\n- [Agen LLM Persisten](/docs/guides/persistent-llm-agent)\n- [Strategi Penandaan Memori](/docs/llm-cookbook/memory-tagging-strategy)\n","content_html":"

Praktik Terbaik Memori

\n

Bagaimana Anda menstrukturkan memori menentukan seberapa berguna memori tersebut.\nPanduan ini mencakup pola untuk mengkategorikan, menandai, dan memprioritaskan\nmemori sehingga LLM dapat recall informasi yang tepat pada waktu yang tepat.

\n

Kategori: Pilih yang Paling Spesifik

\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
KategoriGunakan UntukContoh
identityNama pengguna, peran, info kontak"user_name": "Michael Schäfer"
preferenceSuka, tidak suka, gaya kerja"communication": "Prefers concise responses"
factFakta yang dapat diverifikasi"office_location": "Berlin, Germany"
projectStatus proyek, keputusan"project_synapse": "v1.5.0 deployed"
skillKeahlian pengguna"skill_python": "Advanced, 10+ years"
mistakeError masa lalu yang harus dihindari"mistake_npm_version": "Always bump version"
contextKonteks yang relevan dengan sesi"current_focus": "Working on docs system"
noteCatatan lain-lain"note_idea": "Try Redis for caching"
\n
Jika ragu, gunakan `fact` untuk info yang dapat diverifikasi dan `note` untuk\nyang lainnya. Jangan berlebihan mengkategorikan — lebih baik memiliki `fact`\nyang jelas daripada `context` yang membingungkan.

Key: Identifier Bermakna

\n

Field key adalah identifier memori. Gunakan key yang bermakna dan stabil:

\n

Key yang baik:

\n\n

Key yang buruk:

\n\n

Konvensi penamaan key

\n\n

Tag: Untuk Pencarian dan Pemfilteran

\n

Tag memungkinkan pemfilteran dan pencarian cepat. Tambahkan 2-5 tag per memori:

\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}

Pola tag

\n\n
Tag tidak case-sensitive. Gunakan huruf kecil untuk konsistensi.

Prioritas: Realistis

\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
PrioritasGunakan Untuk% Memori
criticalIdentitas pengguna, info hukum, keputusan ireversibel~5%
highProyek aktif, preferensi penting~20%
normalSebagian besar fakta, catatan, konteks~65%
lowEfemeral, bagus untuk diketahui~10%
\n
Jangan tandai semuanya `critical`. Jika semuanya critical, tidak ada yang critical.\nSimpan `critical` untuk hal-hal yang akan menyebabkan kerugian nyata jika dilupakan.

Kapan Menyimpan vs Tidak Menyimpan

\n

Selalu simpan

\n\n

Jangan simpan

\n\n

Memperbarui Memori

\n

POST /memory dengan category + key yang sama memperbarui memori yang ada:

\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")
Gunakan key yang stabil sehingga Anda dapat memperbarui tanpa membuat duplikat.\nLLM harus POST ulang key yang sama saat info berubah, bukan membuat memori baru.

Siklus Hidup Memori

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

Pembersihan berkala

\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")

Pola: Warisan Memori

\n

Untuk konteks hierarkis (proyek → subproyek → tugas):

\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 kemudian dapat mencari q=synapse+docs untuk menemukan semua memori terkait.

\n

Pola: Log Keputusan

\n

Simpan keputusan dengan rasional sehingga LLM tidak membahasnya ulang:

\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")

Pola: Penghindaran Kesalahan

\n

Simpan kesalahan dengan instruksi penghindaran spesifik:

\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")

Anti-Pola yang Harus Dihindari

\n

Langkah Berikutnya

\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"]}