Có gì mới
Wagtail 8.0 mở preview API v3, một interface mới cho hơn 50 thao tác admin trên page, image, document và các Django model tùy biến. Bản phát hành này cố ý tập trung vào API thay vì thêm nút AI vào giao diện quản trị: team có thể dùng cùng một content model cho thao tác thủ công, script xác định hoặc agent.
API v3 là opt-in. Một cấu hình tối giản có dạng:
INSTALLED_APPS += ["wagtail.api.v3"]
from wagtail.api.v3.urls import api
urlpatterns += [
path("api/v3-preview/", api.urls),
]Đoạn trên chỉ minh họa các thành phần cần bật; dự án thật nên đặt import và URL config theo convention hiện có.
Tính năng chính
- Hơn 50 admin operation cho các đối tượng nội dung phổ biến.
- API được document và có type, kèm OpenAPI schema tự sinh.
- Rich text có thể biểu diễn dưới dạng Markdown, thuận tiện cho client, script và agent.
- Có endpoint cho Django model của dự án, không giới hạn ở model mặc định của Wagtail.
- Public hoặc anonymous access cho nội dung headless.
- Bearer token authentication và permission model của Wagtail cho dữ liệu riêng tư.
Implementation kết hợp type hint, Django Ninja và Pydantic để sinh schema cùng tài liệu API. Với client, OpenAPI schema giúp tạo SDK, validate payload và cho agent biết operation nào tồn tại mà không phải scrape giao diện admin.
CMS với AI, không phải “AI CMS”
Thông điệp chính của Wagtail là tách AI khỏi content management core. API không tự sinh bài viết và admin UI không mặc định xuất hiện các nút lấp lánh. Nếu team muốn dùng agent, v3 API cung cấp boundary để agent đọc hoặc cập nhật nội dung qua curl, CLI hay MCP. Nếu không muốn AI, cùng API vẫn dùng cho script, import và bulk operation xác định.
Cách tiếp cận này giữ quyền kiểm soát ở application layer. Token xác thực, permission, review flow và log có thể được thiết kế quanh từng operation, thay vì trao cho agent quyền thao tác giao diện như một người dùng toàn quyền.
Workflow có thể áp dụng
Wagtail nêu một số trường hợp sử dụng thực tế:
- Publish nhanh bài viết đã được soạn bằng Markdown.
- Báo cáo page chưa publish hoặc image không còn dùng.
- Sửa hàng loạt SEO description qua script.
- Viết content importer giữa các hệ thống với lượng code nhỏ hơn.
- Kết hợp bước tự động và bước review thủ công theo từng loại nội dung.
Dev nên bắt đầu bằng operation có phạm vi hẹp và output dễ review. Ví dụ, agent có thể đề xuất search description rồi tạo bản nháp; người biên tập vẫn duyệt trước khi publish. Với cleanup hoặc import, dry-run và idempotency quan trọng hơn khả năng chat tự nhiên.
Trạng thái preview và cách thử
API v3 được phát hành dưới dạng preview trong Wagtail 8.0 để lấy feedback trước 8.1. Team có thể dùng official bakery demo hoặc bật API trong một project thử nghiệm. Không nên sao chép credential từ demo công khai vào môi trường riêng.
Trước khi đưa vào production, hãy kiểm tra schema change, permission của từng operation, audit log, rate limit và rollback cho bulk update. API mới tạo đúng loại interface cho agent, nhưng chính governance quanh interface mới quyết định hệ thống có an toàn để tự động hóa hay không.