{"title":"मेमोरी मॉडल","slug":"memory-model","category":"concepts","summary":"मेमोरीज़ कैसे संरचित हैं — श्रेणियाँ, कुंजी, टैग्स, प्राथमिकताएँ, स्रोत, सत्यापन।","audience":["human","llm"],"tags":["concept","memory","model","structure"],"difficulty":"intermediate","updated":"2026-06-27","word_count":784,"read_minutes":4,"lang":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# मेमोरी मॉडल\n\nSynapse का मेमोरी मॉडल LLM एजेंट्स के लिए डिज़ाइन किया गया है — विश्वसनीय रिकॉल के लिए पर्याप्त संरचित, किसी भी डोमेन के लिए पर्याप्त लचीला।\n\n## मेमोरी शरीर रचना\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## फ़ील्ड्स\n\n| फ़ील्ड | प्रकार | आवश्यक | विवरण |\n|-------|------|----------|-------------|\n| `id` | string | auto | अद्वितीय ID (mem_xxx) |\n| `category` | enum | ✅ | 8 श्रेणियों में से एक |\n| `key` | string | ✅ | स्थिर पहचानकर्ता (अपडेट के लिए उपयोग) |\n| `content` | string | ✅ | मेमोरी सामग्री (कोई भी टेक्स्ट) |\n| `tags` | string[] | – | खोज और फ़िल्टरिंग के लिए |\n| `priority` | enum | – | low, normal, high, critical (डिफ़ॉल्ट: normal) |\n| `source` | enum | auto | user, agent (किसने स्टोर किया) |\n| `verified` | bool | auto | क्या किसी मानव ने इसे सत्यापित किया? |\n| `confidence` | float | – | 0.0 से 1.0 (डिफ़ॉल्ट: user के लिए 1.0, agent के लिए 0.7) |\n| `expires_at` | timestamp | – | यह मेमोरी कब भूलनी है |\n| `mind_id` | string | auto | कौन सा mind इसका मालिक है |\n| `created_at` | timestamp | auto | पहले स्टोर किया गया |\n| `updated_at` | timestamp | auto | अंतिम बार संशोधित |\n\n## श्रेणियाँ\n\nआठ श्रेणियाँ सामान्य LLM एजेंट उपयोग के मामलों को कवर करती हैं:\n\n| श्रेणी | उद्देश्य | उदाहरण सामग्री |\n|----------|---------|-----------------|\n| `identity` | उपयोगकर्ता कौन है | \"User is Michael Schäfer, software engineer in Berlin\" |\n| `preference` | उपयोगकर्ता प्राथमिकताएँ | \"Prefers concise technical responses\" |\n| `fact` | सत्यापित योग्य तथ्य | \"Office is in Berlin, timezone Europe/Berlin\" |\n| `project` | परियोजना स्थिति | \"Synapse v1.5.0 deployed, working on v1.6.0 docs\" |\n| `skill` | उपयोगकर्ता के कौशल | \"Advanced Python, 10+ years\" |\n| `mistake` | पिछली त्रुटियाँ | \"Forgot to bump npm version — CI failed\" |\n| `context` | सत्र संदर्भ | \"Currently reviewing PR #42\" |\n| `note` | विविध नोट्स | \"Try Redis for caching next sprint\" |\n\n## कुंजी: स्थिर पहचानकर्ता\n\n`key` फ़ील्ड महत्वपूर्ण है — यह डुप्लिकेट बनाए बिना मेमोरीज़ अपडेट करने का तरीका है।\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**कुंजी नियम:**\n\n- (category, mind) के भीतर अद्वितीय होनी चाहिए\n- `snake_case` का उपयोग करें\n- स्पष्टता के लिए श्रेणी के साथ उपसर्ग: `preference_communication`, `mistake_npm_version`\n- स्थिर रखें — निर्माण के बाद कुंजी न बदलें\n\n## टैग्स: खोज के लिए\n\nटैग्स तेज़ फ़िल्टरिंग और खोज सक्षम बनाते हैं:\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**टैग सर्वोत्तम प्रथाएँ:**\n\n- प्रति मेमोरी 2-5 टैग्स (अधिक टैग न करें)\n- निरंतरता के लिए लोअरकेस\n- परियोजना नाम, विषय, तकनीकों का उपयोग करें\n- टैग्स केस-असंवेदनशील हैं\n\n## प्राथमिकता स्तर\n\n| प्राथमिकता | कब उपयोग करें | रिकॉल व्यवहार |\n|----------|-------------|-----------------|\n| `critical` | पहचान, कानूनी, अपरिवर्तनीय | हमेशा रिकॉल के शीर्ष पर |\n| `high` | सक्रिय परियोजनाएँ, मुख्य प्राथमिकताएँ | रिकॉल में प्रमुख |\n| `normal` | अधिकांश मेमोरीज़ (डिफ़ॉल्ट) | मानक रिकॉल क्रम |\n| `low` | क्षणिक, जानना-अच्छा | सारांशित हो सकता है |\n\n`/memory/recall` प्राथमिकता द्वारा (critical पहले), फिर नवीनता द्वारा क्रमबद्ध करता है।\n\n## स्रोत: User बनाम Agent\n\nमेमोरीज़ को `source` के साथ टैग किया जाता है:\n\n- `user` — किसी मानव द्वारा स्टोर किया गया (JWT या human UI के माध्यम से)\n- `agent` — किसी LLM एजेंट द्वारा स्टोर किया गया (Mind Key के माध्यम से)\n\nयह प्रभावित करता है:\n\n- **सत्यापन**: `user` मेमोरीज़ ऑटो-सत्यापित हैं, `agent` मेमोरीज़ नहीं\n- **विश्वास्यता**: `user` का डिफ़ॉल्ट 1.0, `agent` का 0.7\n- **रिकॉल**: `/memory/recall` असत्यापित मेमोरीज़ को \"(unverified)\" से चिह्नित करता है\n\n> [!NOTE]\n> `agent`-स्रोत मेमोरीज़ के प्रति उचित संदेह रखें। ये सीधे उपयोगकर्ता द्वारा बताई गई नहीं, बल्कि अनुमानित या मानी गई हो सकती हैं।\n\n## सत्यापन\n\n`verified` फ़्लैग दर्शाता है कि किसी मानव ने मेमोरी की पुष्टि की है:\n\n- `user` मेमोरीज़: ऑटो-सत्यापित (`true`)\n- `agent` मेमोरीज़: डिफ़ॉल्ट असत्यापित (`false`)\n\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> सत्यापन के लिए Mind Key (एजेंट प्रमाणीकरण) नहीं, JWT (मानव प्रमाणीकरण) आवश्यक है। यह सुनिश्चित करता है कि केवल मानव ही मेमोरीज़ को सत्यापित के रूप में चिह्नित कर सकें।\n\n## विश्वास्यता\n\n`confidence` फ़ील्ड (0.0 से 1.0) दर्शाता है कि मेमोरी कितनी विश्वसनीय है:\n\n- 1.0 — उपयोगकर्ता द्वारा सीधे बताई गई\n- 0.7 — एजेंट द्वारा अनुमानित\n- 0.5 — अनिश्चित, सत्यापन चाहिए\n- 0.0 — स्पष्ट रूप से संदिग्ध\n\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## समाप्ति\n\nसमय-संवेदनशील मेमोरीज़ के लिए `expires_at` सेट करें:\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\nसमाप्त मेमोरीज़ `/memory/recall` द्वारा लौटाई नहीं जातीं (लेकिन DB में अभी भी मौजूद हैं)।\nजल्द ही समाप्त होने वाली मेमोरीज़ देखने के लिए `/memory/expiring?within=7d` का उपयोग करें।\n\n## मेमोरी जीवनचक्र\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## रिकॉल व्यवहार\n\n`GET /memory/recall` 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- प्राथमिकता द्वारा क्रमबद्ध (critical → low), फिर नवीनता द्वारा\n- असत्यापित मेमोरीज़ `[unverified]` से चिह्नित\n- संदर्भ के लिए टैग्स शामिल\n- सादा टेक्स्ट (कोई JSON पार्सिंग आवश्यक नहीं)\n\n## अगले कदम\n\n- [Memory API](/docs/api/memory)\n- [मेमोरी सर्वोत्तम प्रथाएँ](/docs/guides/memory-best-practices)\n- [FTS5 Search](/docs/concepts/fts5-search)\n","content_html":"

मेमोरी मॉडल

\n

Synapse का मेमोरी मॉडल LLM एजेंट्स के लिए डिज़ाइन किया गया है — विश्वसनीय रिकॉल के लिए पर्याप्त संरचित, किसी भी डोमेन के लिए पर्याप्त लचीला।

\n

मेमोरी शरीर रचना

\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\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
फ़ील्डप्रकारआवश्यकविवरण
idstringautoअद्वितीय ID (mem_xxx)
categoryenum✅8 श्रेणियों में से एक
keystring✅स्थिर पहचानकर्ता (अपडेट के लिए उपयोग)
contentstring✅मेमोरी सामग्री (कोई भी टेक्स्ट)
tagsstring[]–खोज और फ़िल्टरिंग के लिए
priorityenum–low, normal, high, critical (डिफ़ॉल्ट: normal)
sourceenumautouser, agent (किसने स्टोर किया)
verifiedboolautoक्या किसी मानव ने इसे सत्यापित किया?
confidencefloat–0.0 से 1.0 (डिफ़ॉल्ट: user के लिए 1.0, agent के लिए 0.7)
expires_attimestamp–यह मेमोरी कब भूलनी है
mind_idstringautoकौन सा mind इसका मालिक है
created_attimestampautoपहले स्टोर किया गया
updated_attimestampautoअंतिम बार संशोधित
\n

श्रेणियाँ

\n

आठ श्रेणियाँ सामान्य LLM एजेंट उपयोग के मामलों को कवर करती हैं:

\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
श्रेणीउद्देश्यउदाहरण सामग्री
identityउपयोगकर्ता कौन है"User is Michael Schäfer, software engineer in Berlin"
preferenceउपयोगकर्ता प्राथमिकताएँ"Prefers concise technical responses"
factसत्यापित योग्य तथ्य"Office is in Berlin, timezone Europe/Berlin"
projectपरियोजना स्थिति"Synapse v1.5.0 deployed, working on v1.6.0 docs"
skillउपयोगकर्ता के कौशल"Advanced Python, 10+ years"
mistakeपिछली त्रुटियाँ"Forgot to bump npm version — CI failed"
contextसत्र संदर्भ"Currently reviewing PR #42"
noteविविध नोट्स"Try Redis for caching next sprint"
\n

कुंजी: स्थिर पहचानकर्ता

\n

key फ़ील्ड महत्वपूर्ण है — यह डुप्लिकेट बनाए बिना मेमोरीज़ अपडेट करने का तरीका है।

\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

टैग्स तेज़ फ़िल्टरिंग और खोज सक्षम बनाते हैं:

\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\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
प्राथमिकताकब उपयोग करेंरिकॉल व्यवहार
criticalपहचान, कानूनी, अपरिवर्तनीयहमेशा रिकॉल के शीर्ष पर
highसक्रिय परियोजनाएँ, मुख्य प्राथमिकताएँरिकॉल में प्रमुख
normalअधिकांश मेमोरीज़ (डिफ़ॉल्ट)मानक रिकॉल क्रम
lowक्षणिक, जानना-अच्छासारांशित हो सकता है
\n

/memory/recall प्राथमिकता द्वारा (critical पहले), फिर नवीनता द्वारा क्रमबद्ध करता है।

\n

स्रोत: User बनाम Agent

\n

मेमोरीज़ को source के साथ टैग किया जाता है:

\n\n

यह प्रभावित करता है:

\n\n
`agent`-स्रोत मेमोरीज़ के प्रति उचित संदेह रखें। ये सीधे उपयोगकर्ता द्वारा बताई गई नहीं, बल्कि अनुमानित या मानी गई हो सकती हैं।

सत्यापन

\n

verified फ़्लैग दर्शाता है कि किसी मानव ने मेमोरी की पुष्टि की है:

\n\n

मेमोरीज़ इसके माध्यम से सत्यापित करें:

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"
सत्यापन के लिए Mind Key (एजेंट प्रमाणीकरण) नहीं, JWT (मानव प्रमाणीकरण) आवश्यक है। यह सुनिश्चित करता है कि केवल मानव ही मेमोरीज़ को सत्यापित के रूप में चिह्नित कर सकें।

विश्वास्यता

\n

confidence फ़ील्ड (0.0 से 1.0) दर्शाता है कि मेमोरी कितनी विश्वसनीय है:

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

समाप्ति

\n

समय-संवेदनशील मेमोरीज़ के लिए expires_at सेट करें:

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

समाप्त मेमोरीज़ /memory/recall द्वारा लौटाई नहीं जातीं (लेकिन DB में अभी भी मौजूद हैं)।\nजल्द ही समाप्त होने वाली मेमोरीज़ देखने के लिए /memory/expiring?within=7d का उपयोग करें।

\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

GET /memory/recall 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

अगले कदम

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