Xây dựng hệ thống bộ nhớ AI vĩnh viễn trên Cloudflare

Tầm quan trọng của bộ nhớ AI vĩnh viễn đối với Agent

Khi các trợ lý ảo AI ngày càng tích hợp sâu rộng vào đời sống và công việc hàng ngày, chúng ta thường xuyên đối mặt với vấn đề "ngữ cảnh trống" (blank context). Các quyết định hoặc thông tin trao đổi từ tuần trước đều bị lãng quên, buộc chúng ta phải nhập lại cùng một thông tin về stack công nghệ và cấu hình lại các tùy chọn người dùng cho mỗi phiên làm việc mới.

Thay vì phải bắt đầu lại từ con số không mỗi lần trò chuyện, chúng ta cần xây dựng một hệ thống bộ nhớ có khả năng tự tiến hóa, liên tục thấu hiểu các quyết định của người dùng và loại bỏ hoàn toàn việc lặp lại ngữ cảnh không cần thiết.

So sánh hệ thống bộ nhớ AI tự host và bộ nhớ tích hợp

Nhiều Agent AI hiện nay đi kèm với bộ nhớ tích hợp sẵn, nhưng thực tế chúng ta ít khi chỉ dùng duy nhất một Agent cho mọi công việc. Chúng ta dùng Claude để thiết kế và xây dựng kiến trúc dự án; dùng Kimi để lập trình; và dùng ChatGPT để nghiên cứu chuyên sâu. Ngữ cảnh không thể chia sẻ chéo giữa các Agent này; chúng hoàn toàn bị cô lập trong từng công cụ riêng biệt.

Từ góc độ kỹ thuật phần mềm, chúng ta không tin tưởng vào các hệ thống đóng (black boxes). Chúng ta cần một hệ thống bộ nhớ AI có thể quan sát, kiểm tra và hoàn toàn nằm dưới quyền kiểm soát của mình. Dự án mã nguồn mở Second Brain, một bản fork từ https://github.com/rahilp/second-brain-cloudflare, cung cấp một hệ thống bộ nhớ vĩnh viễn và tự host với sự hỗ trợ đầy đủ cho Model Context Protocol (MCP). Bất kỳ Agent AI nào tương thích như Claude, ChatGPT hoặc Kimi Code đều có thể dùng chung một ngữ cảnh bộ nhớ thống nhất này.

Cách xây dựng bộ nhớ AI Second Brain trên Cloudflare

Hệ thống bộ nhớ Second Brain được triển khai trên nền tảng Cloudflare Workers, cung cấp một cơ sở hạ tầng serverless phân tán toàn cầu với độ trễ cực kỳ thấp. Điều này đảm bảo rằng các thao tác tìm kiếm bộ nhớ (recall) và lưu trữ diễn ra gần như tức thì trong vòng lặp tư duy của AI.

Mô hình embedding từ Workers AI được sử dụng để tạo ra các vector sém thức. Các embedding này được lưu trữ trong Cloudflare Vectorize, một cơ sở dữ liệu vector phân tán toàn cầu được tối ưu hóa cao. Cloudflare Vectorize sẽ thực hiện các truy vấn tìm kiếm độ tương đồng cosine (cosine similarity) để xác định chính xác các ký ức có liên quan về mặt ngữ nghĩa.

Second Brain cũng tích hợp sẵn cơ chế chống trùng lặp và hợp nhất thông minh. Các nội dung có độ tương đồng dưới 85% sẽ được lưu trực tiếp; nếu không, chúng sẽ bị chặn hoặc đánh dấu là đối tượng trùng lặp tiềm năng. Các đoạn văn bản dài vượt quá 1.600 ký tự sẽ được cắt nhỏ dựa trên ranh giới câu hoặc dấu xuống dòng, giữ lại phần chồng lấp (overlap) 200 ký tự để duy trì tính liên tục của ngữ cảnh. Mỗi mảnh nhỏ sau đó được vector hóa để đảm bảo độ khớp chính xác cao nhất.

Các công cụ sau đây được cấu hình dưới dạng giao diện MCP để các Agent AI gọi trực tiếp:

• remember: Lưu trữ ý tưởng, quyết định, sở thích và ngữ cảnh dự án nói chung.
• append: Thêm thông tin cập nhật mới vào một ký ức đã có.
• update: Thay thế hoàn toàn một ký ức hiện tại.
• recall: Tìm kiếm ký ức dựa trên ý nghĩa sém nghĩa của chúng thay vì so khớp từ khóa chính xác.
• list_recent: Liệt kê các ký ức vừa được lưu gần đây.
• forget: Xóa vĩnh viễn một bản ghi ký ức.
• link/connections: Kết nối các ký ức có liên quan với nhau (tính năng đồ thị v2).

