Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Aggrega

Что такое Aggrega

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

  • Используйте языки, которые вы знаете. Компилятор для языков, которыми вы уже пользуетесь: на входе YAML; на выходе чарты Helm, манифесты Kubernetes и файлы Compose, Terraform или CloudFormation.
  • Разработчики описывают, Ops реализует. Разработчики объявляют компоненты, их возможности и то, кто кого использует; команда платформы решает, как и где запускается каждый из них.
  • Одно приложение, много платформ. Одно и то же приложение работает в Docker Compose на ноутбуке и в Kubernetes в продакшене: смена цели меняет отображение, а не ваш код.
  • Воспроизводимо и управляемо. Тот же вход — тот же выход, и каждая зависимость закреплена в lockfile. Ваши политики подключаются к компилятору и останавливают сборку, которая их нарушает, указывая, что исправить.

Aggrega по-итальянски означает «собирает воедино»: название говорит о том, что делает инструмент, который собирает части приложения в одно описание.

  • Используйте с ИИ-ассистентом

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

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

    Установите Aggrega, запишите работающий пример в папку и запустите его на своём компьютере, а затем развивайте его шаг за шагом: ИИ-агент на локальной модели или веб-приложение с PostgreSQL.

  • Изучите Aggrega

    Путь по документации в порядке чтения, от назначения Aggrega до справочника по языку.

Установка

В Linux и macOS:

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

В Windows, в PowerShell:

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

Любая из этих команд устанавливает бинарный файл aggrega для текущего пользователя. Раздел Установка описывает, что делает команда, Homebrew, Scoop, winget и ручную загрузку; раздел Подключение MCP-сервера описывает подключение ИИ-ассистента. Расширение Aggrega для Visual Studio Code добавляет валидацию, навигацию, всплывающие подсказки и автодополнение для YAML Aggrega на основе бинарного файла aggrega.

Документация

Документация для пользователей языка и компилятора Aggrega, написанная на английском и переведённая на все остальные языки, которые предлагает сайт. Она состоит из трёх частей.

  • Архитектура — «почему» Aggrega. Видение, позиционирование, ментальная модель, конвейер компилятора на концептуальном уровне, корпоративное управление, каталог, расширяемость, проектные решения. При первом чтении изучайте пронумерованные главы с 01 по 16 по порядку.
  • Руководство по написанию — «как сесть и начать писать» в Aggrega. Цикл написания, четыре взаимодействующие роли, соответствие kind ролям и способ подключить ИИ-ассистента через сервер Model Context Protocol. Начните с раздела Написание файлов Aggrega; чтобы ваш ИИ-ассистент сам установил и настроил Aggrega, вставьте промпт из раздела Настройка Aggrega с ИИ-ассистентом.
  • Справочник по языку — «что» и «как использовать» Aggrega. Начните с Состояния языка, чтобы узнать текущий уровень готовности, а затем при первом чтении изучайте пронумерованные главы с 01 по 09 по порядку. Ненумерованные подкаталоги (entities/, vocabulary/, templates/, providers/, plugins/, schema/, cli/, errors/, examples/) являются справочными каталогами — переходите к конкретным элементам по мере необходимости.

Об Aggrega

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

Экосистема опирается на четыре столпа:

  1. Модель разделения (вдохновлённая OAM): проектное руководство, которое отделяет намерение разработчика (абстрактные «Что» и «Сколько») от физической реальности Platform Ops (физических «Как» и «Где»). Компилятор не навязывает это разделение: он принимает любой шаблон написания, который проходит валидацию по схеме.
  2. Семантический DSL & операционная онтология: разработчики отображают свою архитектуру с помощью закрытого набора универсальных облачных примитивов (например, server, worker, stateful-server) на зарезервированной метке component.aggrega.ai/type платформы Aggrega. Весь расширенный контекст—например, автономность агентов ИИ, генеративные возможности или соответствие данных требованиям—накладывается поверх с помощью статических меток Duck-Typing, а каталог, классифицирующий компоненты по собственной оси, добавляет собственный ключ метки.
  3. Программируемые политики & валидация: базовый компилятор на Go без собственного мнения. Корпоративное управление полностью основано на отраслевых стандартах и подключаемом WebAssembly: JSON Schema 2020-12 (записанной в компактной сокращённой нотации в форме YAML или в полном JSON Schema YAML) для валидации каталога, роли label-transform сокета управления для динамической маркировки топологии и его ролях вердикта для оценки архитектурных границ безопасности.
  4. Компилятор AOT & передача на исполнение: строгий конвейер компиляции преобразует DSL в граф промежуточного представления (IR), агностичный по отношению к возможностям. IR фиксирует топологию компонентов и рёбра uses между ними (кто кого использует); компилятор передаёт этот граф сокету управления WebAssembly (Wasm) для обнаружения транзитивных уязвимостей доверия, а затем выполняет плагины рендеринга Wasm, чтобы сгенерировать точные конфигурации прокси и защитных ограничений. Aggrega записывает эти артефакты на диск и передаёт их другим инструментам, таким как конвейеры CI/CD или оркестраторы среды выполнения, которые их развёртывают.

Лицензия

Документация Aggrega распространяется по лицензии Apache License, Version 2.0; полный текст приведён в файле LICENSE её репозитория.