Diese Seite wurde maschinell übersetzt. Englisches Original lesen.
Beschreiben Sie die Architektur einmal.Erhalten Sie den Infrastrukturcode für jede Plattform, die Sie betreiben.
Aggrega ist ein Open-Source-Compiler für Infrastructure as Code: Aus einer einzigen YAML-Beschreibung Ihrer Anwendung werden Dateien für Kubernetes, Helm, Compose, Terraform oder CloudFormation, die Sie prüfen und die Ihnen gehören.
Haben Sie schon einen Agenten mit LangGraph, CrewAI, n8n, Dify oder anderen gebaut? Importieren Sie ihn.
Linux und macOS
curl -fsSL https://aggrega.ai/install.sh | shWindows, in PowerShell
irm https://aggrega.ai/install.ps1 | iexZwei Schnellstart-Beispiele, Schritt für Schritt aufgebaut: ein KI-Agent auf einem lokalen Modell und eine Webanwendung mit PostgreSQL. Jeder Schritt zeigt die Dateien, die er ändert, mit den Zeilen, die er hinzufügt, den Befehl aggrega build und die Dateien, die der Build schreibt.
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
Funktioniert mit Ihrem KI-Assistenten
Fügen Sie diesen Prompt in einen Assistenten ein, der Befehle ausführen kann: Er installiert Aggrega, fügt sich selbst den Aggrega-Skill hinzu und verbindet sich mit dem Aggrega-MCP-Server. Der Prompt lässt ihn bei Ihnen nachfragen, bevor er etwas installiert.
Richten Sie Aggrega für mich ein, Schritt für Schritt, und sagen Sie mir, was Sie bei jedem Schritt ausgeführt haben.
1. Führen Sie `aggrega version` aus. Wird der Befehl nicht gefunden, fragen Sie mich, bevor Sie Aggrega installieren, und installieren Sie es dann für meinen Benutzer mit dem offiziellen Installationsprogramm: unter Linux oder macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, unter Windows in PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Führen Sie `aggrega version` erneut aus. Wenn das Installationsprogramm eine Zeile ausgegeben hat, die zu meinem `PATH` hinzuzufügen ist, zeigen Sie sie mir.
2. Wenn `https://aggrega.ai/docs/ai-assistants/skill/` einen Weg angibt, das Aggrega-Plugin bei Ihnen zu installieren, fragen Sie mich, bevor Sie es installieren, und installieren Sie es dann auf diese Weise, oder sagen Sie mir, was zu tun ist, wo es sich um einen Schritt handelt, den ich in Ihrer Oberfläche ausführe. Das Plugin fügt den Aggrega-Skill hinzu und verbindet Sie mit dem MCP-Server von Aggrega. Andernfalls führen Sie `aggrega skills install --help` aus und suchen Sie Ihren eigenen Bezeichner in der Liste, die der Befehl ausgibt. Fragen Sie mich, ob ich den Skill in diesem Projekt oder in allen Projekten haben möchte, und führen Sie dann `aggrega skills install --agent <your identifier>` aus, mit `--global` für alle Projekte. Wenn Sie nicht in der Liste stehen, überspringen Sie die Installation des Skills und sagen Sie es mir.
3. Wenn Sie das Plugin installiert haben, sind Sie bereits mit dem MCP-Server von Aggrega verbunden. Andernfalls verbinden Sie sich mit dem MCP-Server von Aggrega, also dem Befehl `aggrega mcp`, so wie Sie einen MCP-Server hinzufügen, wie `https://aggrega.ai/docs/ai-assistants/mcp-server/` es für Sie beschreibt. Wenn Sie einen Neustart oder ein Neuladen brauchen, um das Plugin oder den Server zu laden, sagen Sie mir, was zu tun ist.
4. Sobald Sie verbunden sind, rufen Sie das Tool `describe-capabilities` ohne Argumente auf und fassen Sie zusammen, was es auflistet.
- Der Skill
- Erklärt dem Assistenten, wie der Authoring-Zyklus abläuft, und dass er jede Antwort zu einem Schema oder einer Datei von der Binärdatei aggrega übernehmen soll.
- Der MCP-Server
- aggrega mcp gibt dem Assistenten die Werkzeuge von Aggrega: scaffold, validate, build und die übrigen.
So funktioniert es
Sie beschreiben die Anwendung, Aggrega schreibt die Dateien, und die Werkzeuge, die Sie bereits verwenden, stellen sie bereit. Aggrega greift nie auf einen laufenden Cluster oder ein Cloud-Konto zu.
- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation
Dateien, die Sie prüfen und die Ihnen gehören
Die Anwendung beschreiben
Ein Aggregate benennt seine Komponenten und wie sie verbunden sind.
Die Umgebung wählen
Ein Release liefert die Einstellungen dieser Umgebung.
Festlegen, wie jeder Teil gebaut wird
Ein Manifest ordnet jede Komponente einem Recipe für Ihre Plattform zu, etwa einem Helm-Chart, einem Terraform-Modul oder einem Container.
aggrega build ausführen
Der Befehl schreibt die Dateien für jede Plattform: bei gleicher Eingabe jedes Mal dieselben Dateien.
Mit Ihren Werkzeugen bereitstellen
Was der Befehl geschrieben hat, stellen ArgoCD, Flux oder Terraform bereit.
Was Sie bauen können
Beginnen Sie mit einem lauffähigen Beispiel oder mit den Komponenten des Katalogs.
KI-Agenten und Gateways
Agenten, gebaut mit LangGraph, CrewAI, LlamaIndex, Dify, n8n und anderen, hinter Modell-Gateways mit Token-Budgets, semantischem Caching, Log-Maskierung und einem Schutz gegen Prompt-Injection.
Ein Agent hinter einem Gateway mit Token-BudgetKlassische Arbeitslasten
Datenbanken, Caches, Message Broker und Identitätsverwaltung, zum Beispiel PostgreSQL, MariaDB, Redis, Kafka und Keycloak.
Eine PostgreSQL-Datenbank, auf drei Arten bereitgestelltFeatures
Fähigkeiten, die Sie pro Umgebung anhängen, ohne die Anwendung anzufassen, zum Beispiel ein Schutz gegen Prompt-Injection, die Maskierung sensibler Daten, HTTPS-Ingress, Monitoring und Backups.
Ein Gateway, das jede Anfrage auf Prompt-Injection prüftEine Anwendung, viele Plattformen
Dasselbe Aggregate wird für Docker Compose auf einem Laptop und für Kubernetes in der Produktion gebaut: Ein Wechsel des Ziels ändert ein Mapping, nicht Ihren Code.
Ein Aggregate, gebaut für Compose und Kubernetesaggregate.yamleinmal geschriebenAuf einem Laptop
release-compose.yamlmanifest-compose.yamlaggrega builddocker-compose.yamlAuf einem Kubernetes-Cluster
release-helm-synth.yamlmanifest-helm-synth.yamlaggrega buildKubernetes-ManifesteJede Plattform wird aus ihrem eigenen Release und Manifest gebaut. Das Aggregate, das Ihre Anwendung beschreibt, bleibt gleich. Governance und Richtlinien
Ihre Richtlinien werden in den Compiler eingesteckt und stoppen einen Build, der gegen sie verstößt, mit dem Hinweis, was zu beheben ist.
Eine Richtlinie, auf vier Zielen geprüftaggrega buildIhre Richtliniein den Compiler eingebundenbestandenDateien geschriebenbereit zur Prüfung und Bereitstellungnicht bestandenBuild gestopptpolicy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencryptedEine Richtlinie kann einen Build stoppen und sagen, was zu beheben ist. Sie ändert Ihre Dateien nie, damit sie bestehen. Reproduzierbare Builds
Gleiche Eingabe, gleiche Ausgabe, und jede Abhängigkeit ist in einer Lockfile fixiert.
Ein Beispiel und seine Lockfile bauenDer Katalog der Standardbibliothek
Components für Agenten, Modelle, Gateways, Datenspeicher, Messaging, Observability, Sicherheit und Speicherung, bereit zur Verwendung in einem Aggregate.
Den Katalog durchsuchen
Ihr Assistent, mit Aggrega
Was ein Assistent, der Ihren Infrastrukturcode schreibt, gewinnt, wenn er über Aggrega arbeitet.
- Reproduzierbar
- Gleiche Eingabe, gleiche Dateien, und jede Abhängigkeit ist in einer Lockfile fixiert.
- Eine Beschreibung
- Eine Beschreibung der Anwendung, gebaut für jede Plattform, auf der sie läuft.
- Richtlinien zur Build-Zeit
- Ihre Richtlinien laufen im Compiler und stoppen einen Build, der gegen sie verstößt.
- Ein signierter, versionierter Katalog
- Was ein Assistent aus dem Katalog abruft, ist versioniert und signiert, und der Abruf prüft jede Signatur.
- Vom Compiler geprüft
- Der Assistent validiert und baut mit der Binärdatei aggrega und bezieht von ihr seine Antworten zu Schemas und Dateien.
Ziele
Jede Plattform erhält die Dateien, die sie nativ liest. KI-Agenten laufen auf jedem Kubernetes-Cluster, viele auch auf Compose.
- Kubernetes
- Kubernetes-Manifeste, eine Datei pro Ressource, die ArgoCD oder Flux anwenden.
- Helm
- Helm-Charts, zu Kubernetes-Manifesten gerendert.
- Compose
- Eine Docker-Compose-Datei, um die Anwendung auf einem Laptop auszuführen.
- Terraform
- Konfiguration für verwaltete Cloud-Dienste. Aggrega führt Terraform nie aus.
- CloudFormation
- Stack-Templates für AWS. Aggrega führt CloudFormation nie aus.
Import
aggrega import liest ein Projekt in einem dieser Formate und schreibt Entwürfe von Aggrega-Dateien, die Sie prüfen und bearbeiten.
- LangGraph
- CrewAI
- n8n
- Dify
- Langflow
- Flowise
- Google ADK
- Microsoft Agent Framework
- MCP client configurations
- Compose
Loslegen
Schnellstart
Installieren Sie Aggrega, bauen Sie ein lauffähiges Beispiel, führen Sie es auf Ihrem Rechner aus und erweitern Sie es dann Schritt für Schritt.
Erste SchritteEin erstes Beispiel ausführen
Jedes lauffähige Beispiel ist ein vollständiger Workspace, den Sie mit der CLI aggrega bauen.
Die Beispiele durchsuchenInstallation
Ein einziger Befehl installiert die Binärdatei aggrega für Ihren Benutzer, ohne Administratorrechte.
Die Binärdatei installieren
Open Source
Der Aggrega-Compiler ist Open Source unter Apache-2.0 und bleibt es: Es wird keine geschlossene Edition des Compilers geben, kein Open-Core. Alle Funktionen des Compilers werden in der Open-Source-Version verfügbar sein.
Der Compiler
Die Binärdatei aggrega und ihre Befehlszeilenschnittstelle.
aggrega-ai/aggrega-cli auf GitHubVisual Studio Code
Validierung, Navigation, Hover und Vervollständigung für Aggrega-YAML, gestützt auf die Binärdatei aggrega.
Die Erweiterung auf GitHub