Cài đặt Second Brain trên Cloudflare

1. Click vào Deploy to Cloudflare trên trang Github repo. [[]]
2. Điền đầy đủ thông tin vào form Cloudflare Worker hiển thị.
3. Nhập '384' cho Dimensions; chọn 'cosine' cho Metric; và click nút Deploy.
4. Dưới đây là tổng quan giao diện Second Brain của bạn trong Cloudflare Worker:
5. Mở tab 'Settings', sau đó click vào biểu tượng chỉnh sửa ở biến 'AUTH_TOKEN' để tạo một token bảo mật:
6. Click vào link 'Rotate' để có thể nhập giá trị mới:
7. Chạy lệnh openssl rand -base64 32 tại terminal macOS để tạo một chuỗi ngẫu nhiên bảo mật và dán vào trường nhập liệu 'Value'.
8. Click nút 'Deploy' để lưu giá trị mới của biến 'AUTH_TOKEN'.
9. Mở URL worker Second Brain của bạn trên trình duyệt web.
10. Nhập token 'AUTH_TOKEN' đã tạo vào ô Bearer token và click nút 'Connect' để đăng nhập vào bảng điều khiển Web UI.

Tích hợp Claude Desktop qua giao thức MCP

1. Click vào 'Customize' trong phần cài đặt của Claude Desktop.
2. Click vào 'Developer' để mở và chỉnh sửa trực tiếp file cấu hình máy chủ MCP:
3. Thêm khối mã sau vào phần mcpServers trong file claude_desktop_config.json:

    "second-brain": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<your-worker-url>/mcp",
        "--header",
        "Authorization: Bearer <your-token>"
      ]
    }

4. Khởi động lại Claude Desktop và kiểm tra danh sách 'Local MCP servers'. Trạng thái cần hiển thị là 'running' (đang hoạt động).

Tích hợp Claude Code qua giao thức MCP

• Chạy lệnh sau trong terminal để thêm máy chủ MCP mới:

claude mcp add --transport http second-brain https://<your-worker-url>/mcp

• Claude Code sẽ tự động phát hiện endpoint yêu cầu OAuth và mở trang đăng nhập trên trình duyệt web để bạn xác thực AUTH_TOKEN.
• Tạo file CLAUDE.md trong thư mục ~/.claude với các chỉ dẫn chi tiết lấy từ CLAUDE_INSTRUCTIONS.md.

Tích hợp Gemini CLI qua giao thức MCP

1. Thêm cấu hình máy chủ MCP sau vào file './.gemini/settings.json' của bạn:

    "second-brain": {
      "httpUrl": "https://<your-worker-url>/mcp",
      "oauth": {
        "enabled": true
      }
    }

2. Khởi chạy Gemini CLI.

Thử nghiệm Second Brain với các AI Agent

1. Khi cấu hình một bảng màu thương hiệu cơ bản trên Claude Desktop, mặc định Second Brain không được gọi ngay lập tức.
2. Khi dùng các từ khóa đơn giản như 'remember', chỉ có công cụ tích hợp sẵn cục bộ memory_user-edits trên Claude Desktop hoạt động, còn lớp lưu trữ đám mây Second Brain thì bị bỏ qua.
3. Khi gửi lệnh sau trên Claude Code, kết nối với Second Brain đã được kích hoạt thành công:

Remember Our brand palette uses `#1a1a2e` as primary, `#16213e` as secondary, and `#e94560` as accent. Never use pure black."

4. Xác minh cấu hình màu mới đã được lưu trực tiếp trên bảng điều khiển của Second Brain trên Cloudflare: - Claude Code có thể hoạt động hoàn toàn tự động vì file chỉ dẫn CLAUDE_INSTRUCTIONS.md trong dự án có chứa các quy tắc trỏ đến từ khóa của 'Second Brain'. 5. Để sử dụng kết nối này trên Claude Desktop, bạn cần chỉ định rõ cụm từ 'Second Brain' trong prompt trò chuyện để ép Agent ghi hoặc đọc ở lớp bộ nhớ vĩnh viễn này. 6. Điều tương tự cũng áp dụng cho Gemini CLI, bạn cần nhắc đến từ khóa 'Second Brain' để kích hoạt công cụ MCP tương ứng. - Bằng cách thêm các chỉ dẫn tương tự vào file GEMINI.md, mô phỏng theo cách làm của CLAUDE_INSTRUCTIONS.md, hệ thống sẽ tự động gọi Second Brain chạy ngầm mà bạn không cần phải gõ từ khóa một cách thủ công nữa.

