# Công nghệ nền của Maguyva Canonical source: https://maguyva.ai/vi/stack License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license). Được xây dựng để chạy nhanh, dễ gỡ lỗi và liên tục cải tiến: hạ tầng đã được kiểm chứng làm nền tảng, cùng các thành phần chuyên dụng ở những nơi trí tuệ mã nguồn cần đến. - PostgreSQL + Lance - Tìm kiếm vector lượng tử hóa - Công cụ ngôn ngữ mã nguồn - MCP ở khắp mọi nơi - 285+ ngôn ngữ ## Những gì đang chạy trong production Đây là những lớp cốt lõi còn tồn tại sau nhiều lần lặp lại. Mỗi lớp đều giành được vị trí của mình bằng cách giúp debug dễ hơn hoặc loại bỏ ma sát trong quá trình agent thực thi. ### PostgreSQL + Lance *Cơ sở dữ liệu* Lưu trữ và chỉ mục được phân vùng theo tenant. Code của bạn luôn tách biệt, không có chuyện chỉ mục giữa các user bị trộn lẫn. ### Voyage AI: voyage-4-large *Embedding* Embedding mã nguồn có độ recall cao, phục vụ tìm kiếm, truy xuất, và tạo căn cứ cho agent. ### Binary Quantized HNSW *Tìm kiếm vector* Embedding được nén thành chữ ký 2048-bit và lập chỉ mục bằng HNSW. Giảm 32 lần dung lượng lưu trữ, tìm kiếm độ trễ thấp, không cần thêm hạ tầng. ### Công cụ ngôn ngữ mã nguồn *Công cụ ngôn ngữ* Một stack Tree-sitter được tùy biến sâu, với grammar riêng, các heuristic xử lý (handler), và độ phủ trích xuất cho 285 ngôn ngữ ### Giao thức MCP *Giao thức* Máy chủ MCP từ xa cho Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop và các client khác tương thích với MCP. 11 công cụ chạy trên một Cloudflare Worker viết bằng TypeScript, hỗ trợ trực tiếp cơ chế truyền tải streamable HTTP. ### Lance dạng cột + R2 *Cache* Embedding được cache dạng cột, đồng bộ qua cloud ## Stack sau những ngõ cụt Maguyva không có hình hài này ngay từ đầu. Mỗi lớp tồn tại được là vì nó giúp hệ thống dễ suy luận hơn, rẻ hơn để vận hành, hoặc dễ debug hơn khi gặp áp lực. Các thử nghiệm điều phối đã bắt đầu từ trước đó. Dòng thời gian này bắt đầu từ tháng 9 năm 2025, khi bản thân sản phẩm Maguyva mới thực sự định hình rõ ràng. - **2025-Q3** (nền tảng): Bắt đầu tập trung xây dựng Maguyva → Voyage voyage-code-3. Hướng đi sản phẩm được định hình rõ ràng và vòng lặp phát triển nhanh bắt đầu - **2025-Q3** (lưu trữ): Lớp truy xuất vector nhị phân. Tìm kiếm lượng tử hóa với chỉ mục gọn nhẹ, không cần stack vector riêng - **2025-Q4** (bộ máy AST): Công cụ ngôn ngữ mã nguồn đi vào hoạt động. Query tùy biến, fallback parser, và heuristic dựa trên handler trên 285 ngôn ngữ - **2025-Q4** (tìm kiếm): Tìm kiếm hợp nhất đa phương thức. Truy xuất có xếp hạng trên các chỉ mục ngữ nghĩa, văn bản, AST và đồ thị trong một truy vấn duy nhất - **2026-Q1** (bộ nhớ đệm): Đồng bộ Lance dạng cột + R2. Cache dạng cột phía server, khởi động nguội nhanh hơn - **2026-Q1** (chất lượng): Framework kiểm chứng cho 285 ngôn ngữ. Kiểm thử trích xuất tự động trên mọi ngôn ngữ được hỗ trợ - **2026-Q1** (ra mắt): Ra mắt công khai tại maguyva.ai. 7 tháng từ lúc tập trung xây dựng đến khi công khai ra mắt - **2026-Q2** (giao thức): TypeScript Cloudflare Worker MCP (dịch vụ MCP chạy ở biên). Cơ chế truyền tải streamable HTTP được hỗ trợ trực tiếp, độ trễ thấp hơn, chuyển đổi ngay khi hệ thống đang phục vụ lưu lượng thực - **NOW** (biểu diễn véc-tơ): Embedding dùng cho production → voyage-4-large. Tìm kiếm ngữ nghĩa với khả năng truy hồi đầy đủ hơn sau khi chuyển từ voyage-code-3 ## Chúng tôi dùng chính thứ mình ra mắt Maguyva được xây dựng bởi các agent chạy trên chính Maguyva. Hệ thống điều phối của chúng tôi phối hợp các agent AI chuyên biệt, sử dụng cùng những công cụ MCP, chỉ mục tìm kiếm, và hạ tầng sản xuất mà bạn nhận được. Không có phiên bản nội bộ nào khác. Trang team liệt kê “1x Maguyva ($149) — chúng tôi tự trả tiền cho chính mình.” Đó không phải là đùa. Đó là hóa đơn thật. // customer zero triển khai lên production hằng ngày ## Những quy tắc sống sót qua production Đây là những ràng buộc vẫn còn hữu ích trong production. Chúng ít mang tính hệ tư tưởng, mà thiên về việc giữ cho hệ thống dễ hiểu trong khi agent đang thay đổi mã với tốc độ cao. ### Không âm thầm dùng phương án dự phòng Phát hiện lỗi sớm, sửa lỗi nhanh. Mọi lỗi đều được báo ngay. Không âm thầm giảm chức năng để che giấu lỗi trong production. *// thà panic còn hơn âm thầm làm hỏng dữ liệu* ### Ưu tiên RPC Logic đặt phía database để tối ưu hiệu năng. Các hàm PostgreSQL thực thi gần dữ liệu, loại bỏ round trip không cần thiết. *// hàm PostgreSQL, 0 ORM* ### CQRS Tách riêng đường ghi và đường đọc. Pipeline lập chỉ mục ghi, công cụ MCP đọc. Mỗi bên có chiến lược tối ưu riêng. *// ghi: theo batch | đọc: cache* ### UUID Tất Định Đồng nhất cache mà không cần tra cứu database. Cùng input = cùng ID. Các thao tác idempotent ngay từ thiết kế. *// uuid5(namespace, content_hash)* Kiến trúc tốt nhất là kiến trúc bạn có thể debug lúc 3 giờ sáng. (Chúng tôi đã thử rồi.) // cập nhật lần cuối: 2026-10 [Thử trên repo của bạn](https://app.maguyva.ai/auth/sign-up?plan=free) ## Code của bạn nằm ở đâu Không có gì bí ẩn cả. Đây chính xác là những gì xảy ra với code của bạn khi bạn kết nối một repo. - **Server bare-metal, US East** (Điện toán): Máy bare-metal đặt tại Ashburn, được tinh chỉnh cho thông lượng lập chỉ mục, thay vì các máy ảo đa dụng phải chia sẻ tài nguyên gây nhiễu hiệu năng. - **CDN toàn cầu của Cloudflare** (Edge): Phản hồi API và MCP được cache tại edge. Tài nguyên tĩnh được phục vụ từ mạng lưới toàn cầu của Cloudflare. - **Phân vùng theo tenant, theo từng workspace** (Cách ly): Mỗi workspace có chỉ mục repository giới hạn theo tenant, xuyên suốt pipeline và database. Chúng tôi dùng code của khách hàng để cung cấp trí tuệ mã nguồn, không phải để huấn luyện model hay bán dữ liệu. - **Thành lập tại Singapore** (Pháp nhân): UT International PTE. LTD. Thẩm quyền tài phán rõ ràng, pháp nhân có thật. - **Xóa repo, xóa luôn chỉ mục** (Xóa): Ngắt kết nối một repo và Maguyva sẽ xóa mã nguồn đã lập chỉ mục đang hoạt động, các embedding và dữ liệu đồ thị khỏi dịch vụ. Các bản sao lưu còn lại sẽ hết hạn theo lịch lưu giữ. - **Cần khu vực EU hoặc AU?** (Khu vực): Các khu vực triển khai bổ sung là điều chúng tôi sẵn sàng trao đổi với khách hàng có yêu cầu về vị trí lưu trữ dữ liệu. ## Bước tiếp theo - [Bắt đầu](https://maguyva.ai/vi/docs): Lập chỉ mục repo đầu tiên của bạn chỉ trong vài phút. - [Xem bảng giá](https://maguyva.ai/vi/pricing): Tính phí theo workspace, không theo người dùng. Bắt đầu miễn phí. - [Gặp gỡ đội ngũ](https://maguyva.ai/vi/team): 2 con người và một bầy agent AI. - [Đọc blog](https://maguyva.ai/vi/blog): Ghi chú kỹ thuật từ quá trình xây dựng.