Skip to main content

Variables API

LLM स्थिति के लिए तीव्र key-value स्टोर — काउंटर, फ़्लैग्स, अंतिम-देखा टाइमस्टैम्प्स, आंशिक प्रगति।


Variables API

Variables API क्षणिक स्थिति के लिए एक तीव्र key-value स्टोर है। मेमोरीज़ (जो अनुक्रमित, खोज योग्य, और संरचित हैं) के विपरीत, वेरिएबल्स त्वरित पढ़ने/लिखने के एक्सेस के लिए अनुकूलित हैं — काउंटर, फ़्लैग्स, और सत्र स्थिति के लिए आदर्श।

एंडपॉइंट्स

POST /var

वेरिएबल सेट करें या अपडेट करें।

curl -X POST https://synapse.schaefer.zone/var \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "last_session_at", "value": "2026-06-27T14:00:00Z"}'

GET /var/:key

एकल वेरिएबल प्राप्त करें।

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/var/last_session_at

प्रतिक्रिया:

{ "key": "last_session_at", "value": "2026-06-27T14:00:00Z", "updated_at": "..." }

GET /var

सभी वेरिएबल्स की सूची बनाएँ।

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/var

DELETE /var/:key

वेरिएबल हटाएँ।

curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/var/last_session_at

वेरिएबल्स कब उपयोग करें बनाम मेमोरी

उपयोग का मामला उपयोग करें
उपयोगकर्ता नाम, प्राथमिकताएँ Memory (खोज योग्य, संरचित)
अंतिम सत्र टाइमस्टैम्प Variable (क्षणिक स्थिति)
काउंटर (जैसे भेजे गए संदेश) Variable (अक्सर अपडेट)
वर्कफ़्लो स्थिति ("5 में से 3 चरण पूर्ण") Variable (क्षणिक)
लंबी-प्रपत्र परियोजना नोट्स Memory (फुल-टेक्स्ट अनुक्रमित)
पुनः प्रयोज्य स्क्रिप्ट्स Script store (नामित, संस्करणित)

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

अंतिम सत्र ट्रैक करें

# At session end
curl -X POST .../var -d '{"key": "last_session_at", "value": "'$(date -Iseconds)'"}'

# At session start
LAST=$(curl .../var/last_session_at | jq -r .value)
curl .../memory/diff?since=$(date -d "$LAST" +%s)

काउंटर पैटर्न

# Increment
N=$(curl .../var/api_calls | jq -r .value)
curl -X POST .../var -d "{\"key\": \"api_calls\", \"value\": $((N+1))}"

फ़ीचर फ़्लैग्स

curl -X POST .../var -d '{"key": "feature_x_enabled", "value": "true"}'

# Check
ENABLED=$(curl .../var/feature_x_enabled | jq -r .value)
if [ "$ENABLED" = "true" ]; then ... fi

अगले कदम