# Variables API
SUMMARY: Key-value store ที่รวดเร็วสำหรับสถานะ LLM — counter, flag, last-seen timestamp, ความคืบหน้าบางส่วน

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 เป็น key-value store ที่รวดเร็วสำหรับสถานะชั่วคราว ต่างจาก memory (ซึ่งถูก index, ค้นหาได้ และมีโครงสร้าง) ตรงที่ variable ถูกปรับให้เหมาะกับการอ่าน/เขียนรวดเร็ว — เหมาะสำหรับ counter, flag และสถานะ session
Endpoints
POST /var
ตั้งหรืออัปเดต variable
[CODE BLOCK]
GET /var/:key
ดึง variable เดียว
[CODE BLOCK]
Response:
[CODE BLOCK]
GET /var
รายการ variable ทั้งหมด
[CODE BLOCK]
DELETE /var/:key
ลบ variable
[CODE BLOCK]
เมื่อใดควรใช้ Variables vs Memory
| กรณีใช้งาน | ใช้ |
|----------|-----|
| ชื่อผู้ใช้, ค่ากำหนด | Memory (searchable, structured) |
| Last session timestamp | Variable (ephemeral state) |
| Counter (เช่น ข้อความที่ส่ง) | Variable (frequent updates) |
| สถานะ workflow ("step 3 of 5 done") | Variable (transient) |
| Note โปรเจกต์แบบยาว | Memory (full-text indexed) |
| Script ที่ใช้ซ้ำ | Script store (named, versioned) |
รูปแบบทั่วไป
ติดตาม session ล่าสุด
[CODE BLOCK]
รูปแบบ Counter
[CODE BLOCK]
Feature flag
[CODE BLOCK]
ขั้นตอนถัดไป
- Memory API — สำหรับข้อมูลที่มีโครงสร้างและค้นหาได้
- Cron & Scheduler