Aller au contenu
Aggrega

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 | sh

Windows, dans PowerShell

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

Deux 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/valkey

aggrega 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.

Le prompt

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.
Ce qui change d’un assistant à l’autre

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.

Aggregatedécrit votre application
Releaseles paramètres d’un environnement
Manifestcomment chaque partie est construite
aggrega buildmêmes entrées, mêmes fichiers
  • Kubernetes
  • Helm
  • Compose
  • Terraform
  • CloudFormation

des fichiers que vous relisez et qui vous appartiennent

En dehors d’Aggrega
ArgoCD · Flux · Terraformdéploient ce qu’il a écrit
Aggrega s’arrête aux fichiers. Il n’accède jamais à un cluster en cours d’exécution ni à un compte cloud ; vos propres outils déploient ce qu’il a écrit.
  1. Décrire l’application

    Un Aggregate nomme ses composants et la façon dont ils se connectent.

  2. Choisir l’environnement

    Une Release fournit les paramètres de cet environnement.

  3. 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.

  4. Exécuter aggrega build

    La commande écrit les fichiers de chaque plateforme : les mêmes fichiers pour la même entrée, à chaque fois.

  5. 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 jetons
  • Charges 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çons
  • Features

    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 prompt
  • Une 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 Kubernetes
    aggregate.yamlécrit une seule fois

    Sur un ordinateur portable

    release-compose.yaml
    manifest-compose.yaml
    aggrega build
    docker-compose.yaml

    Sur un cluster Kubernetes

    release-helm-synth.yaml
    manifest-helm-synth.yaml
    aggrega build
    manifestes Kubernetes
    Chaque 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 cibles
    aggrega build
    votre politiquebranchée sur le compilateur
    réussite
    fichiers écritsprêts à relire et à déployer
    échec
    build arrêtépolicy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted
    Une 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 verrouillage
  • Le 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.
Ce que chaque cible écrit

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
aggrega import
brouillons de fichiers Aggregaà relire et à modifier
Votre projet existant en entrée, des brouillons de fichiers Aggrega en sortie. Rien n’est déployé ; vous relisez d’abord les brouillons.
Fonctionnement de l’import

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 pas
  • Exécuter un premier exemple

    Chaque exemple exécutable est un espace de travail complet que vous construisez avec la CLI aggrega.

    Parcourir les exemples
  • Installer

    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.