# Aggrega

> Aggrega to kompilator open source do infrastruktury jako kodu: jeden opis aplikacji w YAML staje się plikami Kubernetes, Helm, Compose, Terraform lub CloudFormation, które przeglądasz i które należą do Ciebie.

URL: https://aggrega.ai/pl/

## Opisz architekturę raz. Otrzymaj kod infrastruktury dla każdej używanej platformy.

Aggrega to kompilator open source do infrastruktury jako kodu: jeden opis aplikacji w YAML staje się plikami **Kubernetes**, **Helm**, **Compose**, **Terraform** lub **CloudFormation**, które przeglądasz i które należą do Ciebie.

Masz już agenta zbudowanego w **LangGraph**, **CrewAI**, **n8n**, **Dify** lub innych narzędziach? Zaimportuj go.

[Skonfiguruj z pomocą asystenta AI](https://aggrega.ai/pl/#ai-assistant)[Szybki start](https://aggrega.ai/docs/pl/getting-started/)[Zaimportuj projekt](https://aggrega.ai/pl/#import)

Linux i macOS

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

Windows, w PowerShell

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

Dwa przykłady z szybkiego startu, budowane krok po kroku: agent AI na lokalnym modelu i aplikacja webowa z PostgreSQL. Każdy krok pokazuje zmieniane pliki z dodanymi wierszami, polecenie aggrega build i pliki zapisywane przez kompilację.

### Współpracuje z Twoim asystentem AI

Wystarczy wkleić ten prompt do asystenta, który może uruchamiać polecenia, a zainstaluje on Aggrega, doda sobie umiejętność Aggrega i połączy się z serwerem MCP Aggrega. Prompt każe mu zapytać o zgodę, zanim cokolwiek zainstaluje.

Prompt

Skonfiguruj dla mnie Aggrega krok po kroku i przy każdym kroku powiedz mi, co zostało uruchomione.

1. Uruchom `aggrega version`. Jeśli polecenie nie zostanie znalezione, zapytaj mnie o zgodę przed instalacją Aggrega, a potem zainstaluj Aggrega dla mojego użytkownika za pomocą oficjalnego instalatora: w systemie Linux lub macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, w systemie Windows w PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Ponownie uruchom `aggrega version`. Jeśli instalator wypisał wiersz do dodania do mojej zmiennej `PATH`, pokaż mi go.

2. Jeśli strona `https://aggrega.ai/docs/ai-assistants/skill/` podaje sposób zainstalowania u ciebie wtyczki Aggrega, zapytaj mnie, zanim ją zainstalujesz, a następnie zainstaluj ją w ten sposób albo powiedz mi, co mam zrobić, jeśli jest to krok, który wykonuję w twoim interfejsie. Wtyczka dodaje umiejętność Aggrega i łączy cię z serwerem MCP Aggrega. W przeciwnym razie uruchom `aggrega skills install --help` i znajdź swój identyfikator na liście, którą wypisze. Zapytaj mnie, czy chcę mieć umiejętność w tym projekcie, czy we wszystkich projektach, a następnie uruchom `aggrega skills install --agent <your identifier>`, dodając `--global` dla wszystkich projektów. Jeśli nie ma cię na liście, pomiń instalację umiejętności i poinformuj mnie o tym.

3. Jeśli wtyczka została zainstalowana, masz już połączenie z serwerem MCP Aggrega. W przeciwnym razie połącz się z serwerem MCP Aggrega, czyli poleceniem `aggrega mcp`, w taki sposób, w jaki dodajesz serwer MCP, zgodnie z opisem przeznaczonym dla ciebie na stronie `https://aggrega.ai/docs/ai-assistants/mcp-server/`. Jeśli do załadowania wtyczki lub serwera potrzebujesz ponownego uruchomienia lub przeładowania, powiedz mi, co mam zrobić.

4. Po połączeniu wywołaj narzędzie `describe-capabilities` bez argumentów i podsumuj to, co wymienia.

**Pokaż cały prompt**

- **Umiejętność** — Wyjaśnia asystentowi, jak przebiega pętla tworzenia, i nakazuje mu brać każdą odpowiedź dotyczącą schematu lub pliku z pliku binarnego aggrega.

- **Serwer MCP** — aggrega mcp udostępnia asystentowi narzędzia Aggrega: scaffold, validate, build i pozostałe.

[Co się zmienia w zależności od asystenta](https://aggrega.ai/docs/pl/ai-assistants/set-up/)

### Jak to działa

Ty opisujesz aplikację, Aggrega zapisuje pliki, a narzędzia, których już używasz, je wdrażają. Aggrega nigdy nie łączy się z działającym klastrem ani z kontem w chmurze.

Aggregate opisuje aplikację

Release ustawienia jednego środowiska

Manifest jak budowana jest każda część

aggrega build te same dane wejściowe, te same pliki

- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation

pliki, które przeglądasz i które należą do Ciebie

Poza Aggrega

ArgoCD · Flux · Terraform wdrażają to, co zostało zapisane

Aggrega kończy pracę na plikach. Nigdy nie łączy się z działającym klastrem ani z kontem w chmurze; to, co zapisała, wdrażają Twoje własne narzędzia.

#### Opisz aplikację

Encja **Aggregate** wymienia swoje **komponenty** i sposób ich połączenia.

#### Wybierz środowisko

Encja **Release** uzupełnia ustawienia tego środowiska.

#### Wybierz, jak budowana jest każda część

Encja **Manifest** przypisuje każdy komponent do encji **Recipe** dla używanej platformy, na przykład do chartu Helm, modułu Terraform lub kontenera.

#### Uruchom aggrega build

Polecenie zapisuje pliki dla każdej platformy: za każdym razem **te same pliki** dla tych samych danych wejściowych.

#### Wdróż własnymi narzędziami

To, co zostało zapisane, wdrażają **ArgoCD**, **Flux** lub **Terraform**.

### Co można zbudować

Zacznij od przykładu gotowego do uruchomienia lub od komponentów z katalogu.

#### Agenci AI i bramy

Agenci zbudowani w LangGraph, CrewAI, LlamaIndex, Dify, n8n i innych, za bramami modeli z budżetami tokenów, buforowaniem semantycznym, maskowaniem logów i osłoną przed wstrzykiwaniem promptów.

[Agent za bramą z budżetem tokenów](https://aggrega.ai/docs/pl/language-reference/examples/envoy-ai-gateway-token-budget/)

#### Tradycyjne obciążenia robocze

Bazy danych, pamięci podręczne, brokery komunikatów i zarządzanie tożsamością, na przykład PostgreSQL, MariaDB, Redis, Kafka i Keycloak.

[Jedna baza danych PostgreSQL wdrożona na trzy sposoby](https://aggrega.ai/docs/pl/language-reference/examples/postgres-three-realizations/)

#### Features

Możliwości, które dołącza się osobno dla każdego środowiska bez ingerencji w aplikację, na przykład ochrona przed prompt injection, maskowanie danych wrażliwych, ingress HTTPS, monitorowanie i kopie zapasowe.

[Brama, która sprawdza każde żądanie pod kątem prompt injection](https://aggrega.ai/docs/pl/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### Jedna aplikacja, wiele platform

Ta sama encja Aggregate jest budowana dla Docker Compose na laptopie i dla Kubernetes w środowisku produkcyjnym: zmiana celu zmienia mapowanie, a nie Twój kod.

[Jedna encja Aggregate, zbudowana dla Compose i Kubernetes](https://aggrega.ai/docs/pl/language-reference/examples/mariadb-adminer/)

aggregate.yaml napisane raz

Na laptopie

release-compose.yaml

manifest-compose.yaml

aggrega build

docker-compose.yaml

W klastrze Kubernetes

release-helm-synth.yaml

manifest-helm-synth.yaml

aggrega build

manifesty Kubernetes

Każda platforma jest budowana z własnych encji Release i Manifest. Encja Aggregate, która opisuje aplikację, pozostaje bez zmian.

#### Nadzór i polityki

Własne polityki podłącza się do kompilatora: zatrzymują one budowanie, które je narusza, i wskazują, co należy poprawić.

[Jedna polityka, sprawdzana dla czterech celów](https://aggrega.ai/docs/pl/language-reference/examples/policy-render-verdict/)

aggrega build

Twoja polityka podłączona do kompilatora

powodzenie

pliki zapisane gotowe do przeglądu i wdrożenia

niepowodzenie

budowanie zatrzymane policy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted

Polityka może zatrzymać budowanie i wskazać, co należy poprawić. Nigdy nie zmienia plików po to, aby przeszły kontrolę.

#### Powtarzalne budowanie

Te same dane wejściowe, ten sam wynik, a każda zależność przypięta w pliku lockfile.

[Zbuduj przykład i jego plik lockfile](https://aggrega.ai/docs/pl/language-reference/examples/ai-agent-and-model-router/#building)

#### Katalog biblioteki standardowej

Components dla agentów, modeli, bram, magazynów danych, komunikacji, obserwowalności, bezpieczeństwa i przechowywania danych, gotowe do użycia w encji Aggregate.

[Przeglądaj katalog](https://aggrega.ai/catalog/pl/browse)

### Twój asystent z Aggrega

Co zyskuje asystent piszący kod infrastruktury, gdy pracuje za pośrednictwem Aggrega.

- **Powtarzalność** — Te same dane wejściowe, te same pliki, a każda zależność jest przypięta w pliku blokady.

- **Jeden opis** — Jeden opis aplikacji, budowany dla każdej platformy, na której ona działa.

- **Polityki w czasie budowania** — Własne polityki działają w kompilatorze i zatrzymują budowanie, które je narusza.

- **Podpisany, wersjonowany katalog** — To, co asystent pobiera z katalogu, jest wersjonowane i podpisane, a pobieranie weryfikuje każdy podpis.

- **Sprawdzane przez kompilator** — Asystent waliduje i buduje za pomocą pliku binarnego aggrega i to z niego czerpie odpowiedzi na temat schematów i plików.

### Cele

Każda platforma otrzymuje pliki, które odczytuje natywnie. Agenci AI działają w każdym klastrze Kubernetes, a wielu z nich także w Compose.

- **Kubernetes** — Manifesty Kubernetes, jeden plik na zasób, do zastosowania przez ArgoCD lub Flux.

- **Helm** — Charty Helm, renderowane do manifestów Kubernetes.

- **Compose** — Plik Docker Compose, do uruchamiania aplikacji na laptopie.

- **Terraform** — Konfiguracja zarządzanych usług chmurowych. Aggrega nigdy nie uruchamia Terraform.

- **CloudFormation** — Szablony stosów dla AWS. Aggrega nigdy nie uruchamia CloudFormation.

[Co zapisuje każdy cel](https://aggrega.ai/docs/pl/language-reference/providers/reference-matrix/)

### Import

aggrega import odczytuje projekt w jednym z tych formatów i zapisuje robocze pliki Aggrega do przejrzenia i edycji.

- LangGraph
- CrewAI
- n8n
- Dify
- Langflow
- Flowise
- Google ADK
- Microsoft Agent Framework
- MCP client configurations
- Compose

aggrega import

robocze pliki Aggrega do przejrzenia i edycji

Na wejściu istniejący projekt, na wyjściu robocze pliki Aggrega. Nic nie jest wdrażane; najpierw przeglądasz wersje robocze.

[Jak działa import](https://aggrega.ai/docs/pl/authoring/import/)

### Rozpocznij

#### Szybki start

Zainstaluj Aggrega, zbuduj przykład gotowy do uruchomienia, uruchom go na swoim komputerze, a potem rozbudowuj go krok po kroku.

[Pierwsze kroki](https://aggrega.ai/docs/pl/getting-started/)

#### Uruchom pierwszy przykład

Każdy przykład gotowy do uruchomienia to kompletny obszar roboczy, który buduje się za pomocą CLI aggrega.

[Przeglądaj przykłady](https://aggrega.ai/docs/pl/language-reference/examples/)

#### Instalacja

Jedno polecenie instaluje plik binarny aggrega dla Twojego konta użytkownika, bez uprawnień administratora.

[Zainstaluj plik binarny](https://aggrega.ai/docs/pl/install/#install-the-binary)

### Open source

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.

#### Kompilator

Plik binarny aggrega i jego interfejs wiersza poleceń.

[aggrega-ai/aggrega-cli na GitHubie](https://github.com/aggrega-ai/aggrega-cli)

#### Visual Studio Code

Walidacja, nawigacja, podpowiedzi po najechaniu i uzupełnianie dla YAML Aggrega, oparte na pliku binarnym aggrega.

[Rozszerzenie na GitHubie](https://github.com/aggrega-ai/aggrega-vscode-extension)
