Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Hướng dẫn soạn thảo

Hướng dẫn này là người bạn đồng hành thực hành cho các chương kiến trúc và tài liệu tham khảo ngôn ngữ. Trong khi phần kiến trúc giải thích vì sao Aggrega có hình thái như hiện tại và tài liệu tham khảo quy định ý nghĩa của từng trường, hướng dẫn này dạy cách bắt tay vào viết — dùng thực thể nào, theo thứ tự nào, và CLI cùng một trợ lý AI giúp bạn có được một tệp đúng với ít trở ngại nhất như thế nào.

Hướng dẫn được viết cho hai đối tượng cùng lúc: một người viết thủ công trong trình soạn thảo, và một trợ lý AI viết thay cho một người thông qua máy chủ Model Context Protocol. Cả hai đều theo cùng một vòng lặp và đọc cùng các bề mặt tham khảo, nên các trang dưới đây phục vụ cả hai.

Đọc theo thứ tự này

  1. Viết tệp Aggrega — vòng lặp viết từ đầu đến cuối: chọn vai trò, tìm hiểu hình dạng, tạo khung, điền nội dung, xác thực, build. Hãy bắt đầu từ đây.
  2. Các persona — bốn vai trò viết cộng tác với nhau (developer, kiến trúc sư, vận hành, operator) và cách tiếp cận “hướng dẫn, không cưỡng chế” đằng sau chúng.
  3. Thực thể theo vai trò — mỗi loại thực thể được ánh xạ tới vai trò thường sở hữu nó, để bạn biết mỗi mối quan tâm thuộc về tệp nào.
  4. Cài đặt — cài đặt tệp nhị phân aggrega, với các lệnh ở đầu trang; phần kết nối của trang trỏ tới Kết nối máy chủ MCP.
  5. Dùng Aggrega trong Visual Studio Code — tiện ích mở rộng Aggrega cho Visual Studio Code: những gì nó cần, trang chào mừng, các bảng điều khiển và đồ thị topology, cùng mọi thiết lập và lệnh.

Nhập bắt đầu từ một dự án bạn đã có ở định dạng khác và soạn bản nháp của các tệp này từ đó, để bạn xem xét và dựng.

Tìm hiểu Aggrega đặt hướng dẫn này vào một lộ trình đi qua toàn bộ tài liệu.

Làm việc với trợ lý AI

  1. Thiết lập Aggrega với trợ lý AI của bạn — một prompt để dán vào một trợ lý có thể chạy lệnh, để nó cài đặt Aggrega, thêm kỹ năng Aggrega và tự kết nối với máy chủ.
  2. Kết nối máy chủ MCP — mục máy chủ cho từng client, nơi mỗi client lưu mục đó, máy chủ được truy cập qua HTTPS, và cách kiểm tra kết nối.
  3. Kỹ năng Aggrega — các chỉ dẫn mà trợ lý tải cho Aggrega: cách cài đặt và giữ cho chúng luôn cập nhật.
  4. Những gì trợ lý của bạn có thể làm với Aggrega — những gì máy chủ đã kết nối cho phép trợ lý đọc, kiểm tra, build và xuất bản.

Các bề mặt của trợ lý liên quan thế nào tới hướng dẫn này

Máy chủ aggrega mcp cung cấp hướng dẫn này, tài liệu tham khảo ngôn ngữ và các JSON Schema dưới dạng tài nguyên mà trợ lý đọc trước khi viết YAML, cùng với các công cụ tạo khung và xác thực thực thể. Các prompt viết tích hợp sẵn của trợ lý trỏ ngược về các trang này thay vì nhắc lại chúng, nên hướng dẫn này là nơi duy nhất trình bày bằng văn xuôi phương pháp viết. Xem Viết tệp Aggrega để biết vòng lặp và Kết nối máy chủ MCP để biết cách kết nối.