# Aggrega

> Aggrega è un compilatore open source per l’infrastruttura come codice: un’unica descrizione YAML della tua applicazione diventa file Kubernetes, Helm, Compose, Terraform o CloudFormation che rivedi e che ti appartengono.

URL: https://aggrega.ai/it/

## Descrivi l’architettura una volta sola. Ottieni il codice dell’infrastruttura per ogni piattaforma che usi.

Aggrega è un compilatore open source per l’infrastruttura come codice: un’unica descrizione YAML della tua applicazione diventa file **Kubernetes**, **Helm**, **Compose**, **Terraform** o **CloudFormation** che rivedi e che ti appartengono.

Hai già costruito un agente con **LangGraph**, **CrewAI**, **n8n**, **Dify** e altri ancora? Importalo.

[Configura con il tuo assistente AI](https://aggrega.ai/it/#ai-assistant)[Guida rapida](https://aggrega.ai/docs/it/getting-started/)[Importa il tuo progetto](https://aggrega.ai/it/#import)

Linux e macOS

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

Windows, in PowerShell

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

Due esempi della guida rapida, costruiti un passo alla volta: un agente AI su un modello locale e un’applicazione web con PostgreSQL. Ogni passo mostra i file che modifica con le righe che aggiunge, il comando aggrega build e i file che la build scrive.

### Funziona con il tuo assistente AI

Incolla questo prompt in un assistente che può eseguire comandi: installerà Aggrega, aggiungerà a sé stesso la skill di Aggrega e si collegherà al server MCP di Aggrega. Il prompt gli fa chiedere la tua conferma prima di installare qualsiasi cosa.

Il prompt

Configura Aggrega per me, un passo alla volta, e dimmi che cosa hai eseguito a ogni passo.

1. Esegui `aggrega version`. Se il comando non viene trovato, chiedimi prima di installare Aggrega, poi installalo per il mio utente con l’installer ufficiale: su Linux o macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, su Windows in PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Esegui di nuovo `aggrega version`. Se l’installer ha stampato una riga da aggiungere al mio `PATH`, mostramela.

2. Se `https://aggrega.ai/docs/ai-assistants/skill/` indica un modo per installare in te il plugin di Aggrega, chiedimi prima di installarlo, poi installalo in quel modo, oppure dimmi che cosa fare quando si tratta di un passaggio che compio io nella tua interfaccia. Il plugin aggiunge la skill di Aggrega e ti collega al server MCP di Aggrega. Altrimenti, esegui `aggrega skills install --help` e trova il tuo identificatore nell’elenco che stampa. Chiedimi se voglio la skill in questo progetto o in tutti i progetti, poi esegui `aggrega skills install --agent <your identifier>`, aggiungendo `--global` per tutti i progetti. Se non sei nell’elenco, salta l’installazione della skill e dimmelo.

3. Se hai installato il plugin, sei già collegato al server MCP di Aggrega. Altrimenti, collegati al server MCP di Aggrega, che è il comando `aggrega mcp`, nel modo in cui aggiungi un server MCP, come descrive per te `https://aggrega.ai/docs/ai-assistants/mcp-server/`. Se ti serve un riavvio o un ricaricamento per caricare il plugin o il server, dimmi che cosa fare.

4. Una volta connesso, chiama lo strumento `describe-capabilities` senza argomenti e riassumi ciò che elenca.

**Mostra tutto il prompt**

- **La skill** — Spiega all’assistente come si svolge il ciclo di scrittura e gli chiede di prendere ogni risposta su uno schema o su un file dal binario aggrega.

- **Il server MCP** — aggrega mcp dà all’assistente gli strumenti di Aggrega: scaffold, validate, build e gli altri.

[Cosa cambia da un assistente all’altro](https://aggrega.ai/docs/it/ai-assistants/set-up/)

### Come funziona

Tu descrivi l’applicazione, Aggrega scrive i file e gli strumenti che già usi li distribuiscono. Aggrega non raggiunge mai un cluster in esecuzione né un account cloud.

Aggregate descrive la tua applicazione

Release le impostazioni di un ambiente

Manifest come si costruisce ogni parte

aggrega build stesso input, stessi file

- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation

file che revisioni e che restano tuoi

Fuori da Aggrega

ArgoCD · Flux · Terraform distribuiscono ciò che ha scritto

Aggrega si ferma ai file. Non accede mai a un cluster in esecuzione né a un account cloud; sono i tuoi strumenti a distribuire ciò che ha scritto.

#### Descrivi l’applicazione

Un **Aggregate** elenca i suoi **componenti** e come si collegano.

#### Scegli l’ambiente

Una **Release** fornisce le impostazioni di quell’ambiente.

#### Scegli come viene costruita ogni parte

Un **Manifest** associa ogni componente a una **Recipe** per la tua piattaforma, come un chart Helm, un modulo Terraform o un container.

#### Esegui aggrega build

Scrive i file per ogni piattaforma: gli **stessi file** per lo stesso input, ogni volta.

#### Distribuisci con i tuoi strumenti

Ciò che ha scritto viene distribuito da **ArgoCD**, **Flux** o **Terraform**.

### Cosa puoi costruire

Parti da un esempio eseguibile o dai componenti del catalogo.

#### Agenti AI e gateway

Agenti costruiti con LangGraph, CrewAI, LlamaIndex, Dify, n8n e altri ancora, dietro gateway di modelli con budget di token, caching semantico, mascheramento dei log e uno scudo contro la prompt injection.

[Un agente dietro un gateway con un budget di token](https://aggrega.ai/docs/it/language-reference/examples/envoy-ai-gateway-token-budget/)

#### Carichi di lavoro tradizionali

Database, cache, broker di messaggi e gestione delle identità, per esempio PostgreSQL, MariaDB, Redis, Kafka e Keycloak.

[Un database PostgreSQL, distribuito in tre modi](https://aggrega.ai/docs/it/language-reference/examples/postgres-three-realizations/)

#### Features

Funzionalità che colleghi per ambiente senza toccare l’applicazione, per esempio uno scudo contro la prompt injection, il mascheramento dei dati sensibili, l’ingress HTTPS, il monitoraggio e i backup.

[Un gateway che controlla ogni richiesta alla ricerca di prompt injection](https://aggrega.ai/docs/it/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### Un’applicazione, molte piattaforme

Lo stesso Aggregate viene costruito per Docker Compose su un laptop e per Kubernetes in produzione: cambiare destinazione cambia una mappatura, non il tuo codice.

[Un Aggregate, costruito per Compose e Kubernetes](https://aggrega.ai/docs/it/language-reference/examples/mariadb-adminer/)

aggregate.yaml scritto una volta

Su un portatile

release-compose.yaml

manifest-compose.yaml

aggrega build

docker-compose.yaml

Su un cluster Kubernetes

release-helm-synth.yaml

manifest-helm-synth.yaml

aggrega build

manifest Kubernetes

Ogni piattaforma si costruisce dalla propria Release e dal proprio Manifest. L’Aggregate, che descrive la tua applicazione, resta lo stesso.

#### Governance e policy

Le tue policy si inseriscono nel compilatore e fermano una build che le viola, indicando cosa correggere.

[Una policy, verificata su quattro destinazioni](https://aggrega.ai/docs/it/language-reference/examples/policy-render-verdict/)

aggrega build

la tua policy inserita nel compilatore

superata

file scritti pronti da revisionare e distribuire

non superata

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

Una policy può fermare una build e dire cosa correggere. Non modifica mai i tuoi file per farli passare.

#### Build riproducibili

Stesso input, stesso output, con ogni dipendenza fissata in un lockfile.

[Costruisci un esempio e il suo lockfile](https://aggrega.ai/docs/it/language-reference/examples/ai-agent-and-model-router/#building)

#### Il catalogo della libreria standard

Components per agenti, modelli, gateway, archivi di dati, messaggistica, osservabilità, sicurezza e archiviazione, pronti all’uso in un Aggregate.

[Sfoglia il catalogo](https://aggrega.ai/catalog/it/browse)

### Il tuo assistente, con Aggrega

Cosa guadagna un assistente che scrive il tuo codice di infrastruttura lavorando tramite Aggrega.

- **Riproducibile** — Stesso input, stessi file, con ogni dipendenza fissata in un lockfile.

- **Un’unica descrizione** — Un’unica descrizione dell’applicazione, costruita per ogni piattaforma su cui gira.

- **Policy in fase di build** — Le tue policy girano nel compilatore e fermano una build che le viola.

- **Un catalogo firmato e versionato** — Ciò che un assistente scarica dal catalogo è versionato e firmato, e lo scaricamento verifica ogni firma.

- **Verificato dal compilatore** — L’assistente valida e costruisce con il binario aggrega, e prende da esso le risposte su schemi e file.

### Destinazioni

Ogni piattaforma riceve i file che legge nativamente. Gli agenti AI girano su qualsiasi cluster Kubernetes, e molti anche su Compose.

- **Kubernetes** — File manifest di Kubernetes, uno per risorsa, da far applicare ad ArgoCD o Flux.

- **Helm** — Chart Helm, renderizzati in manifest di Kubernetes.

- **Compose** — Un file Docker Compose, per eseguire l’applicazione su un laptop.

- **Terraform** — Configurazione per servizi cloud gestiti. Aggrega non esegue mai Terraform.

- **CloudFormation** — Template di stack per AWS. Aggrega non esegue mai CloudFormation.

[Cosa scrive ogni destinazione](https://aggrega.ai/docs/it/language-reference/providers/reference-matrix/)

### Importazione

aggrega import legge un progetto in uno di questi formati e scrive bozze di file Aggrega da rivedere e modificare.

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

aggrega import

file Aggrega in bozza da revisionare e modificare

Il tuo progetto esistente in ingresso, file Aggrega in bozza in uscita. Non viene distribuito nulla; prima revisioni le bozze.

[Come funziona l’importazione](https://aggrega.ai/docs/it/authoring/import/)

### Inizia

#### Guida rapida

Installa Aggrega, costruisci un esempio eseguibile, eseguilo sulla tua macchina, poi fallo crescere un passo alla volta.

[Primi passi](https://aggrega.ai/docs/it/getting-started/)

#### Esegui un primo esempio

Ogni esempio eseguibile è un workspace completo che costruisci con la CLI aggrega.

[Sfoglia gli esempi](https://aggrega.ai/docs/it/language-reference/examples/)

#### Installazione

Un solo comando installa il binario aggrega per il tuo utente, senza diritti di amministratore.

[Installa il binario](https://aggrega.ai/docs/it/install/#install-the-binary)

### Open source

Il compilatore Aggrega è open source con licenza Apache-2.0, e resterà così: non ci sarà un’edizione chiusa del compilatore, nessun open-core. Tutte le funzionalità del compilatore saranno disponibili nella versione open source.

#### Il compilatore

Il binario aggrega e la sua interfaccia a riga di comando.

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

#### Visual Studio Code

Validazione, navigazione, hover e completamento per lo YAML di Aggrega, basati sul binario aggrega.

[L’estensione su GitHub](https://github.com/aggrega-ai/aggrega-vscode-extension)
