Zum Inhalt springen
Aggrega

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

Windows, in PowerShell

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

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

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

Der Prompt

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.
Was sich von Assistent zu Assistent ändert

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.

Aggregatebeschreibt Ihre Anwendung
ReleaseEinstellungen einer Umgebung
Manifestwie jeder Teil gebaut wird
aggrega buildgleiche Eingabe, gleiche Dateien
  • Kubernetes
  • Helm
  • Compose
  • Terraform
  • CloudFormation

Dateien, die Sie prüfen und die Ihnen gehören

Außerhalb von Aggrega
ArgoCD · Flux · Terraformstellen das Geschriebene bereit
Aggrega endet bei den Dateien. Es greift nie auf einen laufenden Cluster oder ein Cloud-Konto zu; Ihre eigenen Werkzeuge stellen bereit, was es geschrieben hat.
  1. Die Anwendung beschreiben

    Ein Aggregate benennt seine Komponenten und wie sie verbunden sind.

  2. Die Umgebung wählen

    Ein Release liefert die Einstellungen dieser Umgebung.

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

  4. aggrega build ausführen

    Der Befehl schreibt die Dateien für jede Plattform: bei gleicher Eingabe jedes Mal dieselben Dateien.

  5. 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-Budget
  • Klassische Arbeitslasten

    Datenbanken, Caches, Message Broker und Identitätsverwaltung, zum Beispiel PostgreSQL, MariaDB, Redis, Kafka und Keycloak.

    Eine PostgreSQL-Datenbank, auf drei Arten bereitgestellt
  • Features

    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üft
  • Eine 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 Kubernetes
    aggregate.yamleinmal geschrieben

    Auf einem Laptop

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

    Auf einem Kubernetes-Cluster

    release-helm-synth.yaml
    manifest-helm-synth.yaml
    aggrega build
    Kubernetes-Manifeste
    Jede 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üft
    aggrega build
    Ihre Richtliniein den Compiler eingebunden
    bestanden
    Dateien geschriebenbereit zur Prüfung und Bereitstellung
    nicht bestanden
    Build gestopptpolicy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted
    Eine 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 bauen
  • Der 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.
Was jedes Ziel schreibt

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
aggrega import
Entwürfe von Aggrega-Dateienzum Prüfen und Bearbeiten
Ihr bestehendes Projekt hinein, Entwürfe von Aggrega-Dateien heraus. Nichts wird bereitgestellt; Sie prüfen zuerst die Entwürfe.
Wie der Import funktioniert

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 Schritte
  • Ein erstes Beispiel ausführen

    Jedes lauffähige Beispiel ist ein vollständiger Workspace, den Sie mit der CLI aggrega bauen.

    Die Beispiele durchsuchen
  • Installation

    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.