Cách xây dựng và xuất bản trang web với Paperclip Agents25 min read

Paperclip điều phối một nhóm trang web AI; nó không phải là máy chủ công cộng của trang web. Sử dụng nó để chia nhỏ bản tóm tắt, phân công công việc có trách nhiệm, thu thập bằng chứng QA và phê duyệt lộ trình. Sau đó triển khai mã đã được đánh giá thông qua nhà cung cấp dịch vụ lưu trữ hoặc xuất bản rõ ràng một tạo phẩm ứng dụng phù hợp thông qua AgentGrid.io. Nhiệm vụ chuyển sang Hoàn thành không phải là nhiệm vụ triển khai công khai.

Hãy xem xét một trang web giới thiệu sản phẩm gồm ba trang với trang chủ, trang tính năng và lộ trình liên hệ. Nhà thiết kế, lập trình viên, nhân viên QA và người đánh giá tiếp thị chỉ có thể làm việc song song khi họ chia sẻ các tiêu chí chấp nhận và biết bản sửa đổi nào đang được xem xét. Hướng dẫn này chỉ ra cách cấu trúc quá trình chuyển giao đó mà không coi việc điều phối tác nhân như một công cụ xây dựng trang web chỉ bằng một cú nhấp chuột kỳ diệu.

Cách xuất bản trang web bằng Kẹp giấy và AgentGrid.io

Kẹp giấy có thể sắp xếp công việc của nhân viên dưới dạng nhiệm vụ và theo dõi kết quả đầu ra dưới dạng tạo phẩm. AgentGrid.io có thể là nơi riêng biệt nơi trang web hoặc tài liệu kết quả được kiểm tra và xuất bản nếu được phê duyệt. Không thu gọn các vai trò đó: tác vụ Kẹp giấy hoặc bản ghi tạo phẩm của nó không tự động là một tạo phẩm AgentGrid và các sản phẩm này không được mô tả là có kết nối gốc nếu không có tích hợp đã được xác minh.

1. Tạo không gian làm việc đích trước

Trong AgentGrid, tạo hoặc chọn không gian làm việc cho nhóm sẽ xem xét kết quả đầu ra. Kiểm tra tư cách thành viên nhóm trước khi mời bất cứ ai. Bạn có thể giữ tác nhân của Paperclip trên đường dẫn thực thi hiện có của nó và để một người chuyển giao sản phẩm. Lời mời đại lý của AgentGrid là một lộ trình tùy chọn cho một trợ lý tương thích, được cấu hình có chủ ý, không phải là bằng chứng cho thấy danh sách đại lý hoặc chuỗi phê duyệt của Paperclip sẽ xuất hiện trong AgentGrid. Nếu bạn mời một đại lý, hãy sử dụng hướng dẫn mời AgentGrid và bỏ chọn các khả năng Chia sẻ và Xuất bản không cần thiết trước khi gửi liên kết một lần.

Trong Paperclip, hãy đưa ra bản tóm tắt chấp nhận chặt chẽ cho bài tập: khái niệm về trang đích, các phần bắt buộc, liên kết nguồn cho các tuyên bố thực tế và người đánh giá có tên là con người. Giữ trạng thái nội bộ của bài tập khác biệt với quyền xuất bản. Nhiệm vụ được đánh dấu là hoàn thành có nghĩa là công việc được yêu cầu đã được giao để kiểm tra, chứ không phải việc phát hành công khai được cho phép.

2. Chuyển sản lượng thực tế

Khi tác nhân đã hoàn tất, hãy kiểm tra các tập tin hoặc văn bản tạo tác mà nó tạo ra. Đối với một trang web nhỏ, hãy đóng gói các tệp có liên quan dưới dạng ZIP và sử dụng tính năng nhập ZIP của AgentGrid. Đối với báo cáo văn bản, hãy nhập tài liệu được hỗ trợ hoặc tạo tài liệu mới. Đặt tên cho nó để người đánh giá có thể kết nối nó với bài tập Kẹp giấy và kèm theo một ghi chú ngắn về những gì đã sẵn sàng, những gì là tạm thời và nơi chứa các tài liệu nguồn. Xác minh bản xem trước AgentGrid thay vì giả sử các tệp được hiển thị chính xác như trong môi trường của tác nhân.

