# Variables API
SUMMARY: Cửa hàng key-value nhanh cho trạng thái LLM — bộ đếm, cờ, timestamp lần cuối xem, tiến độ từng phần.

KEY CONTEXT:
Auth: Mind Key
Set: POST /var { key, value }
Get: GET /var/:key
List: GET /var
Delete: DELETE /var/:key
Use case: store last-seen timestamps, counters, flags, partial workflow state
Faster than memory (PostgreSQL direct, no FTS5 indexing)
Not for: structured facts (use /memory), long content (use /script)

Variables API
Variables API là một cửa hàng key-value nhanh cho trạng thái tạm thời. Khác với
bộ nhớ (được đánh chỉ mục, có thể tìm kiếm và có cấu trúc), biến được tối ưu
cho truy cập đọc/ghi nhanh — hoàn hảo cho bộ đếm, cờ và trạng thái phiên.
Các endpoint
POST /var
Đặt hoặc cập nhật một biến.
[CODE BLOCK]
GET /var/:key
Lấy một biến đơn lẻ.
[CODE BLOCK]
Phản hồi:
[CODE BLOCK]
GET /var
Liệt kê tất cả biến.
[CODE BLOCK]
DELETE /var/:key
Xóa một biến.
[CODE BLOCK]
Khi nào dùng Biến so với Bộ nhớ
| Trường hợp | Sử dụng |
|----------|-----|
| Tên người dùng, sở thích | Bộ nhớ (có thể tìm kiếm, có cấu trúc) |
| Timestamp phiên cuối | Biến (trạng thái tạm thời) |
| Bộ đếm (ví dụ tin nhắn đã gửi) | Biến (cập nhật thường xuyên) |
| Trạng thái quy trình ("đã xong bước 3/5") | Biến (tạm thời) |
| Ghi chú dự án dạng dài | Bộ nhớ (đánh chỉ mục toàn văn) |
| Script tái sử dụng | Cửa hàng script (đặt tên, đánh phiên bản) |
Mẫu phổ biến
Theo dõi phiên cuối
[CODE BLOCK]
Mẫu bộ đếm
[CODE BLOCK]
Cờ tính năng
[CODE BLOCK]
Bước tiếp theo
- Memory API — cho dữ liệu có cấu trúc, có thể tìm kiếm
- Cron & Scheduler