# Aggrega

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

URL: https://aggrega.ai/ru/

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

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

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

[Настройка с помощью вашего ИИ-ассистента](https://aggrega.ai/ru/#ai-assistant)[Быстрый старт](https://aggrega.ai/docs/ru/getting-started/)[Импортировать проект](https://aggrega.ai/ru/#import)

Linux и macOS

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

Windows, в PowerShell

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

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

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

Вставьте этот промпт в ассистента, который умеет выполнять команды, и он установит 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 и остальные.

[Что меняется от одного ассистента к другому](https://aggrega.ai/docs/ru/ai-assistants/set-up/)

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

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

Aggregate описывает ваше приложение

Release настройки одного окружения

Manifest как собирается каждая часть

aggrega build одинаковый вход, одинаковые файлы

- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation

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

Вне Aggrega

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

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

#### Опишите приложение

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

#### Выберите среду

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

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

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

#### Запустите aggrega build

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

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

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

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

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

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

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

[Агент за шлюзом с бюджетом токенов](https://aggrega.ai/docs/ru/language-reference/examples/envoy-ai-gateway-token-budget/)

#### Традиционные рабочие нагрузки

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

[Одна база данных PostgreSQL, развёрнутая тремя способами](https://aggrega.ai/docs/ru/language-reference/examples/postgres-three-realizations/)

#### Features

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

[Шлюз, который проверяет каждый запрос на prompt injection](https://aggrega.ai/docs/ru/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### Одно приложение, много платформ

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

[Один Aggregate, собранный для Compose и Kubernetes](https://aggrega.ai/docs/ru/language-reference/examples/mariadb-adminer/)

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, описывающая ваше приложение, остаётся прежней.

#### Управление и политики

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

[Одна политика, проверенная на четырёх целях](https://aggrega.ai/docs/ru/language-reference/examples/policy-render-verdict/)

aggrega build

ваша политика подключена к компилятору

успех

файлы записаны готовы к проверке и развёртыванию

сбой

сборка остановлена policy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted

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

#### Воспроизводимые сборки

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

[Соберите пример и его lock-файл](https://aggrega.ai/docs/ru/language-reference/examples/ai-agent-and-model-router/#building)

#### Каталог стандартной библиотеки

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

[Обзор каталога](https://aggrega.ai/catalog/ru/browse)

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

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

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

- **Одно описание** — Одно описание приложения, собранное для каждой платформы, на которой оно работает.

- **Политики во время сборки** — Ваши политики выполняются в компиляторе и останавливают сборку, которая их нарушает.

- **Подписанный каталог с версиями** — Всё, что ассистент загружает из каталога, имеет версию и подпись, а при загрузке проверяется каждая подпись.

- **Проверено компилятором** — Ассистент выполняет валидацию и сборку с помощью бинарного файла aggrega и получает от него ответы о схемах и файлах.

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

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

- **Kubernetes** — Манифесты Kubernetes, по одному файлу на ресурс, для применения через ArgoCD или Flux.

- **Helm** — Helm-чарты, отрендеренные в манифесты Kubernetes.

- **Compose** — Файл Docker Compose, чтобы запускать приложение на ноутбуке.

- **Terraform** — Конфигурация для управляемых облачных сервисов. Aggrega никогда не запускает Terraform.

- **CloudFormation** — Шаблоны стеков для AWS. Aggrega никогда не запускает CloudFormation.

[Что записывает каждая цель](https://aggrega.ai/docs/ru/language-reference/providers/reference-matrix/)

### Импорт

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

- LangGraph
- CrewAI
- n8n
- Dify
- Langflow
- Flowise
- Google ADK
- Microsoft Agent Framework
- MCP client configurations
- Compose

aggrega import

черновые файлы Aggrega для проверки и правки

На входе ваш существующий проект, на выходе черновые файлы Aggrega. Ничего не развёртывается; сначала вы проверяете черновики.

[Как работает импорт](https://aggrega.ai/docs/ru/authoring/import/)

### Начать

#### Быстрый старт

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

[Начало работы](https://aggrega.ai/docs/ru/getting-started/)

#### Запустите первый пример

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

[Посмотреть примеры](https://aggrega.ai/docs/ru/language-reference/examples/)

#### Установка

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

[Установить бинарный файл](https://aggrega.ai/docs/ru/install/#install-the-binary)

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

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

#### Компилятор

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

[aggrega-ai/aggrega-cli на GitHub](https://github.com/aggrega-ai/aggrega-cli)

#### Visual Studio Code

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

[Расширение на GitHub](https://github.com/aggrega-ai/aggrega-vscode-extension)
