Tổng quan — Từ ý tưởng đến trang web
Hệ thống tài liệu Luklak hoạt động theo 5 bước tự động:1
Chat — Ra đề
Người phụ trách nội dung ra lệnh bằng ngôn ngữ tự nhiên qua cửa sổ chat, ví dụ: “Viết tiếp group Use & Operate.”
2
AI Agent (Lulu) — Viết + Cấu hình
Agent Lulu (Luklak Learning Unit) đóng vai trò Tổng biên tập: đọc file nguồn tiếng Anh, transcreate sang tiếng Việt, tạo file
.mdx, và cập nhật menu sidebar (docs.json).3
Git Push — Đẩy lên kho
Agent tự chạy lệnh
git commit + git push để gửi toàn bộ thay đổi lên GitHub.4
Mintlify CI/CD — Tự động build
GitHub nhận code mới → kích hoạt Mintlify → hệ thống kiểm tra lỗi → build thành trang web.
5
Web Live — Cập nhật
Trang web tài liệu tự động cập nhật trong chưa đầy 2 phút. Không cần ai bấm nút deploy.
Kiến trúc Dự án — Cái gì nằm ở đâu?
Hai kho song song
Kho EN (Gốc)
Tài liệu tiếng Anh chuẩn — “bản vẽ kỹ thuật” gốc. Chỉ đọc, không sửa.
Kho VN (Đích)
Tài liệu tiếng Việt — nơi Agent tạo bài mới. Đây là kho được deploy lên web.
Cấu trúc thư mục
File docs.json — “Bộ não” của sidebar
File này quyết định thứ tự hiển thị trên menu. Nếu bạn viết 10 bài nhưng không khai báo trong
docs.json, không bài nào xuất hiện trên web.Tab → Group → Sub-group → Page.
Cơ chế AI Agent
Agent là gì?
Agent (code name: Antigravity) không phải chatbot thông thường. Nó là một AI có tay — ngoài việc hiểu ngôn ngữ, nó còn thực hiện hành động trực tiếp trên máy tính:Đọc file
Mở và đọc bất kỳ file nào trên máy — file nguồn EN, file cấu hình, ảnh.
Tạo & Sửa file
Viết bài
.mdx mới hoặc cập nhật file đang có (menu, nội dung).Chạy lệnh Terminal
Tự commit code, push lên GitHub, copy ảnh — mọi thao tác dòng lệnh.
Vòng lặp làm việc (Agent Loop)
Mỗi lần nhận lệnh, Agent chạy qua 6 bước:1
AI Agent (Lulu) nhận lệnh từ Chat
Bạn nói: “Viết tiếp group Use & Operate.”
2
Khảo sát nguồn
Agent tự vào thư mục EN, đếm file, loại trùng → kết luận: “Cần tạo 11 bài.”
3
Đọc & Transcreate
Đọc từng file EN → viết lại hoàn toàn bằng tiếng Việt (không dịch word-by-word). Giữ đúng giọng văn kiến trúc B2B, thuật ngữ chuẩn Luklak.
4
Tạo file .mdx
Gọi tool
write_to_file → 11 file .mdx mới xuất hiện trên máy tính.5
Cập nhật menu
Gọi tool
replace_file_content → thêm 11 bài vào docs.json ở đúng vị trí.6
Commit + Push
Chạy
git add . → git commit → git push → code lên GitHub.Ví dụ cụ thể: Viết group “Sử dụng & Vận hành”
Skill — Tại sao Agent viết đúng giọng?
Agent được trang bị các nguồn kiến thức để đảm bảo nhất quán:Knowledge Items (KI)
Các file “kiến thức” lưu từ những cuộc chat trước. VD: “Luklak dùng giọng văn kiến trúc B2B”, “Dùng từ ‘Đầu việc’ cho Object.”
Conversation History
Agent nhớ các quyết định trước đó. VD: Bạn đã chọn giữ “kì diệu” và “kịch chân tường” trong bản Việt.
File EN gốc
Nội dung chuẩn — Agent đọc để hiểu ý nghĩa, không phải để dịch máy móc.
docs.json hiện tại
Agent đọc cấu trúc menu để biết group mới nên đặt ở đâu — ngang hàng hay lồng vào.
Feedback Loop — Bạn kiểm duyệt, Agent sửa
1
Agent viết bản đầu
Tạo file, push lên web.
2
Bạn review trên web
Kiểm tra nội dung, cấu trúc menu, vị trí bài.
3
Feedback qua Chat
VD: “Thiết kế Chức năng đang lồng trong 9 Lego Blocks, phải tách ra ngang hàng.”
4
Agent sửa + push lại
Hiểu yêu cầu → sửa
docs.json → push → sidebar cập nhật đúng cấu trúc.CI/CD Pipeline — Từ Push đến Web
CI/CD là gì?
CI — Continuous Integration
Mỗi lần có thay đổi, hệ thống tự động kiểm tra xem có lỗi cú pháp, file thiếu, hay link hỏng không.
CD — Continuous Deployment
Nếu không có lỗi, hệ thống tự động đưa lên web — không cần ai bấm nút “deploy”.
Luồng chi tiết
1
Agent push code lên GitHub
Lệnh
git push origin main gửi toàn bộ file mới/sửa lên kho.2
GitHub kích hoạt Mintlify webhook
GitHub tự động gửi tín hiệu “có code mới” cho Mintlify.
3
Mintlify đọc & kiểm tra
Hệ thống đọc
docs.json + tất cả file .mdx, kiểm tra cú pháp và liên kết.4
Build thành trang web
Chuyển đổi Markdown thành HTML với giao diện đẹp, responsive, có search.
5
Deploy lên CDN toàn cầu
Nội dung được phân phối qua mạng lưới CDN — truy cập nhanh từ mọi nơi.
Thời gian thực tế
Ai làm gì?
Kết quả: Bạn không cần biết code, không cần cấu hình server, không cần copy-paste. Bạn chỉ cần nói rõ ý muốn — hệ thống Agent Lulu + CI/CD sẽ biến ý tưởng thành trang web tài liệu chuyên nghiệp trong vài phút.Xem thêm: Setup & Bản sắc Lulu Agent