Skip to main content

Quick Start (Human)

สมัครบัญชี, สร้าง mind แรก, เก็บ memory — ทั้งหมดใน 5 นาที


Quick Start (Human)

คู่มือนี้นำคุณผ่านการสมัครบัญชี Synapse, Mind Key แรก และเก็บ memory แรก เวลารวม: ~5 นาที

ขั้นตอนที่ 1: สมัครบัญชี

เปิด Synapse API และสร้างบัญชี:

curl -X POST https://synapse.schaefer.zone/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password"
  }'

Response:

{
  "jwt": "eyJhbGci...",
  "user": { "id": "u_abc123", "email": "you@example.com" }
}
บันทึก JWT ไว้ที่ปลอดภัย — คุณต้องใช้เพื่อสร้าง mind JWT หมดอายุหลัง 7 วัน; ล็อกอินใหม่ด้วย endpoint เดียวกันเพื่อ refresh

ขั้นตอนที่ 2: สร้าง Mind แรกของคุณ

"mind" คือ scope memory ที่แยกออก ผู้ใช้ส่วนใหญ่เริ่มด้วย mind เดียว แต่คุณสามารถมีหลาย mind ได้ (เช่น "work", "personal", "project-x") แต่ละ mind มี Mind Key ที่ไม่ซ้ำกัน

curl -X POST https://synapse.schaefer.zone/minds \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Mind",
    "description": "Personal assistant memory"
  }'

Response:

{
  "id": "m_xyz789",
  "name": "My First Mind",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}
**บันทึก `mind_key` ทันที** แสดงเพียงครั้งเดียวและดึงคืนไม่ได้ หากคุณสูญเสีย ต้องสร้าง mind ใหม่

ขั้นตอนที่ 3: เก็บ Memory แรกของคุณ

ตอนนี้ใช้ Mind Key เพื่อเก็บ memory:

curl -X POST https://synapse.schaefer.zone/memory \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "identity",
    "key": "user_name",
    "content": "My name is Michael",
    "tags": ["personal", "identity"],
    "priority": "critical"
  }'

Response:

{
  "id": "mem_001",
  "status": "stored",
  "mind_id": "m_xyz789"
}

ขั้นตอนที่ 4: Recall Memory ทั้งหมด

เพื่อดึงทุกสิ่งที่คุณเก็บไว้:

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

Response (plain text, ปรับให้เหมาะกับการบริโภคของ LLM):

Mind: My First Mind
Memories: 1 total (1 verified)

[001] identity (CRITICAL)
  user_name
  My name is Michael
  Tags: personal, identity
  Stored: 2026-06-27

ขั้นตอนที่ 5: ค้นหา Memory

หา memory เฉพาะตาม keyword:

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/memory/search?q=michael"

ขั้นตอนที่ 6: เชื่อมต่อ LLM ของคุณ

วิธีที่ง่ายที่สุดในการให้ LLM เข้าถึง Synapse คือผ่าน MCP:

หลังตั้งค่า LLM ของคุณจะเรียก memory_recall โดยอัตโนมัติที่จุดเริ่มต้นของทุก session และเก็บ fact ใหม่ผ่าน memory_store

Memory Category

Synapse รองรับ 8 category — เลือกอันที่เฉพาะเจาะจงที่สุด:

Category กรณีใช้งาน
identity ชื่อผู้ใช้, role, ข้อมูลติดต่อ
preference สิ่งที่ชอบ/ไม่ชอบ, สไตล์การทำงาน
fact fact ที่ตรวจสอบได้ (รายละเอียดโปรเจกต์, วันที่)
project สถานะโปรเจกต์, milestone, todo
skill สิ่งที่ผู้ใช้ทำได้ดี
mistake error ในอดีต — หลีกเลี่ยงการทำซ้ำ
context context ที่เกี่ยวข้องกับ session
note note อื่น ๆ

ระดับ Priority

  • low — รู้ไว้ก็ดี
  • normal — ค่าเริ่มต้น
  • high — สำคัญ
  • critical — ต้องไม่ลืมเด็ดขาด (ตัวตนผู้ใช้, ข้อมูลทางกฎหมาย)

ขั้นตอนถัดไป