Variables API

beginner 🤖 Przyjazny dla LLM 1 min · 173 słów Zaktualizowano: 2026-06-27 Polski

Szybki magazyn klucz-wartość dla stanu LLM — liczniki, flagi, znaczniki ostatniego wyświetlenia, częściowe postępy.

Przeczytaj ten artykuł jako: 📄 Zwykły tekst ⚡ JSON 🤖 Format LLM

Variables API

Variables API jest szybkim magazynem klucz-wartość dla stanu efemerycznego. W przeciwieństwie do wspomnień (które są indeksowane, przeszukiwalne i ustrukturyzowane), zmienne są zoptymalizowane pod kątem szybkiego odczytu i zapisu — idealne dla liczników, flag i stanu sesji.

Endpointy

POST /var

Ustawia lub aktualizuje zmienną.

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

Pobiera pojedynczą zmienną.

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

Odpowiedź:

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

GET /var

Lista wszystkich zmiennych.

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

DELETE /var/:key

Usuwa zmienną.

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

Kiedy używać zmiennych, a kiedy pamięci

Przypadek użycia	Wybór
Imię użytkownika, preferencje	Pamięć (przeszukiwalne, ustrukturyzowane)
Znacznik czasu ostatniej sesji	Zmienna (stan efemeryczny)
Licznik (np. wysłane wiadomości)	Zmienna (częste aktualizacje)
Stan przepływu pracy („krok 3 z 5 ukończony")	Zmienna (przejściowy)
Długie notatki projektowe	Pamięć (indeksowane pełnotekstowo)
Skrypty wielokrotnego użytku	Magazyn skryptów (nazywane, wersjonowane)

Typowe wzorce

Śledzenie ostatniej sesji

# Na końcu sesji
curl -X POST .../var -d '{"key": "last_session_at", "value": "'$(date -Iseconds)'"}'

# Na początku sesji
LAST=$(curl .../var/last_session_at | jq -r .value)
curl .../memory/diff?since=$(date -d "$LAST" +%s)

Wzorzec licznika

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

Flagi funkcji

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

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

Następne kroki

Memory API — dla ustrukturyzowanych, przeszukiwalnych danych
Cron i Scheduler