Перейти до вмісту
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, а потім установіть 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

    Можливості, які ви під’єднуєте для кожного середовища окремо, не змінюючи застосунок, наприклад захист від ін’єкцій промптів, маскування чутливих даних, HTTPS-ingress, моніторинг і резервні копії.

    Шлюз, що перевіряє кожен запит на ін’єкції промптів
  • Один застосунок, багато платформ

    Та сама сутність 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