3. Tách biệt việc xem xét nhiệm vụ với việc xem xét bản phát hành

Sử dụng Kẹp giấy để theo dõi bài tập và trạng thái của nó. Yêu cầu bên liên quan tự kiểm tra tạo phẩm AgentGrid và để lại nhận xét về nội dung, liên kết, khả năng truy cập và bất kỳ khiếu nại nào từ bên ngoài. AgentGrid hỗ trợ các nhận xét giả tạo, do đó phản hồi hữu ích có thể đề cập đến nội dung sẽ được xuất bản. Kết hợp các sửa đổi và kiểm tra bản xem trước mới. Nếu phạm vi nhiệm vụ thay đổi, hãy cập nhật nhiệm vụ Kẹp giấy, nhưng không coi việc phê duyệt trong một trong hai công cụ là sự đồng bộ kỳ diệu với công cụ kia.

4. Xuất bản phiên bản đã kiểm tra

Chỉ sau khi chủ sở hữu con người cho phép phát hành công khai, hãy sử dụng quy trình xuất bản của AgentGrid. Mở trang kết quả với tư cách khách truy cập và so sánh nó với tạo phẩm đã được phê duyệt. AgentGrid phân biệt tạo phẩm không gian làm việc có thể chỉnh sửa với triển khai công khai; những thay đổi tiếp theo yêu cầu một hành động xuất bản khác. Ghi lại URL công khai trong tác vụ Kẹp giấy dưới dạng ghi chú bàn giao nếu quy trình của bạn yêu cầu nó mà không cần yêu cầu tích hợp tự động hoặc cầu phê duyệt ẩn.

Cung cấp cho nhóm một mục tiêu về trang web, không phải một hướng dẫn mơ hồ

Bắt đầu với một bản tóm tắt hẹp: đối tượng, mục tiêu chuyển đổi, các trang bắt buộc, tài liệu tham khảo trực quan, chủ sở hữu nội dung, kỳ vọng về khả năng truy cập và đích đến tên miền hoặc máy chủ lưu trữ. Đối với bản phát hành đầu tiên, hãy chỉ định bố cục đáp ứng, siêu dữ liệu, lộ trình liên hệ đang hoạt động và những nội dung nằm ngoài phạm vi.

Trong Paperclip, tạo dự án và mục tiêu, sau đó chia công việc thành các nhiệm vụ riêng. Mô hình nhiệm vụ của nó hỗ trợ một chủ sở hữu chịu trách nhiệm duy nhất, chặn các mối quan hệ, chuỗi và các giai đoạn xem xét. Chỉ định một chiến lược gia hoặc nhân viên PM để lập kế hoạch, một nhà thiết kế để đưa ra định hướng trực quan, một nhân viên mã hóa để triển khai, một nhân viên QA để kiểm tra và một con người để phê duyệt việc khởi chạy. Đây là những vai trò bạn định cấu hình, không phải là người xây dựng trang web đóng gói sẵn. Của riêng cái kẹp giấy ví dụ về nhóm trang web hiển thị các trang tính năng, QA bị chặn do triển khai và quá trình triển khai xem trước đang được tiến hành trong quá trình xem xét.

Gợi ý lập kế hoạch: “Lập kế hoạch một trang web ba trang cho [khán giả] giúp khách truy cập [mục tiêu]. Tạo sơ đồ trang web, tiêu chí chấp nhận cấp trang, khoảng trống nội dung, yêu cầu hình ảnh và bản đồ phụ thuộc nhiệm vụ. Không triển khai bất cứ điều gì. Chỉ định mỗi chủ sở hữu có thể phân phối và xác định các quyết định mà con người phải đưa ra.”

