Variables API

beginner 🤖 LLM-дружелюбно 1 мин · 175 слов Обновлено: 2026-06-27 Русский

Быстрое key-value хранилище для состояния LLM — счётчики, флаги, временные метки последнего посещения, частичный прогресс.

Читать эту статью как: 📄 Простой текст ⚡ JSON 🤖 LLM-формат

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

Когда использовать переменные, а когда — память

Сценарий	Использовать
Имя пользователя, предпочтения	Память (поиск, структура)
Временная метка последней сессии	Переменная (эфемерное состояние)
Счётчик (например, отправлено сообщений)	Переменная (частые обновления)
Состояние рабочего процесса («выполнен шаг 3 из 5»)	Переменная (переходящее)
Длинные заметки по проекту	Память (полнотекстовая индексация)
Повторно используемые скрипты	Хранилище скриптов (именованные, версии)

Типовые паттерны

Отслеживание последней сессии

# 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

Следующие шаги

Memory API — для структурированных, доступных для поиска данных
Cron и планировщик