{"title":"LLM एजेंट्स के लिए Quick Start","slug":"quick-start-llm","category":"getting-started","summary":"3 API कॉल्स में: सभी मेमोरीज़ रिकॉल करें, नई स्टोर करें, खोजें। आवश्यक LLM वर्कफ़्लो।","audience":["llm"],"tags":["llm","agent","quickstart","memory"],"difficulty":"beginner","updated":"2026-06-27","word_count":389,"read_minutes":2,"llm_context":"Base URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query)\nALWAYS call /memory/recall at the start of every session.\nWichtigste Befehle: GET /memory/recall, POST /memory, GET /memory/search?q=...\nCategories: identity, preference, fact, project, skill, mistake, context, note, credentials\nPriorities: low, normal, high, critical\nFTS5 search: multiple words = AND, \"phrases\" in quotes, prefix* for prefix search\n","lang":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# LLM एजेंट्स के लिए Quick Start\n\nआप सत्रों के बीच सभी मेमोरी खो देते हैं। Synapse आपका बाहरी मस्तिष्क है। यह गाइड तीन आवश्यक API कॉल्स दिखाती है जो हर LLM एजेंट को जानना चाहिए।\n\n> [!CRITICAL]\n> हर सत्र की शुरुआत में `GET /memory/recall` कॉल करें।\n> इस कॉल के बिना, आपको यह याद नहीं कि उपयोगकर्ता कौन है, आपने क्या वादा किया, या पिछली बार आप किस पर काम कर रहे थे।\n\n## चरण 1: सभी मेमोरीज़ रिकॉल करें (हमेशा पहले)\n\n```\nGET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nसभी स्टोर की गई मेमोरीज़ का संरचित सादा-टेक्स्ट सारांश लौटाता है। उपयोगकर्ता, उनकी परियोजनाओं, और पिछले इंटरैक्शन्स का मानसिक मॉडल पुनर्निर्माण के लिए इसे पार्स करें।\n\nउदाहरण प्रतिक्रिया:\n\n```\nMind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n user_name\n Michael Schäfer\n Tags: person, identity\n\n[002] preference (HIGH)\n communication_style\n Prefers concise technical responses, no fluff\n Tags: communication, preference\n\n[003] project (HIGH)\n project_synapse\n Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.\n Tags: synapse, deployment\n ...\n```\n\n## चरण 2: नई मेमोरी स्टोर करें\n\nजब आप कुछ याद रखने लायक सीखें:\n\n```\nPOST /memory\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\n \"category\": \"fact\",\n \"key\": \"user_name\",\n \"content\": \"The user's name is Michael Schäfer\",\n \"tags\": [\"person\", \"identity\"],\n \"priority\": \"critical\"\n}\n```\n\n**श्रेणियाँ:** `identity`, `preference`, `fact`, `project`, `skill`, `mistake`, `context`, `note`, `credentials`\n\n**प्राथमिकताएँ:** `low`, `normal`, `high`, `critical`\n\n> [!TIP]\n> हमेशा `key` फ़ील्ड शामिल करें — मेमोरी के लिए एक छोटा पहचानकर्ता। यह आपको समान कुंजी के साथ फिर से POST करके उसी मेमोरी को बाद में अपडेट करने देता है।\n\n## चरण 3: विशिष्ट मेमोरी खोजें\n\n```\nGET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n> [!TIP]\n> FTS5 सिंटैक्स: कई शब्द = AND खोज। उद्धरण में वाक्यांश: `\"docker swarm\"`।\n> उपसर्ग खोज: `docker*`। बूलियन: `docker OR kubernetes`।\n\n## खुले टूल्स (कोई Auth हेडर नहीं)\n\nयदि आपका टूल केवल URLs खोल सकता है (कोई कस्टम हेडर नहीं), तो `?key=` पैरामीटर का उपयोग करें:\n\n```\nGET /memory/recall?key=YOUR_MIND_KEY\nPOST /memory?key=YOUR_MIND_KEY (+ JSON body)\nGET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff\n```\n\n> [!WARNING]\n> `?key=` 60 requests/minute तक सीमित है। Bearer हेडर की कोई रेट लिमिट नहीं है।\n> जब संभव हो Bearer हेडर का उपयोग करें।\n\n## संपूर्ण सत्र वर्कफ़्लो\n\n1. **सत्र शुरुआत:** `GET /memory/recall` — सभी मेमोरीज़ लोड करें\n2. **काम के दौरान:** `GET /memory/search?q=...` — विशिष्ट तथ्य खोजें\n3. **नई जानकारी पर:** `POST /memory` — इसे स्टोर करें (category, key, tags, priority के साथ)\n4. **समय-समय पर:** `GET /chat/poll` — मानव संदेशों के लिए जाँचें\n5. **सत्र अंत:** किसी भी अंतिम सीखने को `POST /memory` से स्टोर करें\n\n## सामान्य पैटर्न\n\n### मौजूदा मेमोरी अपडेट करें\n\nसमान `category` और `key` के साथ POST `/memory` — मौजूदा मेमोरी अपडेट होती है, डुप्लिकेट नहीं होती।\n\n### परियोजना स्थिति स्टोर करें\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. CI green.\",\n \"tags\": [\"synapse\", \"deployment\", \"status\"],\n \"priority\": \"high\"\n}\n```\n\n### गलती रिकॉर्ड करें (ताकि आप दोहराएं नहीं)\n\n```json\n{\n \"category\": \"mistake\",\n \"key\": \"mistake_npm_version_bump\",\n \"content\": \"Always bump package.json version after changes — npm publish fails otherwise.\",\n \"tags\": [\"npm\", \"ci\", \"deployment\"],\n \"priority\": \"high\"\n}\n```\n\n### मानव संदेशों के लिए जाँचें\n\n```\nGET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nमानव से अपठित संदेश लौटाता है। इससे उत्तर दें:\n\n```\nPOST /chat/reply\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\"content\": \"Got it! Working on it now.\"}\n```\n\n## अगले कदम\n\n- [प्रमाणीकरण](/docs/getting-started/authentication) — Mind Key vs JWT\n- [Memory API संदर्भ](/docs/api/memory) — सभी 22 मेमोरी एंडपॉइंट्स\n- [Chat API](/docs/api/chat) — मानवों के साथ अतुल्यकालिक संचार\n- [LLM Cookbook](/docs/llm-cookbook/session-start-pattern) — व्यावहारिक पैटर्न\n","content_html":"

LLM एजेंट्स के लिए Quick Start

\n

आप सत्रों के बीच सभी मेमोरी खो देते हैं। Synapse आपका बाहरी मस्तिष्क है। यह गाइड तीन आवश्यक API कॉल्स दिखाती है जो हर LLM एजेंट को जानना चाहिए।

\n

हर सत्र की शुरुआत में `GET /memory/recall` कॉल करें।\nइस कॉल के बिना, आपको यह याद नहीं कि उपयोगकर्ता कौन है, आपने क्या वादा किया, या पिछली बार आप किस पर काम कर रहे थे।

चरण 1: सभी मेमोरीज़ रिकॉल करें (हमेशा पहले)

\n

GET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY

सभी स्टोर की गई मेमोरीज़ का संरचित सादा-टेक्स्ट सारांश लौटाता है। उपयोगकर्ता, उनकी परियोजनाओं, और पिछले इंटरैक्शन्स का मानसिक मॉडल पुनर्निर्माण के लिए इसे पार्स करें।

\n

उदाहरण प्रतिक्रिया:

\n

Mind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  Michael Schäfer\n  Tags: person, identity\n\n[002] preference (HIGH)\n  communication_style\n  Prefers concise technical responses, no fluff\n  Tags: communication, preference\n\n[003] project (HIGH)\n  project_synapse\n  Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.\n  Tags: synapse, deployment\n  ...

चरण 2: नई मेमोरी स्टोर करें

\n

जब आप कुछ याद रखने लायक सीखें:

\n

POST /memory\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\n  "category": "fact",\n  "key": "user_name",\n  "content": "The user's name is Michael Schäfer",\n  "tags": ["person", "identity"],\n  "priority": "critical"\n}

