Перейти к содержимому
Aggrega

Эта страница переведена с помощью машинного перевода. Читать оригинал на английском.

Опишите архитектуру один раз.Получите код инфраструктуры для каждой платформы, которую вы используете.

Aggrega — компилятор с открытым исходным кодом для инфраструктуры как кода: одно YAML-описание вашего приложения превращается в файлы Kubernetes, Helm, Compose, Terraform или CloudFormation, которые вы проверяете и которыми владеете.

Уже создали агента на LangGraph, CrewAI, n8n, Dify или другой платформе? Импортируйте его.

Linux и macOS

curl -fsSL https://aggrega.ai/install.sh | sh

Windows, в PowerShell

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

Два примера быстрого старта, построенные шаг за шагом: ИИ-агент на локальной модели и веб-приложение с PostgreSQL. Каждый шаг показывает файлы, которые он меняет, с добавленными строками, команду aggrega build и файлы, которые записывает сборка.

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

Работает с вашим ИИ-ассистентом

Вставьте этот промпт в ассистента, который умеет выполнять команды, и он установит Aggrega, добавит себе навык Aggrega и подключится к MCP-серверу Aggrega. Промпт требует, чтобы ассистент спросил вас, прежде чем что-либо устанавливать.

Промпт

Настройте Aggrega для меня шаг за шагом и сообщайте, что вы запускали на каждом шаге.

1. Выполните `aggrega version`. Если команда не найдена, спросите меня, прежде чем устанавливать Aggrega, затем установите его для моего пользователя официальным установщиком: в Linux или macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, в Windows в PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Снова выполните `aggrega version`. Если установщик вывел строку, которую нужно добавить в мой `PATH`, покажите её мне.

2. Если на странице `https://aggrega.ai/docs/ai-assistants/skill/` описан способ установить в вас плагин Aggrega, спросите меня, прежде чем устанавливать его, затем установите его этим способом или скажите мне, что сделать, если это шаг, который я выполняю в вашем интерфейсе. Плагин добавляет навык Aggrega и подключает вас к MCP-серверу Aggrega. Иначе выполните `aggrega skills install --help` и найдите свой идентификатор в выведенном списке. Спросите меня, нужен ли мне навык в этом проекте или во всех проектах, затем выполните `aggrega skills install --agent <your identifier>`, добавив `--global` для всех проектов. Если вас нет в списке, пропустите установку навыка и сообщите об этом.

3. Если вы установили плагин, вы уже подключены к MCP-серверу Aggrega. Иначе подключитесь к MCP-серверу Aggrega, то есть к команде `aggrega mcp`, тем способом, которым вы добавляете MCP-сервер, как описано для вас на `https://aggrega.ai/docs/ai-assistants/mcp-server/`. Если для загрузки плагина или сервера нужен перезапуск или перезагрузка, скажите мне, что сделать.

4. После подключения вызовите инструмент `describe-capabilities` без аргументов и кратко изложите, что он перечисляет.

Навык
Объясняет ассистенту, как устроен цикл написания, и велит брать каждый ответ о схеме или файле у бинарного файла aggrega.
MCP-сервер
aggrega mcp даёт ассистенту инструменты Aggrega: scaffold, validate, build и остальные.
Что меняется от одного ассистента к другому

Как это работает

Вы описываете приложение, Aggrega записывает файлы, а инструменты, которыми вы уже пользуетесь, их развёртывают. Aggrega никогда не обращается к работающему кластеру или облачной учётной записи.

Aggregateописывает ваше приложение
Releaseнастройки одного окружения
Manifestкак собирается каждая часть
aggrega buildодинаковый вход, одинаковые файлы
  • Kubernetes
  • Helm
  • Compose
  • Terraform
  • CloudFormation

файлы, которые вы проверяете и которыми владеете

Вне Aggrega
ArgoCD · Flux · Terraformразвёртывают то, что она записала
Aggrega останавливается на файлах. Она никогда не обращается к работающему кластеру или облачной учётной записи; то, что она записала, развёртывают ваши собственные инструменты.
  1. Опишите приложение

    Aggregate перечисляет свои компоненты и то, как они соединяются.

  2. Выберите среду

    Release задаёт настройки этой среды.

  3. Выберите, как собирается каждая часть

    Manifest сопоставляет каждый компонент с сущностью Recipe для вашей платформы, например с чартом Helm, модулем Terraform или контейнером.

  4. Запустите aggrega build

    Команда записывает файлы для каждой платформы: для одних и тех же входных данных — одни и те же файлы, каждый раз.

  5. Развёртывайте своими инструментами

    То, что она записала, развёртывают ArgoCD, Flux или Terraform.

Что можно создать