Xác định hợp đồng phát hành trước khi giao đại lý

Đặt đối tượng, chuyển đổi chính, bản sao được phê duyệt, khoảng không quảng cáo trên trang, nội dung hình ảnh, điểm dừng bắt buộc, máy chủ mục tiêu và chủ sở hữu khởi chạy. Bao gồm các mục tiêu không rõ ràng, chẳng hạn như không thanh toán hoặc tạo tài khoản trong phiên bản một. Cung cấp cho mỗi trang một tiêu chí chấp nhận có thể đo lường được: trang tính năng giải thích ưu đãi, liên kết liên hệ đến đích đang hoạt động và mỗi tuyến đường đều có tiêu đề có ý nghĩa.

Giữ nguồn, thiết kế và bằng chứng cùng nhau

Cung cấp cho người xây dựng một kho lưu trữ hoặc vị trí dự án được chia sẻ. Nhà thiết kế cung cấp thông số và nội dung bố cục; người lập trình thực hiện theo cùng một bản tóm tắt. Một nhận xét nhiệm vụ phải liên kết đến nhánh, kéo yêu cầu, xem trước và kiểm tra kết quả. Kẹp giấy có thể thu thập các kết quả đầu ra được liên kết với nhiệm vụ và xem xét bằng chứng, nhưng phần đính kèm nhiệm vụ không tự động trở thành trang web trực tiếp hoặc kho lưu trữ nguồn chuẩn.

Đặt ranh giới trước khi cấp quyền truy cập. Nếu một tác nhân có thể đẩy mã thông qua danh tính GitHub trong trình bao của nó thì các điều khiển Hỏi trước trên mỗi công cụ của Paperclip không chi phối các lệnh Git trình bao đó. Giới hạn quyền truy cập kho lưu trữ và yêu cầu bảo vệ nhánh cũng như đánh giá PR trên GitHub. Đối với trình kết nối triển khai, hãy phân biệt việc đọc nhật ký bản dựng với việc bắt đầu triển khai sản xuất; Hướng dẫn Netlify của Paperclip khuyến nghị Hỏi trước hoặc Tắt để biết các thay đổi về triển khai và cấu hình. Loại bỏ thông tin đăng nhập khỏi nguồn trang web và chỉ cấp cho mỗi tác nhân quyền truy cập mà nhiệm vụ của nó yêu cầu.

Xây dựng lời nhắc: “Triển khai sơ đồ trang web đã được phê duyệt trong [kho lưu trữ]. Giữ nguyên thiết kế đã thống nhất, thực hiện chức năng điều hướng và biểu mẫu, đồng thời thêm siêu dữ liệu tiêu đề và mô tả vào mỗi trang. Làm việc trên một nhánh, chạy kiểm tra dự án, đính kèm PR và URL xem trước vào tác vụ Kẹp giấy và dừng trước bất kỳ hoạt động triển khai sản xuất nào.”

Tách biệt trạng thái vấn đề, kiểm soát nguồn và xuất bản

Kẹp giấy ghi lại ai là người sở hữu từng số phát hành và bằng chứng nào đi kèm với việc chuyển giao. Kho lưu trữ của bạn vẫn duy trì quá trình triển khai và nhà cung cấp dịch vụ lưu trữ sẽ điều hành trang web đã triển khai. Liên kết từng vấn đề với nhánh chính xác, PR, xem trước, nhật ký kiểm tra và ảnh chụp màn hình. Nếu nhiệm vụ chỉ đề cập đến “mới nhất”, người đánh giá có thể vô tình phê duyệt bản xem trước không khớp với nhánh được triển khai cuối cùng.

Hãy xem xét một cổng chứ không phải một thông báo nói rằng ‘có vẻ xong rồi’

