Quick Start (Con người)

Hướng dẫn này dẫn bạn qua việc lấy tài khoản Synapse, Mind Key đầu tiên và lưu bộ nhớ đầu tiên. Tổng thời gian: ~5 phút.

Bước 1: Đăng ký tài khoản

Mở Synapse API và tạo tài khoản:

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

Phản hồi:

{
  "jwt": "eyJhbGci...",
  "user": { "id": "u_abc123", "email": "you@example.com" }
}

Bước 2: Tạo Mind đầu tiên của bạn

"Mind" là phạm vi bộ nhớ tách biệt. Hầu hết người dùng bắt đầu với một mind, nhưng bạn có thể có nhiều (ví dụ "work", "personal", "project-x"). Mỗi mind có Mind Key duy nhất riêng.

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"
  }'

Phản hồi:

{
  "id": "m_xyz789",
  "name": "My First Mind",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}

Bước 3: Lưu bộ nhớ đầu tiên

Bây giờ sử dụng Mind Key để lưu bộ nhớ:

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"
  }'

Phản hồi:

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

Bước 4: Thu hồi tất cả bộ nhớ

Để truy xuất mọi thứ bạn đã lưu:

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

Phản hồi (văn bản thuần, tối ưu cho tiêu thụ 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

Bước 5: Tìm kiếm bộ nhớ

Tìm bộ nhớ cụ thể theo từ khóa:

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

Bước 6: Kết nối LLM của bạn

Cách dễ nhất để cấp cho LLM truy cập Synapse là qua MCP:

• Thiết lập Claude Desktop — cấu hình 2 phút
• Thiết lập Claude Code — tích hợp terminal
• Thiết lập Cursor — tích hợp IDE

Sau khi thiết lập, LLM của bạn sẽ tự động gọi memory_recall ở đầu mỗi phiên và lưu trữ sự kiện mới qua memory_store.

Danh mục bộ nhớ

Synapse hỗ trợ 8 danh mục — chọn cái cụ thể nhất:

Mức ưu tiên

• low — tốt nếu biết
• normal — mặc định
• high — quan trọng
• critical — không bao giờ được quên (nhận dạng người dùng, thông tin pháp lý)

Bước tiếp theo

• Xác thực chuyên sâu
• Mind Key vs JWT
• Tham chiếu Memory API
• Tích hợp MCP