Variables API

beginner 🤖 LLM uyumlu 1 dk · 174 kelime Güncellendi: 2026-06-27 Türkçe

LLM durumu için hızlı anahtar-değer deposu — sayaçlar, bayraklar, son görülme zaman damgaları, kısmi ilerleme.

Bu makaleyi şu şekilde oku: 📄 Düz metin ⚡ JSON 🤖 LLM biçimi

Variables API

Variables API, geçici durum için hızlı bir anahtar-değer deposudur. Belleklerden (indekslenen, aranabilir ve yapılandırılmış) farklı olarak değişkenler hızlı okuma/yazma erişimi için optimize edilmiştir — sayaçlar, bayraklar ve oturum durumu için mükemmeldir.

Uç Noktalar

POST /var

Bir değişken ayarla veya güncelle.

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

Tek bir değişkeni al.

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

Yanıt:

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

GET /var

Tüm değişkenleri listele.

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

DELETE /var/:key

Bir değişkeni sil.

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

Ne Zaman Değişken, Ne Zaman Bellek Kullanılır

Kullanım Senaryosu	Kullan
Kullanıcı adı, tercihler	Bellek (aranabilir, yapılandırılmış)
Son oturum zaman damgası	Değişken (geçici durum)
Sayaç (örn. gönderilen mesajlar)	Değişken (sık güncellemeler)
İş akışı durumu ("5 adımın 3'ü tamamlandı")	Değişken (geçici)
Uzun form proje notları	Bellek (tam metin indeksli)
Yeniden kullanılabilir betikler	Betik deposu (adlandırılmış, sürümlü)

Yaygın Desenler

Son oturumu izle

# 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)

Sayaç deseni

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

Özellik bayrakları

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

Sonraki Adımlar

Memory API — yapılandırılmış, aranabilir veriler için
Cron & Zamanlayıcı