Aggrega
Czym jest Aggrega
Aggrega to kompilator open source dla architektury ery AI. Wystarczy opisać komponenty aplikacji i sposób ich połączenia; Aggrega deterministycznie zamienia je w pliki wdrożeniowe, które uruchamiają aplikację.
- Języki, które już są znane. Kompilator dla języków, których już się używa: na wejściu YAML; na wyjściu charty Helm, manifesty Kubernetes oraz pliki Compose, Terraform lub CloudFormation.
- Programiści opisują, Ops implementuje. Programiści deklarują komponenty, ich funkcje i to, kto używa kogo; zespół platformy decyduje, jak i gdzie działa każdy z nich.
- Jedna aplikacja, wiele platform. Ta sama aplikacja działa w Docker Compose na laptopie i w Kubernetes na produkcji: zmiana celu zmienia mapowanie, a nie kod.
- Odtwarzalność i nadzór. To samo wejście daje to samo wyjście, a każda zależność jest przypięta w lockfile. Własne polityki podłącza się do kompilatora; zatrzymują one build, który je narusza, i wskazują, co poprawić.
Aggrega to po włosku „zbiera w całość”: nazwa mówi, co robi narzędzie, które zbiera części aplikacji w jeden opis.
-
Wystarczy wkleić jeden prompt do asystenta, który może uruchamiać polecenia: zainstaluje on Aggrega, doda umiejętność Aggrega i połączy się z serwerem MCP Aggrega, pytając o zgodę, zanim cokolwiek zainstaluje.
-
Zainstaluj Aggrega, zapisz działający przykład w folderze i uruchom go na swoim komputerze, a potem rozbudowuj go krok po kroku: agent AI na lokalnym modelu albo aplikacja webowa z PostgreSQL.
-
Ścieżka przez dokumentację w kolejności czytania, od tego, do czego służy Aggrega, po dokumentację referencyjną języka.
Instalacja
W systemach Linux i macOS:
curl -fsSL https://aggrega.ai/install.sh | shW systemie Windows, w PowerShell:
irm https://aggrega.ai/install.ps1 | iexKażde z tych poleceń instaluje plik binarny aggrega dla bieżącego użytkownika. Strona Instalacja opisuje, co robi polecenie, Homebrew, Scoop, winget i ręczne pobieranie; strona Połączenie z serwerem MCP opisuje podłączanie asystenta AI. Rozszerzenie Aggrega dla Visual Studio Code zapewnia walidację, nawigację, podpowiedzi po najechaniu i uzupełnianie dla YAML Aggrega, opierając się na pliku binarnym aggrega.
Dokumentacja
Dokumentacja dla użytkowników języka i kompilatora Aggrega, napisana po angielsku i przetłumaczona na wszystkie pozostałe języki dostępne w serwisie. Składa się z trzech części.
- Architektura — „dlaczego” Aggrega. Wizja, pozycjonowanie, model mentalny, potok kompilatora na poziomie koncepcyjnym, ład korporacyjny, katalog, rozszerzalność, decyzje projektowe. Przy pierwszej lekturze należy czytać numerowane rozdziały od 01 do 16 po kolei.
- Przewodnik tworzenia — „jak usiąść i zacząć tworzyć” w Aggrega. Pętla tworzenia, cztery współpracujące role, mapa kindów na role oraz sposób podłączenia asystenta AI przez serwer Model Context Protocol. Należy zacząć od strony Tworzenie plików Aggrega; aby asystent AI sam zainstalował i skonfigurował Aggrega, należy wkleić prompt ze strony Konfiguracja Aggrega z asystentem AI.
- Dokumentacja referencyjna języka — „co” i „jak używać” w Aggrega. Należy zacząć od Stanu języka, aby poznać obecny stan gotowości, a następnie przy pierwszej lekturze czytać numerowane rozdziały od 01 do 09 po kolei. Nienumerowane podkatalogi (entities/, vocabulary/, templates/, providers/, plugins/, schema/, cli/, errors/, examples/) to katalogi referencyjne — można przechodzić do konkretnych pozycji w razie potrzeby.
O Aggrega
Kompilator Aggrega jest oprogramowaniem open source na licencji Apache-2.0 i takim pozostanie: nie będzie zamkniętej edycji kompilatora ani modelu open-core. Wszystkie funkcje kompilatora będą dostępne w wersji open source.
Ekosystem opiera się na czterech filarach:
- Model separacji (inspirowany OAM): wskazówki projektowe, które oddzielają intencję programisty (abstrakcyjne „Co” i „Ile”) od fizycznej rzeczywistości Platform Ops (fizycznego „Jak” i „Gdzie”). Kompilator nie wymusza tego podziału: akceptuje każdy wzorzec tworzenia, który przechodzi walidację schematu.
- Semantyczny DSL & ontologia operacyjna: programiści odwzorowują swoją architekturę za pomocą zamkniętego zbioru uniwersalnych prymitywów chmurowych (np.
server,worker,stateful-server) na zarezerwowanej etykiecie Aggregacomponent.aggrega.ai/type. Cały zaawansowany kontekst—taki jak autonomia agentów AI, możliwości generatywne czy zgodność danych z przepisami—jest nakładany warstwowo za pomocą statycznych etykiet Duck-Typing, a katalog klasyfikujący komponenty według własnej osi dodaje własny klucz etykiety. - Programowalne polityki & walidacja: rdzeniowy kompilator Go jest bez własnego zdania. Ład korporacyjny opiera się w całości na standardach branżowych i podłączalnym WebAssembly: JSON Schema 2020-12 (pisanym w zwartej skróconej notacji o kształcie YAML lub w pełnym JSON Schema YAML) do walidacji katalogu, roli
label-transformgniazda zarządczego do dynamicznego tagowania topologii oraz jego rolach werdyktu do oceny architektonicznych granic bezpieczeństwa. - Kompilator AOT & przekazanie do wykonania: rygorystyczny potok kompilacji tłumaczy DSL na graf reprezentacji pośredniej (IR) agnostyczny wobec możliwości. IR odwzorowuje topologię komponentów i krawędzie
usesmiędzy nimi (kto używa kogo); kompilator przekazuje ten graf do gniazda zarządczego WebAssembly (Wasm) w celu wykrycia przechodnich podatności zaufania, a następnie uruchamia wtyczki renderujące Wasm, aby wygenerować precyzyjne konfiguracje proxy i zabezpieczeń. Aggrega zapisuje te artefakty na dysku i przekazuje je innym narzędziom, takim jak potoki CI/CD lub orkiestratory środowiska uruchomieniowego, które je wdrażają.
Licencja
Dokumentacja Aggrega jest udostępniana na licencji Apache License, Version 2.0; pełny tekst znajduje się w pliku LICENSE w jej repozytorium.