Aggrega
Aggrega là gì
Aggrega là một trình biên dịch mã nguồn mở cho kiến trúc thời đại AI. Hãy mô tả các thành phần của một ứng dụng và cách chúng kết nối với nhau; Aggrega biến chúng, một cách tất định, thành các tệp triển khai để chạy ứng dụng đó.
- Dùng những ngôn ngữ bạn đã biết. Một trình biên dịch cho những ngôn ngữ bạn đang dùng: đầu vào là YAML; đầu ra là Helm chart, manifest Kubernetes và các tệp Compose, Terraform hoặc CloudFormation.
- Nhà phát triển mô tả, Ops triển khai. Nhà phát triển khai báo các thành phần, các tính năng của chúng và ai dùng ai; đội nền tảng quyết định mỗi thành phần chạy như thế nào và ở đâu.
- Một ứng dụng, nhiều nền tảng. Cùng một ứng dụng chạy trên Docker Compose trên laptop và trên Kubernetes trong production: đổi đích chỉ đổi một ánh xạ, không đổi mã của bạn.
- Tái lập được và có quản trị. Cùng đầu vào, cùng đầu ra, với mọi phụ thuộc được ghim trong lockfile. Các chính sách của bạn cắm vào trình biên dịch và dừng một bản build vi phạm chúng, kèm theo điều cần sửa.
Aggrega trong tiếng Ý có nghĩa là “nó tập hợp lại”: cái tên nói lên điều công cụ làm, đó là tập hợp các phần của một ứng dụng vào một bản mô tả duy nhất.
-
Dán một prompt vào một trợ lý có thể chạy lệnh: trợ lý sẽ cài đặt Aggrega, thêm skill Aggrega và kết nối tới máy chủ MCP của Aggrega, đồng thời hỏi ý kiến bạn trước khi cài đặt bất cứ thứ gì.
-
Cài đặt Aggrega, ghi một ví dụ chạy được vào một thư mục và chạy nó trên máy của bạn, rồi phát triển nó từng bước một: một tác tử AI chạy trên mô hình cục bộ, hoặc một ứng dụng web dùng PostgreSQL.
-
Một lộ trình đi qua tài liệu theo thứ tự đọc, từ mục đích của Aggrega đến tài liệu tham khảo ngôn ngữ.
Cài đặt
Trên Linux và macOS:
curl -fsSL https://aggrega.ai/install.sh | shTrên Windows, trong PowerShell:
irm https://aggrega.ai/install.ps1 | iexLệnh nào cũng cài đặt tệp nhị phân aggrega cho người dùng hiện tại. Cài đặt trình bày những gì lệnh thực hiện, Homebrew, Scoop, winget và tải xuống thủ công; Kết nối máy chủ MCP hướng dẫn kết nối một trợ lý AI. Tiện ích mở rộng Aggrega cho Visual Studio Code mang đến xác thực, điều hướng, hover và tự động hoàn thành cho YAML của Aggrega, dựa trên tệp nhị phân aggrega.
Tài liệu
Tài liệu dành cho người dùng về ngôn ngữ và trình biên dịch Aggrega, được viết bằng tiếng Anh và dịch sang mọi ngôn ngữ khác mà trang web cung cấp. Tài liệu gồm ba phần.
- Kiến trúc — “tại sao” của Aggrega. Tầm nhìn, định vị, mô hình tư duy, pipeline của trình biên dịch ở mức khái niệm, quản trị doanh nghiệp, danh mục, khả năng mở rộng, các lựa chọn thiết kế. Khi đọc lần đầu, hãy đọc theo thứ tự các chương được đánh số từ 01 đến 16.
- Hướng dẫn soạn thảo — “cách bắt tay vào soạn thảo” với Aggrega. Vòng lặp soạn thảo, bốn vai trò cộng tác, bảng ánh xạ kind sang vai trò, và cách kết nối trợ lý AI thông qua máy chủ Model Context Protocol. Hãy bắt đầu với Soạn thảo tệp Aggrega; để trợ lý AI của bạn tự cài đặt và thiết lập Aggrega, hãy dán prompt trong Thiết lập Aggrega bằng trợ lý AI của bạn.
- Tài liệu tham khảo ngôn ngữ — “cái gì” và “cách sử dụng” của Aggrega. Hãy bắt đầu với Trạng thái của ngôn ngữ để biết mức độ sẵn sàng hiện tại, sau đó khi đọc lần đầu hãy đọc theo thứ tự các chương được đánh số từ 01 đến 09. Các thư mục con không đánh số (entities/, vocabulary/, templates/, providers/, plugins/, schema/, cli/, errors/, examples/) là các danh mục tham khảo — hãy chuyển đến các mục cụ thể khi cần.
Giới thiệu về Aggrega
Trình biên dịch Aggrega là mã nguồn mở theo giấy phép Apache-2.0 và sẽ luôn như vậy: sẽ không có phiên bản đóng nào của trình biên dịch, cũng không có mô hình open-core. Mọi tính năng của trình biên dịch sẽ có trong phiên bản mã nguồn mở.
Hệ sinh thái được xây dựng trên bốn trụ cột:
- Mô hình phân tách (lấy cảm hứng từ OAM): Hướng dẫn thiết kế tách ý định của nhà phát triển (“Cái gì” và “Bao nhiêu” trừu tượng) khỏi thực tế vật lý của Platform Ops (“Như thế nào” và “Ở đâu” vật lý). Trình biên dịch không áp đặt sự phân tách này: nó chấp nhận mọi mẫu biên soạn vượt qua xác thực schema.
- DSL ngữ nghĩa & bản thể luận vận hành: Nhà phát triển ánh xạ kiến trúc của họ bằng một tập hợp đóng các nguyên thể đám mây phổ quát (ví dụ:
server,worker,stateful-server) trên nhãn dành riêngcomponent.aggrega.ai/typecủa Aggrega. Mọi ngữ cảnh nâng cao—chẳng hạn như quyền tự chủ của tác tử AI, khả năng tạo sinh hoặc tuân thủ dữ liệu—được xếp lớp lên trên thông qua các nhãn Duck-Typing tĩnh, và một danh mục phân loại các thành phần theo một trục riêng sẽ thêm một khóa nhãn riêng. - Chính sách có thể lập trình & xác thực: Trình biên dịch Go lõi không có quan điểm riêng. Quản trị doanh nghiệp được vận hành hoàn toàn bởi các tiêu chuẩn ngành và WebAssembly có thể cắm thêm: JSON Schema 2020-12 (được viết bằng một cách viết tắt gọn có dạng YAML hoặc JSON Schema YAML đầy đủ) để xác thực danh mục, vai trò
label-transformcủa socket quản trị để gắn thẻ topo động, và các vai trò phán quyết của nó để đánh giá ranh giới bảo mật kiến trúc. - Trình biên dịch AOT & bàn giao thực thi: Một pipeline biên dịch chặt chẽ chuyển DSL thành một đồ thị Biểu diễn Trung gian (IR) không phụ thuộc vào năng lực. IR ghi lại topo của các thành phần và các cạnh
usesgiữa chúng (ai sử dụng ai); trình biên dịch chuyển đồ thị này đến socket quản trị WebAssembly (Wasm) để phát hiện các lỗ hổng tin cậy bắc cầu, sau đó thực thi các plugin kết xuất Wasm để tạo ra các cấu hình proxy và rào chắn chính xác. Aggrega ghi các tạo phẩm này ra đĩa và bàn giao chúng cho các công cụ khác, như pipeline CI/CD hoặc bộ điều phối thời gian chạy, vốn sẽ triển khai chúng.
Giấy phép
Tài liệu Aggrega được phát hành theo Apache License, Version 2.0; toàn văn có trong tệp LICENSE của kho mã nguồn.