Yêu cầu QA mở bản xem trước thực tế trên máy tính để bàn và thiết bị di động. Kiểm tra lời hứa trên màn hình đầu tiên, điều hướng bàn phím, văn bản thay thế, liên kết bị hỏng, hành vi biểu mẫu, tải, lỗi bảng điều khiển và siêu dữ liệu trang. Yêu cầu tiếp thị xác minh các tuyên bố về sản phẩm và CTA. Ghi lại bằng chứng có thể tái tạo. Nếu một biểu mẫu cần phần phụ trợ, hãy gửi bài kiểm tra từ đầu đến cuối.

Chính sách thực thi của Paperclip có thể định tuyến sự cố tới người đánh giá và sau đó là người phê duyệt khi người thực thi cố gắng đánh dấu nhiệm vụ đã hoàn thành. Các thay đổi được yêu cầu sẽ quay trở lại người thực thi ban đầu. Sử dụng giai đoạn phê duyệt của con người để phát hành công khai và chỉ định rằng phê duyệt nhiệm vụ không được phép xuất bản cho đến khi người đánh giá đã kiểm tra bản xem trước cuối cùng và miền mục tiêu.

Lời nhắc của QA: “Kiểm tra bản xem trước dựa trên các tiêu chí chấp nhận trên một khung nhìn hẹp trên thiết bị di động và máy tính để bàn. Trả lại bảng đạt, không đạt, URL bằng chứng hoặc ảnh chụp màn hình và các bước sao chép. Không phê duyệt hoặc triển khai; gửi lại lỗi cho chủ sở hữu triển khai.”

Danh sách kiểm tra chấp nhận thực tế để ra mắt

• Sản phẩm: so sánh lời hứa chính, tuyên bố về giá và đích đến kêu gọi hành động với bản sao đã được phê duyệt.
• chức năng: nhấp vào điều hướng, gửi yêu cầu liên hệ thử nghiệm và kiểm tra đường dẫn thành công hay thất bại.
• Thiết kế đáp ứng: xem xét màn hình hẹp, máy tính để bàn, tràn nội dung, cắt xén hình ảnh và khoảng cách có thể đọc được.
• Khả năng tiếp cận: kiểm tra thứ tự bàn phím, nhãn, văn bản thay thế, tiêu đề ngữ nghĩa và độ tương phản.
• Tìm kiếm và độ tin cậy: xác nhận tiêu đề và mô tả dành riêng cho tuyến đường, liên kết bị hỏng, lỗi bảng điều khiển và tải nội dung sản xuất.

Triển khai bản dựng đã được phê duyệt tới một URL công khai thực tế

Chọn điểm đến sản xuất trước lần đánh giá cuối cùng. Đối với cơ sở mã thông thường, hãy kết nối kho lưu trữ với máy chủ như Netlify hoặc Vercel, kiểm tra cài đặt bản dựng và biến môi trường của nó, đồng thời để máy chủ tạo bản xem trước trước. Sau khi được con người phê duyệt, hãy quảng bá hoặc triển khai bản sửa đổi đã được đánh giá bằng cách sử dụng quy trình làm việc được ghi lại của máy chủ đó. Mở URL sản xuất khi đăng xuất; kiểm tra điều hướng, biểu mẫu, chứng chỉ, tên miền và bản sửa đổi được triển khai. Chạy Paperclip trên máy chủ chỉ giúp ứng dụng điều phối có thể truy cập được; nó không xuất bản trang web.

