Vì sao chúng tôi chuyển bối cảnh thương hiệu của Brew từ object cứng nhắc sang tài liệu chỉnh sửa được, giải thích cả lựa chọn thiết kế lẫn giá trị chính xác.
Mã hex cho agent email biết nên dùng màu xanh nào. Nhưng nó không cho agent biết vì sao một thương hiệu đặt một nhãn nhỏ kiểu chữ monospace phía trên mọi dòng tiêu đề, hay vì sao đường phân cách của thương hiệu đó là những nét mảnh thay vì các khung.
Đó là vấn đề của mô hình thương hiệu đầu tiên mà chúng tôi xây dựng tại Brew. Chúng tôi ghi lại rất nhiều giá trị nhưng vẫn đánh mất những chi tiết giúp một thương hiệu dễ nhận ra.
Khi mới bắt đầu, chúng tôi xem thương hiệu như dữ liệu có cấu trúc. Chúng tôi mô hình hóa màu sắc, kiểu chữ, tư liệu và một tập hợp lớn các thuộc tính phong cách. Một trình thu thập dữ liệu (crawler) điền vào các trường, rồi quy trình tạo email ghép chúng thành ngữ cảnh cho agent email.
Kết quả có thể đúng màu, đúng phông chữ mà trông vẫn chung chung. Mỗi thương hiệu mới lại mang đến một chi tiết mà lược đồ chưa lường trước. Chúng tôi có thể tiếp tục thêm trường, nhưng câu hỏi hữu ích hơn là một nhà thiết kế sẽ giải thích thương hiệu ấy cho người khác như thế nào.
Nhà thiết kế sẽ viết một bản hướng dẫn: giá trị chính xác ở những chỗ cần chính xác, ví dụ ở những chỗ ví dụ giúp ích, và phần diễn giải các quyết định nằm giữa chúng.
Vì vậy, chúng tôi thay đổi thứ mà agent trích xuất cần tạo ra.
Chúng tôi gọi nó là email-design.md. Đây là một tài liệu Markdown có thể chỉnh sửa, mô tả một thương hiệu cụ thể nên xuất hiện trong email như thế nào.
Dưới đây là một ví dụ hư cấu, đã được rút gọn:
# Acme email design
## Voice
Write for engineers who want the setup instructions first.
Use short explanations and name the product action precisely.
## Signature details
- Put a small monospace label above the main headline.
- Use thin dividers between sections, without drop shadows.
- Reserve the accent color for the primary action.
- Use one product screenshot when it explains the task.
## Assets
Use the approved logo URL from the asset list.
Do not invent product images or customer logos.Tài liệu có thể chứa một quy tắc như “chỉ dùng màu nhấn cho một thứ trong mỗi email” ngay bên cạnh giá trị màu chính xác. Quy tắc đó trao cho agent một chỉ dẫn để xử lý những trường hợp mà chúng tôi không thể lường trước từng cái một.
Các chỉ dẫn về thương hiệu đều hiển thị rõ ràng. Mỗi chỉnh sửa trở thành một phần của bản brief tiếp theo.
Markdown hữu ích ở đây vì con người có thể đọc và chỉnh sửa mà không cần một biểu mẫu đặc biệt nào. Các đề mục tạo cấu trúc cho tài liệu, và việc thêm một quy tắc thiết kế mới không đòi hỏi thêm trường mới trong cơ sở dữ liệu. Đó là một lựa chọn định dạng thực tế. Chúng tôi không khẳng định rằng Markdown luôn tốn ít token hơn JSON, hay rằng mọi mô hình đều được huấn luyện chủ yếu trên Markdown.
Website và email có những ràng buộc hiển thị khác nhau. Mức hỗ trợ phông chữ, bố cục và chế độ tối không giống nhau giữa các ứng dụng email. Một thiết kế trông ổn trong bản xem trước trên trình duyệt vẫn cần được kiểm tra trong hộp thư đến.
Vì thế, tài liệu thương hiệu có những hướng dẫn dành riêng cho email: phông chữ dự phòng, chiều rộng vùng chứa, công thức bố cục tương thích với bảng HTML, và các lựa chọn cho nền sáng lẫn nền tối. Những chỉ dẫn đó giúp agent đưa ra quyết định phù hợp; chúng không đảm bảo email hiển thị giống hệt nhau trong mọi ứng dụng email.
Hình ảnh có những yêu cầu khác, nên Brew còn dùng image-style.md cho phần hướng dẫn hình ảnh. Tách bạch rõ hai mối quan tâm này dễ hơn việc bắt một danh sách design token duy nhất mô tả mọi loại phương tiện.
Website đang hoạt động là bằng chứng hữu ích, nhưng không phải lúc nào cũng là nguồn chuẩn. Website có thể chứa một chiến dịch cũ hoặc một thử nghiệm phong cách mà đội ngũ thương hiệu không còn dùng.
Ngoài tên miền, Brew có thể dùng bộ hướng dẫn thương hiệu, logo, hình ảnh và các tư liệu tham khảo khác mà bạn cung cấp. Khi có mâu thuẫn, hướng dẫn thương hiệu bạn tải lên được ưu tiên hơn những gì suy ra từ website. Hãy xem lại tài liệu được tạo ra, nhất là ở những chỗ tư liệu nguồn chưa đầy đủ hoặc thiếu nhất quán.
Tên miền và các tệp đã được duyệt cung cấp những loại bằng chứng khác nhau cho quá trình trích xuất.
Nếu hình dạng nút chưa đúng, hãy sửa chỉ dẫn. Nếu giọng văn quá trang trọng, hãy thay tính từ mơ hồ bằng một câu ví dụ. Một chỉnh sửa như vậy dễ trao đổi hơn nhiều so với một object khổng lồ đầy những trường mà chẳng ai muốn sửa.
Tài liệu đưa trực tiếp vị trí tư liệu đã duyệt, tên sản phẩm và các quyết định thiết kế vào ngữ cảnh tạo email. Điều đó thu hẹp những khoảng trống mà lẽ ra mô hình phải tự đoán. Nhưng nó không loại bỏ được kết quả sai.
Trong quá trình này, chúng tôi cũng thay đổi những phần khác của agent email. Khi chưa có phép so sánh có kiểm soát, tôi sẽ không quy toàn bộ mức cải thiện chất lượng cho riêng định dạng tệp. Khẳng định mà tôi có thể đưa ra hẹp hơn: bản brief thương hiệu dễ kiểm tra, chỉnh sửa và dùng lại hơn.
Email được tạo ra vẫn cần được rà soát về dữ kiện và hình thức. Hãy đối chiếu các khẳng định với bản brief, kiểm tra liên kết và xem kết quả trong hộp thư đến. Hướng dẫn viết brief cho agent email trình bày khâu bàn giao đó.
Máy chủ MCP của Brew hiện đã ra mắt. Một trợ lý AI tương thích có thể làm việc với Brew thông qua các công cụ đã được mô tả trong tài liệu, dùng chung bối cảnh thương hiệu với ứng dụng. Bài thông báo về MCP và tài liệu thiết lập giải thích cách kết nối.
Tôi thích việc các chỉ dẫn thương hiệu có một nơi lưu giữ rõ ràng. Khi một email có gì đó chưa ổn, chúng tôi có thể chỉ vào một câu, sửa nó và thử lại. Đó là một cuộc trao đổi hữu ích hơn so với việc lại yêu cầu mô hình “làm cho email chuẩn thương hiệu hơn” thêm một lần nữa.
