# Kiến trúc Synapse
SUMMARY: Cách Synapse được xây dựng — Fastify, PostgreSQL, FTS5, embeddings, MCP server.

Kiến trúc Synapse
Synapse là API bộ nhớ multi-tenant được xây dựng trên Fastify, PostgreSQL với
FTS5, và một dịch vụ embeddings tùy chọn cho tìm kiếm ngữ nghĩa.
Kiến trúc tổng quan
[CODE BLOCK]
Thành phần cốt lõi
1. Synapse API (Fastify)
HTTP server chính. Xử lý:
- Endpoint REST (, , , v.v.)
- Xác thực (Mind Key cho agent, JWT cho con người)
- Giới hạn tốc độ (chỉ xác thực )
- Phục vụ tệp tĩnh (giao diện web tại , , v.v.)
- Phân phối webhook
Được xây dựng với Fastify 5 cho hiệu suất. Chạy trên cổng 12800 trong môi trường production.
2. PostgreSQL với FTS5
Kho dữ liệu chính. Sử dụng PostgreSQL với phần mở rộng FTS5 cho tìm kiếm toàn
văn.
Bảng chính:
| Bảng | Mục đích |
|-------|---------|
|  | Tài khoản người dùng |
|  | Phạm vi mind (mỗi cái có một Mind Key) |
|  | Bản ghi bộ nhớ với bảng ảo FTS5 |
|  | Quản lý tác vụ |
|  | Lịch sử chat |
|  | Script cố định |
|  | Đăng ký webhook |
|  | Tác vụ đã lên lịch |
|  | Cửa hàng key-value |
|  | Nhật ký kiểm toán |
FTS5 cho phép tìm kiếm toàn văn dưới mili giây trên toàn bộ nội dung bộ
nhớ. Xem Tìm kiếm FTS5 để biết chi tiết.
3. Dịch vụ Embeddings (Tùy chọn)
Đối với tìm kiếm ngữ nghĩa, Synapse tạo vector embeddings của nội dung bộ nhớ.
Chúng được lưu cùng với bộ nhớ và dùng cho tìm kiếm tương tự.
- Provider: có thể cấu hình (OpenAI, mô hình cục bộ, v.v.)
- Lưu dưới dạng cột  trong bảng 
- Được sử dụng bởi endpoint 
- Xem Tìm kiếm ngữ nghĩa
4. MCP Server (Dịch vụ riêng)
Synapse MCP server chạy như một tiến trình riêng (cổng 13100). Nó:
- Cung cấp 79 công cụ qua Model Context Protocol
- Hỗ trợ transport stdio, HTTP/SSE và WebSocket
- Dịch các lệnh gọi công cụ MCP thành lệnh gọi Synapse API
- Multi-tenant: một Mind Key mỗi phiên
5. Browser Proxy (Dịch vụ riêng)
Đối với tự động hóa trình duyệt, một dịch vụ riêng dựa trên Playwright chạy
trên cổng 13000. MCP server có thể gọi dịch vụ này cho các công cụ .
6. SSH Proxy (Dịch vụ riêng)
Đối với lệnh từ xa dựa trên SSH, một dịch vụ riêng chạy trên cổng 12900.
Mô hình Multi-Tenancy
[CODE BLOCK]
Mỗi mind hoàn toàn tách biệt. Mind Key cấp quyền truy cập chính xác một mind.
JWT cấp quyền truy cập tài khoản người dùng (để quản lý mind).
Xem Multi-Tenancy để biết chi tiết.
Luồng yêu cầu
Yêu cầu lưu bộ nhớ
[CODE BLOCK]
Yêu cầu tìm kiếm bộ nhớ
[CODE BLOCK]
Triển khai
Synapse được triển khai dưới dạng Docker container. Xem :
[CODE BLOCK]
Đặc tính hiệu suất
| Thao tác | Độ trễ | Thông lượng |
|-----------|---------|------------|
| Lưu bộ nhớ | 5ms | 1000+ req/s |
| Thu hồi bộ nhớ | 20ms | 500 req/s |
| Tìm kiếm FTS5 | 10ms | 800 req/s |
| Tìm kiếm ngữ nghĩa | 50ms | 200 req/s |
| Poll chat | 5ms | 2000 req/s |
Bước tiếp theo
- Mô hình bộ nhớ
- Multi-Tenancy
- Tìm kiếm FTS5