# Aggrega

> Aggrega 是一个面向基础设施即代码的开源编译器：你的应用只需一份 YAML 描述，即可变成由你审阅、归你所有的 Kubernetes、Helm、Compose、Terraform 或 CloudFormation 文件。

URL: https://aggrega.ai/zh-cn/

## 架构只需描述一次。 为你运行的每个平台获得基础设施代码。

Aggrega 是一个面向基础设施即代码的开源编译器：你的应用只需一份 YAML 描述，即可变成由你审阅、归你所有的 **Kubernetes**、**Helm**、**Compose**、**Terraform** 或 **CloudFormation** 文件。

已经用 **LangGraph**、**CrewAI**、**n8n**、**Dify** 等构建了智能体？直接导入。

[用你的 AI 助手完成设置](https://aggrega.ai/zh-cn/#ai-assistant)[快速入门](https://aggrega.ai/docs/zh-cn/getting-started/)[导入你的项目](https://aggrega.ai/zh-cn/#import)

Linux 和 macOS

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

Windows，在 PowerShell 中

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

两个快速入门示例，一步一步搭建起来：一个运行在本地模型上的 AI 智能体，以及一个使用 PostgreSQL 的 Web 应用。每一步都会显示它改动的文件及新增的行、aggrega build 命令，以及构建写出的文件。

### 与你的 AI 助手协同工作

把这段提示词粘贴到能够运行命令的助手中，它就会安装 Aggrega、为自己添加 Aggrega 技能，并连接到 Aggrega MCP 服务器。该提示词会让它在安装任何东西之前先征得你的同意。

提示词

请一步一步地为我设置 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 技能，并将你连接到 Aggrega MCP 服务器。否则，运行 `aggrega skills install --help`，并在它打印的列表中找到你自己的标识符。问我想把该技能安装在这个项目中还是所有项目中，然后运行 `aggrega skills install --agent <your identifier>`，如果是所有项目则加上 `--global`。如果你不在列表中，就跳过安装该技能，并告诉我。

3. 如果你已安装该插件，你就已经连接到 Aggrega MCP 服务器了。否则，按照你添加 MCP 服务器的方式，把自己连接到 Aggrega MCP 服务器（即命令 `aggrega mcp`），具体方法见 `https://aggrega.ai/docs/ai-assistants/mcp-server/` 中针对你的说明。如果需要重启或重新加载才能载入该插件或服务器，请告诉我该怎么做。

4. 连接成功后，不带参数调用 `describe-capabilities` 工具，并总结它列出的内容。

**显示完整提示词**

- **技能** — 告诉助手编写循环如何进行，并让它关于 schema 或文件的每个答案都从 aggrega 二进制文件获取。

- **MCP 服务器** — aggrega mcp 为助手提供 Aggrega 的工具：scaffold、validate、build 等。

[不同助手之间的差异](https://aggrega.ai/docs/zh-cn/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 chart、Terraform 模块或容器。

#### 运行 aggrega build

它为每个平台写出文件：相同的输入，每次都得到**相同的文件**。

#### 用你的工具部署

它写出的内容由 **ArgoCD**、**Flux** 或 **Terraform** 部署。

### 你可以构建什么

从一个可运行的示例开始，或从目录中的组件开始。

#### AI 智能体与网关

用 LangGraph、CrewAI、LlamaIndex、Dify、n8n 等构建的智能体，运行在模型网关之后，具备 token 预算、语义缓存、日志脱敏和提示注入防护。

[位于网关之后、带有 token 预算的智能体](https://aggrega.ai/docs/zh-cn/language-reference/examples/envoy-ai-gateway-token-budget/)

#### 传统工作负载

数据库、缓存、消息代理和身份认证，例如 PostgreSQL、MariaDB、Redis、Kafka 和 Keycloak。

[一个 PostgreSQL 数据库，三种部署方式](https://aggrega.ai/docs/zh-cn/language-reference/examples/postgres-three-realizations/)

#### Features

按环境附加、无需改动应用程序的能力，例如提示词注入防护、敏感数据脱敏、HTTPS 入口、监控和备份。

[对每个请求进行提示词注入筛查的网关](https://aggrega.ai/docs/zh-cn/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### 一个应用，多个平台

同一个 Aggregate 既可为笔记本电脑上的 Docker Compose 构建，也可为生产环境中的 Kubernetes 构建：更换目标改变的是映射，而不是你的代码。

[一个 Aggregate，分别为 Compose 和 Kubernetes 构建](https://aggrega.ai/docs/zh-cn/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/zh-cn/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

策略可以停止构建并说明需要修复什么。它从不为了让文件通过而修改你的文件。

#### 可复现的构建

相同的输入，相同的输出，每个依赖都锁定在锁文件中。

[构建一个示例及其锁文件](https://aggrega.ai/docs/zh-cn/language-reference/examples/ai-agent-and-model-router/#building)

#### 标准库目录

面向智能体、模型、网关、数据存储、消息传递、可观测性、安全和存储的 Components，可直接在 Aggregate 中使用。

[浏览目录](https://aggrega.ai/catalog/zh-cn/browse)

### 你的助手，搭配 Aggrega

为你编写基础设施代码的助手，通过 Aggrega 工作能获得哪些好处。

- **可复现** — 相同的输入，相同的文件，所有依赖都锁定在锁文件中。

- **一份描述** — 对应用程序的一份描述，为其运行的每个平台构建。

- **构建时的策略** — 你的策略在编译器中运行，并阻止违反策略的构建。

- **经过签名、带版本的目录** — 助手从目录中拉取的内容都带有版本并经过签名，拉取时会验证每个签名。

- **由编译器检查** — 助手使用 aggrega 二进制文件进行验证和构建，并从中获取关于 schema 和文件的答案。

### 目标

每个平台都会获得它原生读取的文件。AI 智能体可在任何 Kubernetes 集群上运行，其中许多也可在 Compose 上运行。

- **Kubernetes** — Kubernetes 清单，每个资源一个文件，供 ArgoCD 或 Flux 应用。

- **Helm** — Helm chart，渲染为 Kubernetes 清单。

- **Compose** — 一个 Docker Compose 文件，用于在笔记本电脑上运行应用。

- **Terraform** — 托管云服务的配置。Aggrega 从不运行 Terraform。

- **CloudFormation** — 面向 AWS 的堆栈模板。Aggrega 从不运行 CloudFormation。

[各目标写出的内容](https://aggrega.ai/docs/zh-cn/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/zh-cn/authoring/import/)

### 开始使用

#### 快速入门

安装 Aggrega，构建一个可运行的示例，在你的机器上运行它，然后一步一步地扩展它。

[入门](https://aggrega.ai/docs/zh-cn/getting-started/)

#### 运行第一个示例

每个可运行示例都是一个完整的工作区，你可以用 aggrega CLI 构建它。

[浏览示例](https://aggrega.ai/docs/zh-cn/language-reference/examples/)

#### 安装

一条命令即可为你的用户安装 aggrega 二进制文件，无需管理员权限。

[安装二进制文件](https://aggrega.ai/docs/zh-cn/install/#install-the-binary)

### 开源

Aggrega 编译器基于 Apache-2.0 开源，并将一直如此：编译器将不会有闭源版本，也不会采用 open-core 模式。编译器的所有功能都将在开源版本中提供。

#### 编译器

aggrega 二进制文件及其命令行界面。

[GitHub 上的 aggrega-ai/aggrega-cli](https://github.com/aggrega-ai/aggrega-cli)

#### Visual Studio Code

为 Aggrega YAML 提供验证、导航、悬停提示和补全，由 aggrega 二进制文件提供支持。

[GitHub 上的扩展](https://github.com/aggrega-ai/aggrega-vscode-extension)
