# Aggrega

> Aggrega adalah kompiler sumber terbuka untuk infrastruktur sebagai kode: satu deskripsi YAML aplikasi Anda menjadi berkas Kubernetes, Helm, Compose, Terraform atau CloudFormation yang Anda tinjau dan miliki.

URL: https://aggrega.ai/id/

## Deskripsikan arsitektur sekali saja. Dapatkan kode infrastruktur untuk setiap platform yang Anda jalankan.

Aggrega adalah kompiler sumber terbuka untuk infrastruktur sebagai kode: satu deskripsi YAML aplikasi Anda menjadi berkas **Kubernetes**, **Helm**, **Compose**, **Terraform** atau **CloudFormation** yang Anda tinjau dan miliki.

Sudah membangun agen dengan **LangGraph**, **CrewAI**, **n8n**, **Dify**, dan lainnya? Impor saja.

[Siapkan dengan asisten AI Anda](https://aggrega.ai/id/#ai-assistant)[Mulai cepat](https://aggrega.ai/docs/id/getting-started/)[Impor proyek Anda](https://aggrega.ai/id/#import)

Linux dan macOS

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

Windows, di PowerShell

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

Dua contoh mulai cepat, dibangun selangkah demi selangkah: agen AI pada model lokal, dan aplikasi web dengan PostgreSQL. Setiap langkah menampilkan berkas yang diubahnya beserta baris yang ditambahkan, perintah aggrega build, dan berkas yang ditulis oleh build.

### Bekerja dengan asisten AI Anda

Tempelkan prompt ini ke asisten yang dapat menjalankan perintah, dan asisten itu akan menginstal Aggrega, menambahkan skill Aggrega ke dirinya sendiri, dan terhubung ke server MCP Aggrega. Prompt tersebut membuat asisten bertanya kepada Anda sebelum menginstal apa pun.

Prompt

Siapkan Aggrega untuk saya, selangkah demi selangkah, dan beri tahu saya apa yang Anda jalankan di setiap langkah.

1. Jalankan `aggrega version`. Jika perintah tidak ditemukan, tanyakan kepada saya sebelum Anda menginstal Aggrega, lalu instal untuk pengguna saya dengan installer resmi: di Linux atau macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, di Windows dalam PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Jalankan `aggrega version` lagi. Jika installer mencetak baris yang perlu ditambahkan ke `PATH` saya, tunjukkan baris itu kepada saya.

2. Jika `https://aggrega.ai/docs/ai-assistants/skill/` memberikan cara untuk menginstal plugin Aggrega di dalam diri Anda, tanyakan kepada saya sebelum Anda menginstalnya, lalu instal dengan cara tersebut, atau beri tahu saya apa yang harus dilakukan jika itu adalah langkah yang saya lakukan di antarmuka Anda. Plugin ini menambahkan skill Aggrega dan menghubungkan Anda ke server MCP Aggrega. Jika tidak, jalankan `aggrega skills install --help` dan temukan pengenal Anda sendiri dalam daftar yang dicetaknya. Tanyakan kepada saya apakah saya menginginkan skill ini di proyek ini atau di setiap proyek, lalu jalankan `aggrega skills install --agent <your identifier>`, dengan menambahkan `--global` untuk setiap proyek. Jika Anda tidak ada dalam daftar, lewati instalasi skill dan beri tahu saya.

3. Jika Anda sudah menginstal plugin tersebut, Anda sudah terhubung ke server MCP Aggrega. Jika tidak, hubungkan diri Anda ke server MCP Aggrega, yaitu perintah `aggrega mcp`, dengan cara Anda biasa menambahkan server MCP, seperti yang dijelaskan `https://aggrega.ai/docs/ai-assistants/mcp-server/` untuk Anda. Jika Anda memerlukan restart atau reload untuk memuat plugin atau server tersebut, beri tahu saya apa yang harus dilakukan.

4. Setelah Anda terhubung, panggil tool `describe-capabilities` tanpa argumen dan rangkum apa yang dicantumkannya.

**Tampilkan seluruh prompt**

- **Skill** — Memberi tahu asisten bagaimana siklus penulisan berjalan, dan agar mengambil setiap jawaban tentang skema atau berkas dari binary aggrega.

- **Server MCP** — aggrega mcp memberi asisten alat-alat Aggrega: scaffold, validate, build dan lainnya.

[Apa yang berbeda dari satu asisten ke asisten lain](https://aggrega.ai/docs/id/ai-assistants/set-up/)

### Cara kerjanya

Anda mendeskripsikan aplikasi, Aggrega menulis berkasnya, dan alat yang sudah Anda gunakan melakukan deploy berkas tersebut. Aggrega tidak pernah mengakses klaster yang sedang berjalan atau akun cloud.

Aggregate menjelaskan aplikasi Anda

Release pengaturan satu lingkungan

Manifest cara setiap bagian dibangun

aggrega build input sama, file sama

- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation

file yang Anda tinjau dan miliki

Di luar Aggrega

ArgoCD · Flux · Terraform melakukan deploy atas apa yang ditulisnya

Aggrega berhenti pada file. Aggrega tidak pernah menjangkau klaster yang sedang berjalan atau akun cloud; alat Anda sendiri yang melakukan deploy atas apa yang ditulisnya.

#### Deskripsikan aplikasi

Sebuah **Aggregate** menyebutkan **komponen-komponennya** dan cara komponen tersebut saling terhubung.

#### Pilih lingkungan

Sebuah **Release** mengisi pengaturan lingkungan tersebut.

#### Pilih cara setiap bagian dibangun

Sebuah **Manifest** memetakan setiap komponen ke sebuah **Recipe** untuk platform Anda, seperti chart Helm, modul Terraform, atau container.

#### Jalankan aggrega build

Perintah ini menulis berkas untuk setiap platform: **berkas yang sama** untuk masukan yang sama, setiap saat.

#### Lakukan deploy dengan alat Anda

Apa yang ditulisnya di-deploy oleh **ArgoCD**, **Flux** atau **Terraform**.

### Apa yang dapat Anda bangun

Mulai dari contoh yang dapat dijalankan, atau dari komponen katalog.

#### Agen AI dan gateway

Agen yang dibangun dengan LangGraph, CrewAI, LlamaIndex, Dify, n8n dan lainnya, di balik gateway model dengan anggaran token, semantic caching, penyamaran log, dan perisai terhadap prompt injection.

[Agen di balik gateway dengan anggaran token](https://aggrega.ai/docs/id/language-reference/examples/envoy-ai-gateway-token-budget/)

#### Beban kerja tradisional

Basis data, cache, message broker, dan identitas, misalnya PostgreSQL, MariaDB, Redis, Kafka, dan Keycloak.

[Satu basis data PostgreSQL, di-deploy dengan tiga cara](https://aggrega.ai/docs/id/language-reference/examples/postgres-three-realizations/)

#### Features

Kemampuan yang Anda pasang per lingkungan tanpa menyentuh aplikasi, misalnya perisai terhadap prompt injection, penyamaran data sensitif, ingress HTTPS, pemantauan, dan pencadangan.

[Gateway yang memeriksa setiap permintaan terhadap prompt injection](https://aggrega.ai/docs/id/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### Satu aplikasi, banyak platform

Aggregate yang sama di-build untuk Docker Compose di laptop dan untuk Kubernetes di produksi: mengganti target berarti mengganti pemetaan, bukan kode Anda.

[Satu Aggregate, di-build untuk Compose dan Kubernetes](https://aggrega.ai/docs/id/language-reference/examples/mariadb-adminer/)

aggregate.yaml ditulis sekali

Di laptop

release-compose.yaml

manifest-compose.yaml

aggrega build

docker-compose.yaml

Di klaster Kubernetes

release-helm-synth.yaml

manifest-helm-synth.yaml

aggrega build

manifest Kubernetes

Setiap platform dibangun dari Release dan Manifest miliknya sendiri. Aggregate, yang menjelaskan aplikasi Anda, tetap sama.

#### Tata kelola dan kebijakan

Kebijakan Anda terpasang ke dalam kompiler dan menghentikan build yang melanggarnya, dengan menyebutkan apa yang harus diperbaiki.

[Satu kebijakan, diperiksa pada empat target](https://aggrega.ai/docs/id/language-reference/examples/policy-render-verdict/)

aggrega build

kebijakan Anda terpasang di kompiler

lulus

file ditulis siap ditinjau dan di-deploy

gagal

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

Kebijakan dapat menghentikan build dan memberi tahu apa yang perlu diperbaiki. Kebijakan tidak pernah mengubah file Anda agar lolos.

#### Build yang dapat direproduksi

Masukan sama, keluaran sama, dengan setiap dependensi disematkan dalam lockfile.

[Lakukan build sebuah contoh beserta lockfile-nya](https://aggrega.ai/docs/id/language-reference/examples/ai-agent-and-model-router/#building)

#### Katalog pustaka standar

Components untuk agen, model, gateway, penyimpanan data, perpesanan, observabilitas, keamanan dan penyimpanan, siap digunakan dalam Aggregate.

[Jelajahi katalog](https://aggrega.ai/catalog/id/browse)

### Asisten Anda, dengan Aggrega

Apa yang diperoleh asisten yang menulis kode infrastruktur Anda dengan bekerja melalui Aggrega.

- **Dapat direproduksi** — Input yang sama, file yang sama, dengan setiap dependensi dipatok dalam lockfile.

- **Satu deskripsi** — Satu deskripsi aplikasi, dibangun untuk setiap platform tempat aplikasi itu berjalan.

- **Kebijakan saat build** — Kebijakan Anda berjalan di dalam compiler dan menghentikan build yang melanggarnya.

- **Katalog yang ditandatangani dan berversi** — Apa yang diambil asisten dari katalog memiliki versi dan tanda tangan, dan proses pull memverifikasi setiap tanda tangan.

- **Diperiksa oleh compiler** — Asisten memvalidasi dan melakukan build dengan binary aggrega, dan mengambil jawabannya tentang skema dan file dari binary tersebut.

### Target

Setiap platform mendapatkan berkas yang dibacanya secara native. Agen AI berjalan di klaster Kubernetes mana pun, dan banyak di antaranya juga di Compose.

- **Kubernetes** — Satu berkas manifest Kubernetes per sumber daya, untuk diterapkan oleh ArgoCD atau Flux.

- **Helm** — Chart Helm, dirender menjadi manifes Kubernetes.

- **Compose** — Berkas Docker Compose, untuk menjalankan aplikasi di laptop.

- **Terraform** — Konfigurasi untuk layanan cloud terkelola. Aggrega tidak pernah menjalankan Terraform.

- **CloudFormation** — Template stack untuk AWS. Aggrega tidak pernah menjalankan CloudFormation.

[Apa yang ditulis setiap target](https://aggrega.ai/docs/id/language-reference/providers/reference-matrix/)

### Impor

aggrega import membaca proyek dalam salah satu format ini dan menulis draf berkas Aggrega untuk Anda tinjau dan sunting.

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

aggrega import

draf file Aggrega untuk Anda tinjau dan sunting

Proyek Anda yang sudah ada masuk, draf file Aggrega keluar. Tidak ada yang di-deploy; Anda meninjau draf terlebih dahulu.

[Cara kerja impor](https://aggrega.ai/docs/id/authoring/import/)

### Mulai

#### Mulai cepat

Instal Aggrega, bangun contoh yang dapat dijalankan, jalankan di mesin Anda, lalu kembangkan selangkah demi selangkah.

[Memulai](https://aggrega.ai/docs/id/getting-started/)

#### Jalankan contoh pertama

Setiap contoh yang dapat dijalankan adalah ruang kerja lengkap yang Anda build dengan CLI aggrega.

[Jelajahi contoh](https://aggrega.ai/docs/id/language-reference/examples/)

#### Instal

Satu perintah menginstal binary aggrega untuk pengguna Anda, tanpa hak administrator.

[Instal binary](https://aggrega.ai/docs/id/install/#install-the-binary)

### Sumber terbuka

Kompiler Aggrega bersifat sumber terbuka di bawah lisensi Apache-2.0, dan akan tetap demikian: tidak akan ada edisi tertutup dari kompiler ini, dan tidak ada model open-core. Semua fitur kompiler akan tersedia dalam versi sumber terbuka.

#### Kompiler

Binary aggrega dan antarmuka baris perintahnya.

[aggrega-ai/aggrega-cli di GitHub](https://github.com/aggrega-ai/aggrega-cli)

#### Visual Studio Code

Validasi, navigasi, hover, dan pelengkapan untuk YAML Aggrega, didukung oleh binary aggrega.

[Ekstensi di GitHub](https://github.com/aggrega-ai/aggrega-vscode-extension)
