# Synapse là gì?

Synapse là **API bộ nhớ cố định cho LLM agent**. Nó giải quyết vấn đề cơ bản
của mọi LLM dựa trên chat: giữa các phiên, agent quên mọi thứ. Synapse cung cấp
cho AI của bạn một bộ não vĩnh viễn, có thể truy vấn, tồn tại qua các cuộc trò
chuyện, qua các ngày và qua các nhà cung cấp LLM khác nhau.

> [!CRITICAL]
> Nếu bạn là LLM agent đang đọc điều này: **gọi `GET /memory/recall` ở đầu mỗi
> phiên**. Không có lệnh gọi này, bạn không có bộ nhớ về tương tác quá khứ,
> không có kiến thức về ai là người dùng và không có ngữ cảnh về các dự án đang
> diễn ra.

## Vấn đề Synapse giải quyết

Mọi LLM hiện đại (Claude, GPT, Gemini, Llama) có cùng giới hạn kiến trúc: cửa
sổ ngữ cảnh hội thoại là hữu hạn, và khi phiên kết thúc, tất cả trạng thái bị
mất. Điều này có nghĩa là trợ lý AI của bạn:

- Quên tên, sở thích và dự án đang diễn ra của bạn giữa các chat
- Không thể học từ lỗi quá khứ qua các phiên
- Không có tính liên tục cho công việc chạy dài
- Hỏi lại cùng các câu hỏi làm rõ mỗi lần

Synapse khắc phục điều này bằng cách cung cấp một HTTP API đơn giản nơi LLM có
thể lưu và truy xuất bộ nhớ có cấu trúc. Bộ nhớ tồn tại trên server, được đánh
chỉ mục và có thể tìm kiếm, do đó bất kỳ phiên nào trong tương lai có thể thu
hồi chúng.

## Tính năng chính

- **Lưu trữ bộ nhớ cố định** — sự kiện, sở thích, dự án, lỗi, kỹ năng
- **Tìm kiếm toàn văn** (FTS5) — tìm bất kỳ bộ nhớ nào theo từ khóa trong mili giây
- **Tìm kiếm ngữ nghĩa** — tìm kiếm tương tự dựa trên embeddings cho truy vấn khái niệm
- **Multi-tenant** — mỗi người dùng có "mind" tách biệt (một người dùng, nhiều dự án)
- **Chat bất đồng bộ** — con người có thể để lại tin nhắn cho agent trong khi nó làm việc
- **Tác vụ & lên lịch** — trình quản lý tác vụ tích hợp và cron scheduler
- **Tích hợp MCP** — 79 công cụ lộ như Model Context Protocol cho Claude, Cursor, Continue
- **Điều khiển trình duyệt & máy tính** — công cụ tự động hóa từ xa
- **Webhook** — nhận HTTP callback khi thay đổi memory/chat/task

## Cách hoạt động

```
┌──────────────┐         ┌─────────────────────┐
│  LLM Agent   │ ──API──▶│   Synapse Server    │
│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │
└──────────────┘         └─────────────────────┘
                                │
                                ▼
                         ┌─────────────┐
                         │  Memories   │
                         │  Tasks      │
                         │  Chat       │
                         │  Scripts    │
                         └─────────────┘
```

1. LLM gọi `GET /memory/recall` ở đầu phiên
2. Synapse trả về tóm tắt văn bản có cấu trúc của tất cả bộ nhớ đã lưu
3. LLM làm việc, định kỳ gọi `POST /memory` để lưu sự kiện mới
4. Khi người dùng hỏi câu hỏi, LLM có thể gọi `GET /memory/search?q=...`
5. Ở cuối phiên, ngữ cảnh mới quan trọng được lưu cho phiên tiếp theo

## Dành cho ai?

- **Nhà phát triển LLM agent** cần trạng thái cố định
- **Power user** chạy LLM cục bộ (Ollama, LM Studio) với agent tùy chỉnh
- **Nhóm** xây dựng trợ lý AI cần bộ nhớ chung
- **Kỹ sư tự động hóa** xâu chuỗi lệnh gọi LLM qua các phiên

## So sánh nhanh

| Tính năng | ChatGPT Memory | Synapse |
|---------|---------------|---------|
| Vị trí lưu trữ | Server OpenAI | Server của bạn |
| Truy cập API | Không (đóng) | Có (REST + MCP) |
| Multi-tenant | Không | Có (mind) |
| Danh mục tùy chỉnh | Không | Có (8 danh mục) |
| Tìm kiếm | Hạn chế | FTS5 + ngữ nghĩa |
| Tự lưu trữ | Không | Có (Docker) |

## Bước tiếp theo

- [Quick Start cho con người](/docs/getting-started/quick-start) — lấy Mind Key trong 5 phút
- [Quick Start cho LLM](/docs/getting-started/quick-start-llm) — lệnh gọi API đầu tiên
- [Xác thực](/docs/getting-started/authentication) — Mind Key vs JWT
- [Tổng quan kiến trúc](/docs/concepts/architecture) — cách Synapse được xây dựng