
Đội SEO và đội web ngày càng hay hỏi: AI agent đọc website của mình như thế nào, và làm sao đưa nội dung cho agent ở dạng gọn, dễ hiểu hơn HTML? Ngày 9/11/2026, Cloudflare thông báo Markdown for Agents chính thức GA (generally available), kèm bộ công cụ mới để đo và kiểm tra việc chuyển đổi: Analytics, Logs, Playground, GraphQL Analytics API và span trong Cloudflare Traces.
Bài này tóm tắt đúng phần Cloudflare đã công bố: tính năng làm gì, bật ở đâu, đo được gì và cần đọc số liệu thế nào cho đúng.
1. Markdown for Agents là gì
Khi một AI agent gửi request kèm header Accept: text/markdown, mạng Cloudflare lấy trang HTML gốc từ origin, chuyển sang Markdown ngay khi phục vụ và trả về cho agent. Người dùng bình thường vẫn nhận HTML như cũ.
Bản Markdown có cấu trúc cố định:
- YAML frontmatter lấy từ thẻ meta (title, description, image), chỉ có khi trang có các thẻ đó.
- Nội dung chính: header, footer, menu, script và style bị loại bỏ.
- JSON-LD (dữ liệu có cấu trúc) được giữ lại ở cuối tài liệu.
Header bảo mật và cache từ origin (HSTS, CSP, CORS, Cache-Control...) được giữ nguyên; Vary: Accept được thêm để cache lưu riêng bản HTML và bản Markdown. Nếu origin chưa đặt header content-signal, Cloudflare thêm mặc định ai-train=yes, search=yes, ai-input=yes. Nếu doanh nghiệp muốn chính sách khác cho việc AI dùng nội dung, hãy tự đặt content-signal ở origin trước khi bật.
2. Bật ở đâu
- Trong Cloudflare dashboard, chọn zone, vào Agent Readiness > Markdown for Agents.
- Bật Serve Markdown to AI agents (cần quyền sửa zone settings).
- Muốn bật cho một subdomain hay một đường dẫn (ví dụ chỉ
/blog/), dùng Configuration Rules.
Theo tài liệu Cloudflare, tính năng có cho gói Pro, Business, Enterprise và khách hàng SSL for SaaS. Giới hạn hiện tại: chỉ chuyển từ HTML, tối đa 6 MiB HTML sau giải nén.
3. Mới trong bản GA: đo được gì
Công cụ | Cho biết điều gì |
|---|---|
Analytics | Kết quả chuyển đổi, ước tính giảm token, trang được chuyển nhiều nhất, user agent gọi nhiều nhất, lý do lỗi, giới hạn nội dung, trang chuyển một phần hoặc thất bại |
Logs | Sự kiện chuyển đổi được lấy mẫu, lọc theo kết quả, lý do lỗi, giới hạn nội dung |
Playground | Yêu cầu bản Markdown của một trang trong zone, so với HTML: xem Markdown, bản xem trước, header, ước tính giảm token |
GraphQL Analytics API | Dataset |
Cloudflare Traces | Span |
Kết quả chuyển đổi được chia thành full, partial (bị cắt do giới hạn), completed_unknown, error và unfinished. Mục Top pages not converted là chỗ nên xem đầu tiên: đó là các trang agent đang nhận bản thiếu hoặc lỗi.
4. Đọc số liệu cho đúng
Cloudflare ghi rõ mấy điểm dễ hiểu nhầm:
- Số đếm là ước tính theo mẫu, không phải đếm từng request.
- Token tiết kiệm được ước tính theo byte (số byte chia 4), không dùng tokenizer thật, và chỉ tính các lần chuyển đổi
full. - User agent là chuỗi do client tự khai, không phải danh tính bot đã xác minh. Muốn biết bot nào thật, đối chiếu với Bot Management và danh sách verified bots.
fullkhông có nghĩa là giữ nguyên 100% HTML; nó chỉ có nghĩa là không chạm giới hạn nội dung.
Vì vậy, nên dùng các con số này để so sánh xu hướng và tìm trang lỗi, không dùng làm số báo cáo chính xác.
5. Checklist cho đội SEO và đội web
- Quyết định chính sách
content-signalở origin trước khi bật. - Thử bật cho một phần site (ví dụ blog, tài liệu) bằng Configuration Rules.
- Dùng Playground kiểm tra vài trang quan trọng: tiêu đề, mô tả, JSON-LD có ra đúng không.
- Sau vài ngày, xem Top pages not converted và Failure reasons để sửa trang lỗi hoặc quá lớn.
- Theo dõi Top user agents cùng với chính sách AI Crawler and Agent access để biết agent nào đang đọc site.
- Nếu cần báo cáo định kỳ, kéo dữ liệu qua GraphQL (lưu ý chỉ giữ 7 ngày).
LionTech hỗ trợ gì?
LionTech là đối tác Cloudflare tại Việt Nam. Chúng tôi có thể hỗ trợ:
- Rà soát website và chọn phần nội dung nên bật Markdown for Agents trước.
- Thiết lập chính sách Content Signals, AI Crawler and Agent access và Bot Management đi cùng nhau.
- Đọc dashboard Markdown for Agents và lập danh sách trang cần sửa.
👉 Liên hệ LionTech để được tư vấn đưa website sẵn sàng cho AI agent trên Cloudflare.
Nguồn: Cloudflare Changelog, "Markdown for Agents analytics and tracing" (9/11/2026); tài liệu Cloudflare "Markdown for Agents".



