Aggrega
什么是 Aggrega
Aggrega 是一个面向 AI 时代架构的开源编译器。描述应用的各个组件及其连接方式;Aggrega 会以确定性的方式将它们转换为运行该应用的部署文件。
- 使用你熟悉的语言。 一个面向你已在使用的语言的编译器:输入 YAML;输出 Helm chart、Kubernetes 清单以及 Compose、Terraform 或 CloudFormation 文件。
- 开发者描述,运维实现。 开发者声明组件、组件的特性以及谁使用谁;平台团队决定每个组件如何运行、在哪里运行。
- 一个应用,多个平台。 同一个应用既能在笔记本电脑上的 Docker Compose 中运行,也能在生产环境的 Kubernetes 上运行:更换目标只会更改映射,而不会更改你的代码。
- 可复现且受治理。 相同的输入,相同的输出,每个依赖都锁定在 lockfile 中。你的策略接入编译器,会阻止违反策略的构建,并说明需要修复什么。
Aggrega 在意大利语中意为“它汇聚在一起”:这个名字说明了这个工具的作用,即把一个应用程序的各个部分汇聚成一份描述。
-
将一条提示词粘贴到能够运行命令的助手中:它会安装 Aggrega、添加 Aggrega 技能并连接到 Aggrega MCP 服务器,在安装任何东西之前都会先征得你的确认。
-
安装 Aggrega,把一个可运行的示例写入文件夹并在你的机器上运行,然后一步一步地扩展它:一个在本地模型上运行的 AI 代理,或一个使用 PostgreSQL 的 Web 应用。
-
按阅读顺序贯穿文档的一条路径,从 Aggrega 的用途一直到语言参考。
安装
在 Linux 和 macOS 上:
curl -fsSL https://aggrega.ai/install.sh | sh在 Windows 上,在 PowerShell 中执行:
irm https://aggrega.ai/install.ps1 | iex任一命令都会为当前用户安装 aggrega 二进制文件。安装介绍了该命令的作用、Homebrew、Scoop、winget 和手动下载;连接 MCP 服务器介绍如何连接 AI 助手。Visual Studio Code 的 Aggrega 扩展以 aggrega 二进制文件为后端,为 Aggrega YAML 提供验证、导航、悬停提示和补全。
文档
面向用户的 Aggrega 语言与编译器文档,以英文编写,并翻译成本站提供的所有其他语言。文档分为三个部分。
- 架构 — Aggrega 的“为什么”。愿景、定位、心智模型、概念层面的编译器流水线、企业治理、目录、可扩展性、设计选择。初次阅读时,请按顺序阅读编号为 01 到 16 的章节。
- 编写指南 — Aggrega 的“如何坐下来动手编写”。编写循环、四个协作角色、kind 到角色的映射,以及如何通过 Model Context Protocol 服务器连接 AI 助手。从编写 Aggrega 文件开始;若要让你的 AI 助手自行安装并配置 Aggrega,请粘贴用你的 AI 助手设置 Aggrega中的提示词。
- 语言参考 — Aggrega 的“是什么”和“如何使用”。先阅读语言状态了解当前的就绪程度,然后在初次阅读时按顺序阅读编号为 01 到 09 的章节。未编号的子目录(entities/、vocabulary/、templates/、providers/、plugins/、schema/、cli/、errors/、examples/)是参考目录 — 按需跳转到具体条目。
关于 Aggrega
Aggrega 编译器以 Apache-2.0 许可开源,并将一直保持开源:编译器将不会有闭源版本,也不会有 open-core 模式。编译器的所有功能都将在开源版本中提供。
该生态系统建立在四大支柱之上:
- **分离模型(受 OAM 启发):**一种设计指导,将开发者意图(抽象的“什么”和“多少”)与 Platform Ops 的物理现实(物理的“如何”和“何处”)分离。编译器并不强制这种划分:它接受任何通过 schema 验证的编写模式。
- **语义 DSL & 运维本体:**开发者使用一组封闭的通用云原语(例如
server、worker、stateful-server),在 Aggrega 保留的component.aggrega.ai/type标签上映射其架构。所有高级上下文——例如 AI 智能体的自主性、生成能力或数据合规性——都通过静态的 Duck-Typing 标签叠加在其上,而一个按自身维度对组件进行分类的目录会添加一个属于自己的标签键。 - **可编程策略 & 验证:**核心 Go 编译器不预设立场。企业治理完全由行业标准和可插拔的 WebAssembly 驱动:JSON Schema 2020-12(通过紧凑的 YAML 形式简写或完整的 JSON Schema YAML 编写)用于目录验证,治理插槽的
label-transform角色用于动态拓扑标记,其裁决角色用于评估架构安全边界。 - **AOT 编译器 & 执行移交:**严格的编译流水线将 DSL 转换为与能力无关的中间表示(IR)图。IR 捕获组件的拓扑以及组件之间的
uses边(谁使用谁);编译器将该图传递给 WebAssembly(Wasm)治理插槽以检测传递性信任漏洞,然后执行 Wasm 渲染插件,生成精确的代理和护栏配置。Aggrega 将这些制品写入磁盘,并将它们移交给其他工具(例如 CI/CD 流水线或运行时编排器),由这些工具进行部署。
许可证
Aggrega 文档依据 Apache License, Version 2.0 发布;完整文本见其仓库中的 LICENSE 文件。