Tiện ích mở rộng trên trình duyệt Web

• Có sẵn các tiện ích mở rộng cho các trình duyệt phổ biến như Chrome, Firefox và Microsoft Edge.
• Các tính năng chính bao gồm:
  • Lưu trang hiện tại — lưu ngay tiêu đề và địa chỉ URL của trang vào Second Brain.
  • Lưu văn bản bôi đen — bôi đen đoạn văn bản bất kỳ trên trang trước khi click vào biểu tượng tiện ích; đoạn trích dẫn sẽ được lưu kèm theo tiêu đề và URL nguồn.
  • Thêm ghi chú nhanh — viết thêm ghi chú nhanh hoặc gán các #hashtags trực tiếp trên cửa sổ popup của tiện ích trước khi bấm lưu; các hashtag sẽ tự động được trích xuất thành các nhãn phân loại.

Đồng bộ hóa kiến thức cá nhân với Plugin Obsidian

• Có sẵn một plugin dành riêng cho Obsidian để đồng bộ hóa các ghi chú cá nhân từ Obsidian Vault trực tiếp lên Second Brain trên Cloudflare.
• Bạn có thể đặt các nhãn tag cụ thể trên các ghi chú muốn cho phép đồng bộ lên bộ nhớ đám mây vĩnh viễn.

Cài đặt Plugin Obsidian

1. Mở Obsidian → Settings → Community Plugins
2. Click vào nút 'Browse'.
3. Tìm kiếm từ khóa 'Second Brain Sync'.
4. Click nút 'Install' sau đó click 'Enable'.

Cấu hình Plugin Obsidian

1. Truy cập Obsidian → Settings → Second Brain Sync
2. Nhập các thông tin 'URL' và 'Auth token' của Worker của bạn vào các ô tương ứng.
3. Click nút 'Test' để xác minh kết nối từ xa đã sẵn sàng hoạt động.
4. Cấu hình các hành vi đồng bộ. Đặt tag kích hoạt đồng bộ ở mục 'Sync tag' và bật tùy chọn 'Auto-sync on save'.
5. Tạo một ghi chú mới trong Obsidian kèm theo tag 'second-brain' (như đã cấu hình trong bảng thiết lập).
6. Ghi chú này sau khi lưu sẽ lập tức được đồng bộ tự động lên thực thể Cloudflare của bạn.

Kết luận

Second Brain mang lại một giải pháp mã nguồn mở thông minh để giải quyết một trong những rào cản gây ức chế nhất của công nghệ AI hiện nay: tình trạng mất ngữ cảnh và thiếu bộ nhớ lưu trữ dài hạn. Bằng cách kết hợp dự án này với cơ sở hạ tầng serverless có tính co giãn cao của Cloudflare, chúng ta sở hữu một lớp bộ nhớ sém thức tự host, phân tán toàn cầu và có độ trễ cực thấp. Với việc hỗ trợ giao thức MCP mở, kho tri thức này hoàn toàn có thể di động và dùng chung cho mọi Agent ảo khác nhau.

Việc tích hợp qua Obsidian còn nâng tầm kiến trúc này hơn nữa bằng cách kết nối việc ghi chép thông thường trực tiếp vào quy trình phân tích logic của AI. Các ghi chú thô của bạn được chuyển hóa thành các dữ liệu cấu trúc mà các Agent có thể thấu hiểu và khai thác bất kỳ lúc nào.

Bằng cách hợp nhất mô hình tự host, tìm kiếm sém nghĩa dạng vector và các chuẩn tích hợp mở như MCP; Second Brain đã chứng minh đây không chỉ đơn thuần là nơi lưu trữ ký ức, mà còn là nền tảng thực tiễn tuyệt vời để xây dựng một hệ sinh thái AI hiệu quả của riêng bạn.

Tài liệu tham khảo:

• https://www.thesecondbrain.dev/
• https://github.com/rahilp/second-brain-cloudflare/wiki/How-It-Works
• Connect to AI Clients
• Second Brain Obsidian Plugin
• https://github.com/rahilp/second-brain-obsidian-plugin