{"title":"Model Memori","slug":"memory-model","category":"concepts","summary":"Bagaimana memori terstruktur — kategori, key, tag, prioritas, sumber, verifikasi.","audience":["human","llm"],"tags":["concept","memory","model","structure"],"difficulty":"intermediate","updated":"2026-06-27","word_count":699,"read_minutes":3,"lang":"id","translated":true,"requested_lang":"id","content_markdown":"\n# Model Memori\n\nModel memori Synapse dirancang untuk agen LLM — cukup terstruktur untuk recall\nyang andal, cukup fleksibel untuk domain apa pun.\n\n## Anatomi Memori\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## Field\n\n| Field | Tipe | Wajib | Deskripsi |\n|-------|------|----------|-------------|\n| `id` | string | otomatis | ID unik (mem_xxx) |\n| `category` | enum | ✅ | Salah satu dari 8 kategori |\n| `key` | string | ✅ | Identifier stabil (digunakan untuk pembaruan) |\n| `content` | string | ✅ | Konten memori (teks apa pun) |\n| `tags` | string[] | – | Untuk pencarian dan pemfilteran |\n| `priority` | enum | – | low, normal, high, critical (default: normal) |\n| `source` | enum | otomatis | user, agent (siapa yang menyimpan) |\n| `verified` | bool | otomatis | Apakah manusia telah memverifikasi ini? |\n| `confidence` | float | – | 0.0 hingga 1.0 (default: 1.0 untuk user, 0.7 untuk agent) |\n| `expires_at` | timestamp | – | Kapan harus melupakan memori ini |\n| `mind_id` | string | otomatis | Mind mana yang memilikinya |\n| `created_at` | timestamp | otomatis | Pertama disimpan |\n| `updated_at` | timestamp | otomatis | Terakhir dimodifikasi |\n\n## Kategori\n\nDelapan kategori mencakup kasus penggunaan agen LLM umum:\n\n| Kategori | Tujuan | Contoh Konten |\n|----------|---------|-----------------|\n| `identity` | Siapa pengguna | \"User is Michael Schäfer, software engineer in Berlin\" |\n| `preference` | Preferensi pengguna | \"Prefers concise technical responses\" |\n| `fact` | Fakta yang dapat diverifikasi | \"Office is in Berlin, timezone Europe/Berlin\" |\n| `project` | Status proyek | \"Synapse v1.5.0 deployed, working on v1.6.0 docs\" |\n| `skill` | Keahlian pengguna | \"Advanced Python, 10+ years\" |\n| `mistake` | Error masa lalu | \"Forgot to bump npm version — CI failed\" |\n| `context` | Konteks sesi | \"Currently reviewing PR #42\" |\n| `note` | Catatan lain-lain | \"Try Redis for caching next sprint\" |\n\n## Key: Identifier Stabil\n\nField `key` sangat penting — ini adalah cara Anda memperbarui memori tanpa\nmembuat duplikat.\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**Aturan key:**\n\n- Harus unik dalam (category, mind)\n- Gunakan `snake_case`\n- Awali dengan kategori untuk kejelasan: `preference_communication`, `mistake_npm_version`\n- Tetap stabil — jangan mengubah key setelah dibuat\n\n## Tag: Untuk Pencarian\n\nTag memungkinkan pemfilteran dan pencarian cepat:\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**Praktik terbaik tag:**\n\n- 2-5 tag per memori (jangan terlalu banyak tag)\n- Huruf kecil untuk konsistensi\n- Gunakan nama proyek, topik, teknologi\n- Tag tidak case-sensitive\n\n## Level Prioritas\n\n| Prioritas | Kapan Menggunakan | Perilaku Recall |\n|----------|-------------|-----------------|\n| `critical` | Identitas, hukum, ireversibel | Selalu di atas recall |\n| `high` | Proyek aktif, preferensi utama | Menonjol dalam recall |\n| `normal` | Sebagian besar memori (default) | Urutan recall standar |\n| `low` | Efemeral, bagus untuk diketahui | Mungkin diringkas |\n\n`/memory/recall` mengurutkan berdasarkan prioritas (critical pertama), lalu berdasarkan kebaruan.\n\n## Source: User vs Agent\n\nMemori ditandai dengan `source`:\n\n- `user` — disimpan oleh manusia (melalui JWT atau UI manusia)\n- `agent` — disimpan oleh agen LLM (melalui Mind Key)\n\nIni memengaruhi:\n\n- **Verifikasi:** memori `user` otomatis terverifikasi, memori `agent` tidak\n- **Confidence:** `user` default 1.0, `agent` 0.7\n- **Recall:** `/memory/recall` menandai memori yang belum terverifikasi dengan \"(unverified)\"\n\n> [!NOTE]\n> Perlakukan memori sumber `agent` dengan skeptisisme yang sesuai. Mereka mungkin\n> disimpulkan atau diasumsikan daripada dinyatakan langsung oleh pengguna.\n\n## Verifikasi\n\nFlag `verified` menunjukkan manusia telah mengonfirmasi memori:\n\n- Memori `user`: otomatis terverifikasi (`true`)\n- Memori `agent`: default belum terverifikasi (`false`)\n\nVerifikasi memori melalui:\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> Verifikasi memerlukan JWT (autentikasi manusia), bukan Mind Key (autentikasi\n> agen). Ini memastikan hanya manusia yang dapat menandai memori sebagai terverifikasi.\n\n## Confidence\n\nField `confidence` (0.0 hingga 1.0) menunjukkan seberapa andal memori tersebut:\n\n- 1.0 — dinyatakan langsung oleh pengguna\n- 0.7 — disimpulkan oleh agen\n- 0.5 — tidak pasti, perlu verifikasi\n- 0.0 — secara eksplisit diragukan\n\nTetapkan confidence saat menyimpan:\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## Kedaluwarsa\n\nTetapkan `expires_at` untuk memori yang sensitif terhadap waktu:\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\nMemori kedaluwarsa tidak dikembalikan oleh `/memory/recall` (tetapi masih ada di DB).\nGunakan `/memory/expiring?within=7d` untuk melihat memori yang akan segera kedaluwarsa.\n\n## Siklus Hidup Memori\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## Perilaku Recall\n\n`GET /memory/recall` mengembalikan ringkasan teks polos yang dioptimalkan untuk konteks LLM:\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- Diurutkan berdasarkan prioritas (critical → low), lalu berdasarkan kebaruan\n- Memori yang belum terverifikasi ditandai dengan `[unverified]`\n- Tag disertakan untuk konteks\n- Teks polos (tidak perlu parsing JSON)\n\n## Langkah Berikutnya\n\n- [Memory API](/docs/api/memory)\n- [Praktik Terbaik Memori](/docs/guides/memory-best-practices)\n- [Pencarian FTS5](/docs/concepts/fts5-search)\n","content_html":"

Model Memori

\n

Model memori Synapse dirancang untuk agen LLM — cukup terstruktur untuk recall\nyang andal, cukup fleksibel untuk domain apa pun.

\n

Anatomi Memori

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

Field

\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
FieldTipeWajibDeskripsi
idstringotomatisID unik (mem_xxx)
categoryenum✅Salah satu dari 8 kategori
keystring✅Identifier stabil (digunakan untuk pembaruan)
contentstring✅Konten memori (teks apa pun)
tagsstring[]–Untuk pencarian dan pemfilteran
priorityenum–low, normal, high, critical (default: normal)
sourceenumotomatisuser, agent (siapa yang menyimpan)
verifiedboolotomatisApakah manusia telah memverifikasi ini?
confidencefloat–0.0 hingga 1.0 (default: 1.0 untuk user, 0.7 untuk agent)
expires_attimestamp–Kapan harus melupakan memori ini
mind_idstringotomatisMind mana yang memilikinya
created_attimestampotomatisPertama disimpan
updated_attimestampotomatisTerakhir dimodifikasi
\n

Kategori

\n

Delapan kategori mencakup kasus penggunaan agen LLM umum:

\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
KategoriTujuanContoh Konten
identitySiapa pengguna"User is Michael Schäfer, software engineer in Berlin"
preferencePreferensi pengguna"Prefers concise technical responses"
factFakta yang dapat diverifikasi"Office is in Berlin, timezone Europe/Berlin"
projectStatus proyek"Synapse v1.5.0 deployed, working on v1.6.0 docs"
skillKeahlian pengguna"Advanced Python, 10+ years"
mistakeError masa lalu"Forgot to bump npm version — CI failed"
contextKonteks sesi"Currently reviewing PR #42"
noteCatatan lain-lain"Try Redis for caching next sprint"
\n

Key: Identifier Stabil

\n

Field key sangat penting — ini adalah cara Anda memperbarui memori tanpa\nmembuat duplikat.

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

Aturan key:

\n\n

Tag: Untuk Pencarian

\n

Tag memungkinkan pemfilteran dan pencarian cepat:

\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

Praktik terbaik tag:

\n\n

Level Prioritas

\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
PrioritasKapan MenggunakanPerilaku Recall
criticalIdentitas, hukum, ireversibelSelalu di atas recall
highProyek aktif, preferensi utamaMenonjol dalam recall
normalSebagian besar memori (default)Urutan recall standar
lowEfemeral, bagus untuk diketahuiMungkin diringkas
\n

/memory/recall mengurutkan berdasarkan prioritas (critical pertama), lalu berdasarkan kebaruan.

\n

Source: User vs Agent

\n

Memori ditandai dengan source:

\n\n

Ini memengaruhi:

\n\n
Perlakukan memori sumber `agent` dengan skeptisisme yang sesuai. Mereka mungkin\ndisimpulkan atau diasumsikan daripada dinyatakan langsung oleh pengguna.

Verifikasi

\n

Flag verified menunjukkan manusia telah mengonfirmasi memori:

\n\n

Verifikasi memori melalui:

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"
Verifikasi memerlukan JWT (autentikasi manusia), bukan Mind Key (autentikasi\nagen). Ini memastikan hanya manusia yang dapat menandai memori sebagai terverifikasi.

Confidence

\n

Field confidence (0.0 hingga 1.0) menunjukkan seberapa andal memori tersebut:

\n\n

Tetapkan confidence saat menyimpan:

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

Kedaluwarsa

\n

Tetapkan expires_at untuk memori yang sensitif terhadap waktu:

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

Memori kedaluwarsa tidak dikembalikan oleh /memory/recall (tetapi masih ada di DB).\nGunakan /memory/expiring?within=7d untuk melihat memori yang akan segera kedaluwarsa.

\n

Siklus Hidup Memori

\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        └──────────┘ └──────────┘ └──────────┘

Perilaku Recall

\n

GET /memory/recall mengembalikan ringkasan teks polos yang dioptimalkan untuk konteks LLM:

\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

Langkah Berikutnya

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