Cette page a été traduite automatiquement. Lire l’original en anglais.
Décrivez l’architecture une seule fois.Obtenez le code d’infrastructure de chaque plateforme que vous exploitez.
Aggrega est un compilateur open source pour l’infrastructure en tant que code : une seule description YAML de votre application devient des fichiers Kubernetes, Helm, Compose, Terraform ou CloudFormation que vous relisez et qui vous appartiennent.
Vous avez déjà construit un agent avec LangGraph, CrewAI, n8n, Dify ou d’autres ? Importez-le.
Linux et macOS
curl -fsSL https://aggrega.ai/install.sh | shWindows, dans PowerShell
irm https://aggrega.ai/install.ps1 | iexDeux exemples de démarrage rapide, construits une étape à la fois : un agent IA sur un modèle local, et une application web avec PostgreSQL. Chaque étape montre les fichiers qu’elle modifie avec les lignes qu’elle ajoute, la commande aggrega build et les fichiers que le build écrit.
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
Fonctionne avec votre assistant IA
Collez ce prompt dans un assistant capable d’exécuter des commandes : il installe Aggrega, s’ajoute la compétence Aggrega et se connecte au serveur MCP d’Aggrega. Le prompt lui fait vous demander votre accord avant d’installer quoi que ce soit.
Configurez Aggrega pour moi, une étape à la fois, et dites-moi ce que vous avez exécuté à chaque étape.
1. Exécutez `aggrega version`. Si la commande est introuvable, demandez-moi avant d’installer Aggrega, puis installez-le pour mon utilisateur avec le programme d’installation officiel : sous Linux ou macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, sous Windows dans PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Exécutez de nouveau `aggrega version`. Si le programme d’installation a affiché une ligne à ajouter à mon `PATH`, montrez-la-moi.
2. Si `https://aggrega.ai/docs/ai-assistants/skill/` indique un moyen d’installer le plugin Aggrega en vous, demandez-moi avant de l’installer, puis installez-le de cette manière, ou dites-moi quoi faire lorsqu’il s’agit d’une étape que j’effectue dans votre interface. Le plugin ajoute la skill Aggrega et vous connecte au serveur MCP d’Aggrega. Sinon, exécutez `aggrega skills install --help` et trouvez votre propre identifiant dans la liste qu’il affiche. Demandez-moi si je veux la skill dans ce projet ou dans tous les projets, puis exécutez `aggrega skills install --agent <your identifier>`, en ajoutant `--global` pour tous les projets. Si vous n’êtes pas dans la liste, n’installez pas la skill et dites-le-moi.
3. Si vous avez installé le plugin, vous êtes déjà connecté au serveur MCP d’Aggrega. Sinon, connectez-vous au serveur MCP d’Aggrega, qui est la commande `aggrega mcp`, de la manière dont vous ajoutez un serveur MCP, comme `https://aggrega.ai/docs/ai-assistants/mcp-server/` le décrit pour vous. Si vous avez besoin d’un redémarrage ou d’un rechargement pour charger le plugin ou le serveur, dites-moi quoi faire.
4. Une fois connecté, appelez l’outil `describe-capabilities` sans argument et résumez ce qu’il liste.
- La compétence
- Indique à l’assistant comment se déroule la boucle de rédaction, et lui demande de tirer chaque réponse sur un schéma ou un fichier du binaire aggrega.
- Le serveur MCP
- aggrega mcp donne à l’assistant les outils d’Aggrega : scaffold, validate, build et les autres.
Comment ça fonctionne
Vous décrivez l’application, Aggrega écrit les fichiers, et les outils que vous utilisez déjà les déploient. Aggrega n’accède jamais à un cluster en cours d’exécution ni à un compte cloud.
- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation
des fichiers que vous relisez et qui vous appartiennent
Décrire l’application
Un Aggregate nomme ses composants et la façon dont ils se connectent.
Choisir l’environnement
Une Release fournit les paramètres de cet environnement.
Choisir comment chaque partie est construite
Un Manifest associe chaque composant à une Recipe pour votre plateforme, comme un chart Helm, un module Terraform ou un conteneur.
Exécuter aggrega build
La commande écrit les fichiers de chaque plateforme : les mêmes fichiers pour la même entrée, à chaque fois.
Déployer avec vos outils
Ce qu’elle a écrit est déployé par ArgoCD, Flux ou Terraform.
Ce que vous pouvez construire
Partez d’un exemple exécutable, ou des composants du catalogue.
Agents IA et passerelles
Des agents construits avec LangGraph, CrewAI, LlamaIndex, Dify, n8n et d’autres, derrière des passerelles de modèles avec budgets de jetons, cache sémantique, masquage des journaux et un bouclier contre l’injection de prompt.
Un agent derrière une passerelle avec un budget de jetonsCharges de travail traditionnelles
Bases de données, caches, brokers de messages et gestion des identités, par exemple PostgreSQL, MariaDB, Redis, Kafka et Keycloak.
Une base de données PostgreSQL, déployée de trois façonsFeatures
Des capacités que vous attachez par environnement sans toucher à l’application, par exemple un bouclier contre l’injection de prompt, le masquage des données sensibles, un ingress HTTPS, la supervision et les sauvegardes.
Une passerelle qui contrôle chaque requête pour détecter l’injection de promptUne application, de nombreuses plateformes
Le même Aggregate se construit pour Docker Compose sur un ordinateur portable et pour Kubernetes en production : changer de cible change une correspondance, pas votre code.
Un Aggregate, construit pour Compose et Kubernetesaggregate.yamlécrit une seule foisSur un ordinateur portable
release-compose.yamlmanifest-compose.yamlaggrega builddocker-compose.yamlSur un cluster Kubernetes
release-helm-synth.yamlmanifest-helm-synth.yamlaggrega buildmanifestes KubernetesChaque plateforme est construite à partir de sa propre Release et de son propre Manifest. L’Aggregate, qui décrit votre application, reste le même. Gouvernance et politiques
Vos politiques se branchent sur le compilateur et arrêtent un build qui les enfreint, en indiquant quoi corriger.
Une politique, vérifiée sur quatre ciblesaggrega buildvotre politiquebranchée sur le compilateurréussitefichiers écritsprêts à relire et à déployeréchecbuild arrêtépolicy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencryptedUne politique peut arrêter un build et indiquer quoi corriger. Elle ne modifie jamais vos fichiers pour les faire passer. Builds reproductibles
Même entrée, même sortie, avec chaque dépendance figée dans un fichier de verrouillage.
Construire un exemple et son fichier de verrouillageLe catalogue de la bibliothèque standard
Components pour les agents, les modèles, les passerelles, les magasins de données, la messagerie, l’observabilité, la sécurité et le stockage, prêts à l’emploi dans un Aggregate.
Parcourir le catalogue
Votre assistant, avec Aggrega
Ce que gagne un assistant qui écrit votre code d’infrastructure en passant par Aggrega.
- Reproductible
- Même entrée, mêmes fichiers, avec chaque dépendance figée dans un fichier de verrouillage.
- Une seule description
- Une seule description de l’application, construite pour chaque plateforme sur laquelle elle s’exécute.
- Des politiques au moment du build
- Vos politiques s’exécutent dans le compilateur et arrêtent un build qui les enfreint.
- Un catalogue signé et versionné
- Ce qu’un assistant récupère du catalogue est versionné et signé, et la récupération vérifie chaque signature.
- Vérifié par le compilateur
- L’assistant valide et construit avec le binaire aggrega, et tire de lui ses réponses sur les schémas et les fichiers.
Cibles
Chaque plateforme reçoit les fichiers qu’elle lit nativement. Les agents IA s’exécutent sur n’importe quel cluster Kubernetes, et beaucoup aussi sur Compose.
- Kubernetes
- Des manifestes Kubernetes, un fichier par ressource, qu’ArgoCD ou Flux appliquent.
- Helm
- Des charts Helm, rendus en manifestes Kubernetes.
- Compose
- Un fichier Docker Compose, pour exécuter l’application sur un ordinateur portable.
- Terraform
- Une configuration pour des services cloud managés. Aggrega n’exécute jamais Terraform.
- CloudFormation
- Des modèles de stack pour AWS. Aggrega n’exécute jamais CloudFormation.
Import
aggrega import lit un projet dans l’un de ces formats et écrit des brouillons de fichiers Aggrega que vous relisez et modifiez.
- LangGraph
- CrewAI
- n8n
- Dify
- Langflow
- Flowise
- Google ADK
- Microsoft Agent Framework
- MCP client configurations
- Compose
Commencer
Démarrage rapide
Installez Aggrega, construisez un exemple exécutable, lancez-le sur votre machine, puis faites-le évoluer une étape à la fois.
Premiers pasExécuter un premier exemple
Chaque exemple exécutable est un espace de travail complet que vous construisez avec la CLI aggrega.
Parcourir les exemplesInstaller
Une seule commande installe le binaire aggrega pour votre utilisateur, sans droits d’administrateur.
Installer le binaire
Open source
Le compilateur Aggrega est open source sous licence Apache-2.0, et le restera : il n’y aura pas d’édition fermée du compilateur, pas d’open-core. Toutes les fonctionnalités du compilateur seront disponibles dans la version open source.
Le compilateur
Le binaire aggrega et son interface en ligne de commande.
aggrega-ai/aggrega-cli sur GitHubVisual Studio Code
Validation, navigation, survol et complétion pour le YAML d’Aggrega, fondés sur le binaire aggrega.
L’extension sur GitHub