An toàn — cái gì ghi, cái gì hỏi trước

Bản nháp trước, công khai sau

• Theme: AI sửa bản nháp theme; khách chỉ thấy khi xuất bản (publish_draft_theme). Xem trước bằng create_theme_preview.
• Trang: trang mới là nháp cho đến khi publish_page.
• Workflow backend: lưu là nháp; route chỉ chạy bản mới sau publish_backend_workflow.
• Những thứ không có bản nháp — redirect, bản dịch, bảng và route backend, tên miền — có hiệu lực ngay khi ghi.

Tool xoá, xuất bản, khôi phục

Tên tool nói nó làm gì: delete_…, remove_…, revoke_…, uninstall_…, publish_…, cùng restore_backup, restore_theme_version, revert_backend_workflow, upgrade_app và graphql_mutation (chạy một mutation bất kỳ). Đó là những thao tác khách thấy ngay hoặc không lấy lại được. Danh sách đầy đủ ở Tool và kỹ năng, cột Loại.

Ai hỏi trước

• Client của bạn quyết định có hỏi bạn trước mỗi lần gọi tool hay không (Claude Code, Cursor… đều có cài đặt duyệt từng tool). Với tool xoá và xuất bản, hãy để client hỏi.
• Máy chủ tự chặn những việc lớn nhất cho đến khi được xác nhận rõ: restore_backup không làm gì khi thiếu confirm: true (khôi phục toàn bộ còn bắt gõ lại tên website); delete_content_type cũng cần confirm: true, vì nó xoá mọi bản ghi của loại đó.
• MCP gọn webmati mcp hỏi lại trước mọi thao tác xoá, xuất bản, khôi phục; còn script webmati exec mặc định chỉ đọc.

Sao lưu trước việc lớn

Trước khi làm lại giao diện, xoá hàng loạt hay sửa backend, bảo AI "sao lưu website trước": nó dùng create_backup rồi chờ xong (kỹ năng shop-backups). Lỡ tay thì "khôi phục website về lúc 10:30".

Khi chính nền tảng có vấn đề

AI gặp lỗi hay giới hạn của nền tảng thì nên nói ra, không lách. Máy chủ chỉ nó cách làm: search_platform_issues trước, rồi vote_platform_issue (+1, kèm ghi chú ngắn) khi lỗi đó đã có người báo, hoặc report_platform_issue khi chưa, và đưa bạn số của báo cáo để theo dõi ở Báo lỗi & góp ý. Tiêu đề và nội dung AI viết là công khai với mọi người đã đăng nhập; nhật ký và lời gọi bị hỏng nằm trong private_context, chỉ bạn và đội nền tảng xem. Máy chủ che bí mật ở cả hai, nhưng hãy dặn AI không bao giờ đưa key hay dữ liệu khách hàng vào báo cáo. Trong script webmati exec, đây là các tool ghi nên cần --allow-writes; bản dựng website tự động không bao giờ có chúng.

Giữ key an toàn

• API key (wmk_…) là chìa khoá của workspace: đừng dán vào chat, đừng commit vào git. Ưu tiên key chỉ đủ quyền cho việc cần làm.

• Thu hồi key bất cứ lúc nào trong Cài đặt ▸ API Keys.

• Ảnh bạn dán vào chat là thứ AI thấy nhưng không gửi được: nó tạo một link tải lên (create_upload_link) để bạn đưa ảnh vào thư viện media.