श्रेणियाँ: identity, preference, fact, project, skill, mistake, context, note, credentials

\n

प्राथमिकताएँ: low, normal, high, critical

\n

हमेशा `key` फ़ील्ड शामिल करें — मेमोरी के लिए एक छोटा पहचानकर्ता। यह आपको समान कुंजी के साथ फिर से POST करके उसी मेमोरी को बाद में अपडेट करने देता है।

चरण 3: विशिष्ट मेमोरी खोजें

\n

GET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY

FTS5 सिंटैक्स: कई शब्द = AND खोज। उद्धरण में वाक्यांश: `\"docker swarm\"`।\nउपसर्ग खोज: `docker*`। बूलियन: `docker OR kubernetes`।

खुले टूल्स (कोई Auth हेडर नहीं)

\n

यदि आपका टूल केवल URLs खोल सकता है (कोई कस्टम हेडर नहीं), तो ?key= पैरामीटर का उपयोग करें:

\n

GET /memory/recall?key=YOUR_MIND_KEY\nPOST /memory?key=YOUR_MIND_KEY (+ JSON body)\nGET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff

`?key=` 60 requests/minute तक सीमित है। Bearer हेडर की कोई रेट लिमिट नहीं है।\nजब संभव हो Bearer हेडर का उपयोग करें।

संपूर्ण सत्र वर्कफ़्लो

\n

सत्र शुरुआत: GET /memory/recall — सभी मेमोरीज़ लोड करें
काम के दौरान: GET /memory/search?q=... — विशिष्ट तथ्य खोजें
नई जानकारी पर: POST /memory — इसे स्टोर करें (category, key, tags, priority के साथ)
समय-समय पर: GET /chat/poll — मानव संदेशों के लिए जाँचें
सत्र अंत: किसी भी अंतिम सीखने को POST /memory से स्टोर करें

\n

सामान्य पैटर्न

\n

मौजूदा मेमोरी अपडेट करें

\n

समान category और key के साथ POST /memory — मौजूदा मेमोरी अपडेट होती है, डुप्लिकेट नहीं होती।

\n

परियोजना स्थिति स्टोर करें

\n

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

गलती रिकॉर्ड करें (ताकि आप दोहराएं नहीं)

\n

{\n  "category": "mistake",\n  "key": "mistake_npm_version_bump",\n  "content": "Always bump package.json version after changes — npm publish fails otherwise.",\n  "tags": ["npm", "ci", "deployment"],\n  "priority": "high"\n}

मानव संदेशों के लिए जाँचें

\n

GET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY

मानव से अपठित संदेश लौटाता है। इससे उत्तर दें:

\n

POST /chat/reply\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{"content": "Got it! Working on it now."}

अगले कदम

\n

प्रमाणीकरण — Mind Key vs JWT
Memory API संदर्भ — सभी 22 मेमोरी एंडपॉइंट्स
Chat API — मानवों के साथ अतुल्यकालिक संचार
LLM Cookbook — व्यावहारिक पैटर्न

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