Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.
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.
Linux e macOS
curl -fsSL https://aggrega.ai/install.sh | shWindows, in PowerShell
irm https://aggrega.ai/install.ps1 | iexDue 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.
aggregate.yaml
kind: Aggregatespec: components: chat: type: core/compute/server agent: type: core/ai-agent/langgraph llm: type: core/ai-model/ollama memory: type: core/datastore/valkeyaggrega build --release release.yaml --auto-pull
- dist/compose/docker-compose.yaml
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.
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.
- 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.
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.
- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation
file che revisioni e che restano tuoi
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 tokenCarichi 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 modiFeatures
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 injectionUn’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 Kubernetesaggregate.yamlscritto una voltaSu un portatile
release-compose.yamlmanifest-compose.yamlaggrega builddocker-compose.yamlSu un cluster Kubernetes
release-helm-synth.yamlmanifest-helm-synth.yamlaggrega buildmanifest KubernetesOgni 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 destinazioniaggrega buildla tua policyinserita nel compilatoresuperatafile scrittipronti da revisionare e distribuirenon superatabuild interrottapolicy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencryptedUna 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 lockfileIl 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
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.
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
Inizia
Guida rapida
Installa Aggrega, costruisci un esempio eseguibile, eseguilo sulla tua macchina, poi fallo crescere un passo alla volta.
Primi passiEsegui un primo esempio
Ogni esempio eseguibile è un workspace completo che costruisci con la CLI aggrega.
Sfoglia gli esempiInstallazione
Un solo comando installa il binario aggrega per il tuo utente, senza diritti di amministratore.
Installa il binario
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 GitHubVisual Studio Code
Validazione, navigazione, hover e completamento per lo YAML di Aggrega, basati sul binario aggrega.
L’estensione su GitHub