跳至内容
Aggrega

本页面为机器翻译。阅读英文原文。

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

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

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

Linux 和 macOS

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

Windows,在 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/valkey

aggrega 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 从不接触正在运行的集群或云账户。

Aggregate描述你的应用
Release一个环境的设置
Manifest每个部分如何构建
aggrega build相同输入,相同文件
  • Kubernetes
  • Helm
  • Compose
  • Terraform
  • CloudFormation

由你审阅并归你所有的文件

Aggrega 之外
ArgoCD · Flux · Terraform部署它写出的内容
Aggrega 止步于文件。它从不接触运行中的集群或云账户;由你自己的工具部署它写出的内容。
  1. 描述应用

    一个 Aggregate 列明它的组件以及组件之间的连接方式。

  2. 选择环境

    一个 Release 填入该环境的设置。

  3. 选择每个部分的构建方式

    一个 Manifest 将每个组件映射到适用于你的平台的 Recipe,例如 Helm chart、Terraform 模块或容器。

  4. 运行 aggrega build

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

  5. 用你的工具部署

    它写出的内容由 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.yaml
    manifest-compose.yaml
    aggrega build
    docker-compose.yaml

    在 Kubernetes 集群上

    release-helm-synth.yaml
    manifest-helm-synth.yaml
    aggrega 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
    策略可以停止构建并说明需要修复什么。它从不为了让文件通过而修改你的文件。
  • 可复现的构建

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

    构建一个示例及其锁文件
  • 标准库目录

    面向智能体、模型、网关、数据存储、消息传递、可观测性、安全和存储的 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 import
Aggrega 草稿文件供你审阅和编辑
输入你现有的项目,输出 Aggrega 草稿文件。不会部署任何内容;你先审阅这些草稿。
导入的工作原理

开始使用

  • 快速入门

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

    入门
  • 运行第一个示例

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

    浏览示例
  • 安装

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

    安装二进制文件

开源

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