本页面为机器翻译。阅读英文原文。
架构只需描述一次。为你运行的每个平台获得基础设施代码。
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两个快速入门示例,一步一步搭建起来:一个运行在本地模型上的 AI 智能体,以及一个使用 PostgreSQL 的 Web 应用。每一步都会显示它改动的文件及新增的行、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
与你的 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 等。
工作原理
你描述应用,Aggrega 写出文件,再由你已在使用的工具部署它们。Aggrega 从不接触正在运行的集群或云账户。
- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation
由你审阅并归你所有的文件
描述应用
一个 Aggregate 列明它的组件以及组件之间的连接方式。
选择环境
一个 Release 填入该环境的设置。
选择每个部分的构建方式
一个 Manifest 将每个组件映射到适用于你的平台的 Recipe,例如 Helm chart、Terraform 模块或容器。
运行 aggrega build
它为每个平台写出文件:相同的输入,每次都得到相同的文件。
用你的工具部署
它写出的内容由 ArgoCD、Flux 或 Terraform 部署。
你可以构建什么
从一个可运行的示例开始,或从目录中的组件开始。
AI 智能体与网关
用 LangGraph、CrewAI、LlamaIndex、Dify、n8n 等构建的智能体,运行在模型网关之后,具备 token 预算、语义缓存、日志脱敏和提示注入防护。
位于网关之后、带有 token 预算的智能体传统工作负载
数据库、缓存、消息代理和身份认证,例如 PostgreSQL、MariaDB、Redis、Kafka 和 Keycloak。
一个 PostgreSQL 数据库,三种部署方式Features
按环境附加、无需改动应用程序的能力,例如提示词注入防护、敏感数据脱敏、HTTPS 入口、监控和备份。
对每个请求进行提示词注入筛查的网关一个应用,多个平台
同一个 Aggregate 既可为笔记本电脑上的 Docker Compose 构建,也可为生产环境中的 Kubernetes 构建:更换目标改变的是映射,而不是你的代码。
一个 Aggregate,分别为 Compose 和 Kubernetes 构建aggregate.yaml只需编写一次在笔记本电脑上
release-compose.yamlmanifest-compose.yamlaggrega builddocker-compose.yaml在 Kubernetes 集群上
release-helm-synth.yamlmanifest-helm-synth.yamlaggrega buildKubernetes 清单每个平台都由各自的 Release 和 Manifest 构建。描述你的应用的 Aggregate 保持不变。 - aggrega build你的策略接入编译器通过文件已写出可供审阅和部署失败构建已停止policy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted
策略可以停止构建并说明需要修复什么。它从不为了让文件通过而修改你的文件。 可复现的构建
相同的输入,相同的输出,每个依赖都锁定在锁文件中。
构建一个示例及其锁文件标准库目录
面向智能体、模型、网关、数据存储、消息传递、可观测性、安全和存储的 Components,可直接在 Aggregate 中使用。
浏览目录
你的助手,搭配 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。
导入
aggrega import 读取以下任一格式的项目,并写出 Aggrega 草稿文件,供你审阅和编辑。
- LangGraph
- CrewAI
- n8n
- Dify
- Langflow
- Flowise
- Google ADK
- Microsoft Agent Framework
- MCP client configurations
- Compose
开源
Aggrega 编译器基于 Apache-2.0 开源,并将一直如此:编译器将不会有闭源版本,也不会采用 open-core 模式。编译器的所有功能都将在开源版本中提供。
编译器
aggrega 二进制文件及其命令行界面。
GitHub 上的 aggrega-ai/aggrega-cliVisual Studio Code
为 Aggrega YAML 提供验证、导航、悬停提示和补全,由 aggrega 二进制文件提供支持。
GitHub 上的扩展