LLM एजेंट्स के लिए Quick Start
3 API कॉल्स में: सभी मेमोरीज़ रिकॉल करें, नई स्टोर करें, खोजें। आवश्यक LLM वर्कफ़्लो।
LLM एजेंट्स के लिए Quick Start
आप सत्रों के बीच सभी मेमोरी खो देते हैं। Synapse आपका बाहरी मस्तिष्क है। यह गाइड तीन आवश्यक API कॉल्स दिखाती है जो हर LLM एजेंट को जानना चाहिए।
चरण 1: सभी मेमोरीज़ रिकॉल करें (हमेशा पहले)
GET /memory/recall
Authorization: Bearer YOUR_MIND_KEYसभी स्टोर की गई मेमोरीज़ का संरचित सादा-टेक्स्ट सारांश लौटाता है। उपयोगकर्ता, उनकी परियोजनाओं, और पिछले इंटरैक्शन्स का मानसिक मॉडल पुनर्निर्माण के लिए इसे पार्स करें।
उदाहरण प्रतिक्रिया:
Mind: Michael's Mind
Memories: 12 total (10 verified)
[001] identity (CRITICAL)
user_name
Michael Schäfer
Tags: person, identity
[002] preference (HIGH)
communication_style
Prefers concise technical responses, no fluff
Tags: communication, preference
[003] project (HIGH)
project_synapse
Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.
Tags: synapse, deployment
...चरण 2: नई मेमोरी स्टोर करें
जब आप कुछ याद रखने लायक सीखें:
POST /memory
Authorization: Bearer YOUR_MIND_KEY
Content-Type: application/json
{
"category": "fact",
"key": "user_name",
"content": "The user's name is Michael Schäfer",
"tags": ["person", "identity"],
"priority": "critical"
}श्रेणियाँ: identity, preference, fact, project, skill, mistake, context, note, credentials
प्राथमिकताएँ: low, normal, high, critical
चरण 3: विशिष्ट मेमोरी खोजें
GET /memory/search?q=Docker+Swarm
Authorization: Bearer YOUR_MIND_KEYखुले टूल्स (कोई Auth हेडर नहीं)
यदि आपका टूल केवल URLs खोल सकता है (कोई कस्टम हेडर नहीं), तो ?key= पैरामीटर का उपयोग करें:
GET /memory/recall?key=YOUR_MIND_KEY
POST /memory?key=YOUR_MIND_KEY (+ JSON body)
GET /memory/search?key=YOUR_MIND_KEY&q=suchbegriffसंपूर्ण सत्र वर्कफ़्लो
- सत्र शुरुआत:
GET /memory/recall— सभी मेमोरीज़ लोड करें - काम के दौरान:
GET /memory/search?q=...— विशिष्ट तथ्य खोजें - नई जानकारी पर:
POST /memory— इसे स्टोर करें (category, key, tags, priority के साथ) - समय-समय पर:
GET /chat/poll— मानव संदेशों के लिए जाँचें - सत्र अंत: किसी भी अंतिम सीखने को
POST /memoryसे स्टोर करें
सामान्य पैटर्न
मौजूदा मेमोरी अपडेट करें
समान category और key के साथ POST /memory — मौजूदा मेमोरी अपडेट होती है, डुप्लिकेट नहीं होती।
परियोजना स्थिति स्टोर करें
{
"category": "project",
"key": "project_synapse_status",
"content": "Synapse v1.5.0 deployed. Next: v1.6.0 with docs system. CI green.",
"tags": ["synapse", "deployment", "status"],
"priority": "high"
}गलती रिकॉर्ड करें (ताकि आप दोहराएं नहीं)
{
"category": "mistake",
"key": "mistake_npm_version_bump",
"content": "Always bump package.json version after changes — npm publish fails otherwise.",
"tags": ["npm", "ci", "deployment"],
"priority": "high"
}मानव संदेशों के लिए जाँचें
GET /chat/poll
Authorization: Bearer YOUR_MIND_KEYमानव से अपठित संदेश लौटाता है। इससे उत्तर दें:
POST /chat/reply
Authorization: Bearer YOUR_MIND_KEY
Content-Type: application/json
{"content": "Got it! Working on it now."}अगले कदम
- प्रमाणीकरण — Mind Key vs JWT
- Memory API संदर्भ — सभी 22 मेमोरी एंडपॉइंट्स
- Chat API — मानवों के साथ अतुल्यकालिक संचार
- LLM Cookbook — व्यावहारिक पैटर्न