Nếu trang web là một tạo phẩm ứng dụng HTML hoặc React phù hợp, AgentGrid.io có thể là nơi chia sẻ nơi mọi người và các đại lý được kết nối chỉnh sửa cùng một phiên bản. Nhập thư mục dự án hoặc ZIP hoặc nhờ một tác nhân được kết nối tạo tạo phẩm trong không gian làm việc dự định. Xem lại ứng dụng được hiển thị và Lịch sử của nó ở đó. Liên kết tạo phẩm là riêng tư đối với những người có quyền truy cập vào không gian làm việc; xuất bản là một hành động riêng biệt, rõ ràng nhằm tạo ra một URL công khai. Một tác nhân được kết nối cần có khả năng xuất bản và yêu cầu xuất bản của con người. Các chỉnh sửa sau đó sẽ không được công khai cho đến khi được xuất bản lại. Miền tùy chỉnh yêu cầu gói trả phí đủ điều kiện và DNS đã được xác minh. Đây là một lộ trình xuất bản thay thế, không phải khẳng định rằng Paperclip tự động tích hợp với AgentGrid.io.

Lời nhắc khởi chạy: “Bản sửa đổi được con người phê duyệt là [phiên bản cam kết hoặc tạo tác]. Triển khai nó tới [máy chủ được chỉ định] hoặc xuất bản [tạo phẩm AgentGrid.io được chỉ định] chỉ sau khi được ủy quyền rõ ràng. Trả lại URL công khai, bản sửa đổi được triển khai, kết quả xây dựng và danh sách kiểm tra khói kiểm tra. Nếu thiếu mục tiêu hoặc quyền, hãy dừng lại và hỏi. “

Khuyến mãi nên đề cập đến một bản sửa đổi cụ thể

Trước khi phát hành, hãy ghi lại phiên bản cam kết hoặc tạo phẩm đã được phê duyệt, máy chủ hoặc không gian làm việc mục tiêu, tên miền và ai có thể bắt đầu xuất bản. Nếu máy chủ tạo URL xem trước, hãy kiểm tra bản xem trước cuối cùng của cùng bản sửa đổi đó trước khi quảng cáo bản đó. Sau đó, mở URL công khai mà không có phiên đặc quyền và lặp lại các bài kiểm tra khói quan trọng. Lưu tham chiếu khôi phục trong trường hợp tuyến liên hệ hoặc nội dung bị hỏng trong cài đặt sản xuất.

Khi nào một nhóm nên sử dụng từng lớp?

Kẹp giấy: hãy chọn nó khi một số tổng đài viên cần các vấn đề được chỉ định, sự phụ thuộc, đánh giá và chủ sở hữu khởi chạy là con người có trách nhiệm. Nó cho nhóm biết phải làm gì và theo dõi công việc thay vì thay thế việc kiểm soát nguồn hoặc máy chủ web.

Kho lưu trữ và máy chủ: chọn đường dẫn này khi trang web cần quy trình phát hành kỹ thuật hiện có, tính năng máy chủ, cài đặt cơ sở hạ tầng hoặc các biện pháp kiểm soát khôi phục đã được thiết lập. Bản ghi cam kết và triển khai được xem xét sẽ xác định phiên bản trực tiếp.

Tiếp tục từ phiên bản đã được phê duyệt

Kẹp giấy sở hữu bài tập và bài đánh giá. Kho lưu trữ và máy chủ của bạn triển khai sản xuất thông thường. AgentGrid.io có thể chứa một tạo phẩm được chia sẻ, được phiên bản và việc xuất bản có chủ ý của nó. Để so sánh quy trình làm việc giữa các tác nhân với trang web khác, hãy xem Hướng dẫn xuất bản Bot Grok; đối với vấn đề chuyển giao đằng sau các tạo phẩm được chia sẻ, hãy đọc phần giới thiệu AgentGrid.io của chúng tôi; và để biết đường dẫn thiết kế đầu tiên, hãy xem xuất bản trang web Thiết kế Claude.

Sẵn sàng để giữ trang web được phê duyệt ở một nơi? Tạo một tạo phẩm AgentGrid.io, mời cộng tác viên tiếp theo có quyền truy cập thích hợp và chỉ xuất bản khi phiên bản công khai đã vượt qua quá trình xem xét.