Начните с готового к запуску примера или с компонентов каталога.

  • ИИ-агенты и шлюзы

    Агенты, созданные с помощью LangGraph, CrewAI, LlamaIndex, Dify, n8n и других, за шлюзами моделей с бюджетами токенов, семантическим кэшированием, маскированием логов и защитой от внедрения промптов.

    Агент за шлюзом с бюджетом токенов
  • Традиционные рабочие нагрузки

    Базы данных, кэши, брокеры сообщений и управление идентификацией, например PostgreSQL, MariaDB, Redis, Kafka и Keycloak.

    Одна база данных PostgreSQL, развёрнутая тремя способами
  • Features

    Возможности, которые вы подключаете для каждой среды, не затрагивая приложение, например защита от prompt injection, маскирование конфиденциальных данных, HTTPS-ingress, мониторинг и резервное копирование.

    Шлюз, который проверяет каждый запрос на prompt injection
  • Одно приложение, много платформ

    Один и тот же Aggregate собирается для Docker Compose на ноутбуке и для Kubernetes в продакшене: смена цели меняет сопоставление, а не ваш код.

    Один Aggregate, собранный для Compose и Kubernetes
    aggregate.yamlпишется один раз

    На ноутбуке

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

    В кластере Kubernetes

    release-helm-synth.yaml
    manifest-helm-synth.yaml
    aggrega build
    манифесты Kubernetes
    Каждая платформа собирается из собственных сущностей Release и Manifest. Сущность Aggregate, описывающая ваше приложение, остаётся прежней.
  • Управление и политики

    Ваши политики подключаются к компилятору и останавливают сборку, которая их нарушает, сообщая, что нужно исправить.

    Одна политика, проверенная на четырёх целях
    aggrega build
    ваша политикаподключена к компилятору
    успех
    файлы записаныготовы к проверке и развёртыванию
    сбой
    сборка остановленаpolicy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted
    Политика может остановить сборку и сказать, что исправить. Она никогда не изменяет ваши файлы, чтобы они прошли проверку.
  • Воспроизводимые сборки

    Одинаковые входные данные — одинаковый результат, а каждая зависимость закреплена в lock-файле.

    Соберите пример и его lock-файл
  • Каталог стандартной библиотеки

    Components для агентов, моделей, шлюзов, хранилищ данных, обмена сообщениями, наблюдаемости, безопасности и хранения, готовые к использованию в сущности Aggregate.

    Обзор каталога

Ваш ассистент вместе с Aggrega

Что получает ассистент, пишущий ваш инфраструктурный код, когда работает через Aggrega.

Воспроизводимость
Те же входные данные — те же файлы, а каждая зависимость закреплена в lock-файле.
Одно описание
Одно описание приложения, собранное для каждой платформы, на которой оно работает.
Политики во время сборки
Ваши политики выполняются в компиляторе и останавливают сборку, которая их нарушает.
Подписанный каталог с версиями
Всё, что ассистент загружает из каталога, имеет версию и подпись, а при загрузке проверяется каждая подпись.
Проверено компилятором
Ассистент выполняет валидацию и сборку с помощью бинарного файла aggrega и получает от него ответы о схемах и файлах.

Целевые платформы

Каждая платформа получает файлы, которые она читает нативно. ИИ-агенты работают в любом кластере Kubernetes, а многие — и в Compose.

Kubernetes
Манифесты Kubernetes, по одному файлу на ресурс, для применения через ArgoCD или Flux.
Helm
Helm-чарты, отрендеренные в манифесты Kubernetes.
Compose
Файл Docker Compose, чтобы запускать приложение на ноутбуке.
Terraform
Конфигурация для управляемых облачных сервисов. Aggrega никогда не запускает Terraform.
CloudFormation
Шаблоны стеков для AWS. Aggrega никогда не запускает CloudFormation.
Что записывает каждая цель

Импорт

aggrega import читает проект в одном из этих форматов и записывает черновые файлы Aggrega, которые вы просматриваете и редактируете.

  • LangGraph
  • CrewAI
  • n8n
  • Dify
  • Langflow
  • Flowise
  • Google ADK
  • Microsoft Agent Framework
  • MCP client configurations
  • Compose
aggrega import
черновые файлы Aggregaдля проверки и правки
На входе ваш существующий проект, на выходе черновые файлы Aggrega. Ничего не развёртывается; сначала вы проверяете черновики.
Как работает импорт

Начать

  • Быстрый старт

    Установите Aggrega, соберите готовый к запуску пример, запустите его на своём компьютере, а затем расширяйте его шаг за шагом.

    Начало работы
  • Запустите первый пример

    Каждый готовый к запуску пример — это полноценное рабочее пространство, которое вы собираете с помощью CLI aggrega.

    Посмотреть примеры
  • Установка

    Одна команда устанавливает бинарный файл aggrega для вашего пользователя, без прав администратора.

    Установить бинарный файл

Открытый исходный код

Компилятор Aggrega распространяется с открытым исходным кодом по лицензии Apache-2.0 и останется таким: закрытой редакции компилятора не будет, как и модели open-core. Все возможности компилятора будут доступны в версии с открытым исходным кодом.

  • Компилятор

    Бинарный файл aggrega и его интерфейс командной строки.

    aggrega-ai/aggrega-cli на GitHub
  • Visual Studio Code

    Проверка, навигация, подсказки при наведении и автодополнение для YAML Aggrega на основе бинарного файла aggrega.

    Расширение на GitHub