Skip to main content

​
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

mintlify-tailieuvn/
├── docs.json                    ← "Bản đồ" menu sidebar
├── images/                      ← Tất cả hình ảnh
├── 01-getting-started/          ← Tab 1: Bắt đầu
├── 02-platform/                 ← Tab 2: Nền tảng cốt lõi
│   ├── platform-overview/       ← Tổng quan + 9 Lego Blocks
│   ├── governance/              ← Tầng 1: Governance
│   ├── function-design/         ← Thiết kế Chức năng
│   └── use-and-operate/         ← Sử dụng & Vận hành
└── 03-build/                    ← Tab 3: Case Studies

​
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.
Cấu trúc logic: 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”

BướcAgent làm gìKết quả
Khảo sátĐọc thư mục mintlify-en/en/02-platform/use-and-operate/Phát hiện 13 file, loại 2 trùng → 11 bài cần viết
Đọc nguồnview_file("personal-home.mdx") — đọc 69 dòng ENHiểu: “Personal Home = dashboard cá nhân”
TranscreateViết lại hoàn toàn bằng tiếng Việt”Trang chủ Cá nhân” — giọng kiến trúc, dùng “Đầu việc”, “Mảng việc”
Tạo filewrite_to_file("trang-chu.mdx")File mới trên máy
Cập nhật menuSửa docs.json — thêm group + 12 pagesSidebar hiển thị đúng
Pushgit push origin mainCode lên GitHub trong 5 giây

​
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.
Vòng lặp này có thể chạy không giới hạn cho đến khi nội dung đúng ý. Mỗi vòng mất khoảng 1-3 phút.

​
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ế

BướcThời gian
Agent viết 11 bài + cập nhật menu~3 phút
git push~5 giây
Mintlify build + deploy~30-60 giây
Tổng: từ “viết xong” đến “lên web”< 2 phút

​
Ai làm gì?

Vai tròCông việcCông cụ
Bạn (Specifier)Ra đề, review, quyết định giọng văn & cấu trúcChat window
Agent (Builder)Đọc nguồn EN, transcreate VN, tạo file, cập nhật menu, push codeTools: view_file, write_to_file, replace_file_content, run_command
GitHub (Storage)Lưu trữ toàn bộ lịch sử thay đổi, cho phép rollback bất kỳ lúc nàoGit version control
Mintlify (Publisher)Tự động build HTML từ Markdown, deploy lên webCI/CD pipeline
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