Цю сторінку перекладено за допомогою машинного перекладу. Читати англійський оригінал.
Опишіть архітектуру один раз.Отримайте інфраструктурний код для кожної платформи, яку ви використовуєте.
Aggrega — це компілятор із відкритим кодом для інфраструктури як коду: один YAML-опис вашого застосунку перетворюється на файли Kubernetes, Helm, Compose, Terraform або CloudFormation, які ви переглядаєте і якими володієте.
Уже створили агента за допомогою LangGraph, CrewAI, n8n, Dify тощо? Імпортуйте його.
Linux і macOS
curl -fsSL https://aggrega.ai/install.sh | shWindows, у 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/valkeyaggrega 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 ніколи не звертається до запущеного кластера чи хмарного облікового запису.
- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation
файли, які ви переглядаєте і якими володієте
Опишіть застосунок
Сутність Aggregate називає свої компоненти та те, як вони з’єднуються.
Виберіть середовище
Сутність Release заповнює налаштування цього середовища.
Виберіть, як збирається кожна частина
Сутність Manifest зіставляє кожен компонент із сутністю Recipe для вашої платформи, як-от Helm-чарт, модуль Terraform або контейнер.
Запустіть aggrega build
Команда записує файли для кожної платформи: щоразу ті самі файли для тих самих вхідних даних.
Розгортайте своїми інструментами
Те, що вона записала, розгортають ArgoCD, Flux або Terraform.
Що можна створити
Почніть із готового до запуску прикладу або з компонентів каталогу.
ШІ-агенти та шлюзи
Агенти, створені за допомогою LangGraph, CrewAI, LlamaIndex, Dify, n8n та інших, за шлюзами моделей із бюджетами токенів, семантичним кешуванням, маскуванням журналів і захистом від ін’єкцій у промпти.
Агент за шлюзом із бюджетом токенівТрадиційні робочі навантаження
Бази даних, кеші, брокери повідомлень і керування ідентичністю, наприклад PostgreSQL, MariaDB, Redis, Kafka і Keycloak.
Одна база даних PostgreSQL, розгорнута трьома способамиFeatures
Можливості, які ви під’єднуєте для кожного середовища окремо, не змінюючи застосунок, наприклад захист від ін’єкцій промптів, маскування чутливих даних, HTTPS-ingress, моніторинг і резервні копії.
Шлюз, що перевіряє кожен запит на ін’єкції промптівОдин застосунок, багато платформ
Та сама сутність Aggregate збирається для Docker Compose на ноутбуці та для Kubernetes у робочому середовищі: зміна цілі змінює зіставлення, а не ваш код.
Одна сутність Aggregate, зібрана для Compose і Kubernetesaggregate.yamlнаписано один разНа ноутбуці
release-compose.yamlmanifest-compose.yamlaggrega builddocker-compose.yamlУ кластері Kubernetes
release-helm-synth.yamlmanifest-helm-synth.yamlaggrega 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, зберіть приклад, готовий до запуску, запустіть його на своєму комп’ютері, а потім розширюйте його крок за кроком.
Початок роботиЗапустіть перший приклад
Кожен готовий до запуску приклад — це повний робочий простір, який ви збираєте за допомогою CLI aggrega.
Переглянути прикладиУстановлення
Одна команда встановлює бінарний файл aggrega для вашого користувача, без прав адміністратора.
Установити бінарний файл
Відкритий код
Компілятор Aggrega — програмне забезпечення з відкритим кодом за ліцензією Apache-2.0, і таким він залишиться: закритої редакції компілятора не буде, як і моделі open-core. Усі функції компілятора будуть доступні у версії з відкритим кодом.
Компілятор
Бінарний файл aggrega та його інтерфейс командного рядка.
aggrega-ai/aggrega-cli на GitHubVisual Studio Code
Перевірка, навігація, підказки під час наведення та автодоповнення для YAML Aggrega, на основі бінарного файлу aggrega.
Розширення на GitHub