Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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.

  • Praca z asystentem AI

    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.

  • Szybki start

    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.

  • Poznaj Aggrega

    Ś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:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh

W systemie Windows, w PowerShell:

Terminal window
irm https://aggrega.ai/install.ps1 | iex

Każ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:

  1. 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.
  2. 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 Aggrega component.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.
  3. 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-transform gniazda zarządczego do dynamicznego tagowania topologii oraz jego rolach werdyktu do oceny architektonicznych granic bezpieczeństwa.
  4. 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 uses mię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.