このページは機械翻訳されました。英語の原文を読む。
アーキテクチャは一度記述するだけ。運用する各プラットフォーム向けのインフラストラクチャコードが得られます。
Aggrega は Infrastructure as Code のためのオープンソースのコンパイラです。アプリケーションを記述した 1 つの 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 | iex1 ステップずつ組み立てる 2 つのクイックスタート例:ローカルモデルで動く 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 サーバーに接続されています。そうでない場合は、Aggrega MCP サーバー(コマンド `aggrega mcp`)に、MCP サーバーを追加する通常の方法で、`https://aggrega.ai/docs/ai-assistants/mcp-server/` にある自分向けの説明に従って接続してください。プラグインやサーバーを読み込むために再起動や再読み込みが必要な場合は、私が何をすればよいかを教えてください。
4. 接続できたら、引数なしで `describe-capabilities` ツールを呼び出し、その一覧の内容を要約してください。
- スキル
- オーサリングループの進め方をアシスタントに伝え、スキーマやファイルに関する答えはすべて aggrega バイナリから得るよう指示します。
- MCP サーバー
- aggrega mcp は、scaffold、validate、build などの Aggrega のツールをアシスタントに提供します。
仕組み
アプリケーションを記述すると、Aggrega がファイルを書き出し、すでに使っているツールがそれをデプロイします。Aggrega が稼働中のクラスターやクラウドアカウントにアクセスすることはありません。
- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation
自分でレビューし、所有するファイル
アプリケーションを記述する
Aggregate は、そのコンポーネントと、それらの接続方法を指定します。
環境を選択
Release は、その環境の設定を埋めます。
各部分のビルド方法を選択
Manifest は、各コンポーネントを、Helm チャート、Terraform モジュール、コンテナなど、使用するプラットフォーム向けの Recipe に対応付けます。
aggrega build を実行する
プラットフォームごとにファイルを書き出します。同じ入力からは、毎回同じファイルが得られます。
使い慣れたツールでデプロイする
書き出されたものは ArgoCD、Flux、または Terraform がデプロイします。
構築できるもの
実行可能なサンプル、またはカタログのコンポーネントから始められます。
AI エージェントとゲートウェイ
LangGraph、CrewAI、LlamaIndex、Dify、n8n などで構築したエージェントを、トークン予算、セマンティックキャッシュ、ログのマスキング、プロンプトインジェクション対策を備えたモデルゲートウェイの背後に配置します。
トークン予算を持つゲートウェイの背後にあるエージェント従来型のワークロード
PostgreSQL、MariaDB、Redis、Kafka、Keycloak などのデータベース、キャッシュ、メッセージブローカー、ID 管理。
1 つの PostgreSQL データベースを 3 通りの方法でデプロイFeatures
アプリケーションに手を加えずに環境ごとに付加する機能。たとえば、プロンプトインジェクション対策、機密データのマスキング、HTTPS イングレス、モニタリング、バックアップなどです。
各リクエストのプロンプトインジェクションを検査するゲートウェイ1 つのアプリケーション、多数のプラットフォーム
同じ Aggregate から、ノート PC 上の Docker Compose 向けにも、本番環境の Kubernetes 向けにもビルドできます。ターゲットを変えて変わるのはマッピングであり、コードではありません。
1 つの Aggregate を Compose と Kubernetes 向けにビルドaggregate.yaml一度だけ記述ノート PC 上で
release-compose.yamlmanifest-compose.yamlaggrega builddocker-compose.yamlKubernetes クラスター上で
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 を通して作業することで得られるもの。
- 再現可能
- 同じ入力から同じファイル。すべての依存関係はロックファイルで固定されます。
- 1 つの記述
- アプリケーションの 1 つの記述を、それが動作するすべてのプラットフォーム向けにビルドします。
- ビルド時のポリシー
- ポリシーはコンパイラ内で実行され、違反するビルドを停止します。
- 署名付きでバージョン管理されたカタログ
- アシスタントがカタログから取得するものはバージョン管理され、署名されています。取得時には各署名が検証されます。
- コンパイラによるチェック
- アシスタントは aggrega バイナリで検証とビルドを行い、スキーマやファイルに関する答えをそこから得ます。
ターゲット
各プラットフォームには、それがネイティブに読み込むファイルが生成されます。AI エージェントはどの Kubernetes クラスターでも動作し、その多くは Compose でも動作します。
- Kubernetes
- Kubernetes マニフェスト。リソースごとに 1 ファイルで、ArgoCD や Flux が適用します。
- Helm
- Kubernetes マニフェストにレンダリングされる Helm チャート。
- Compose
- アプリケーションをノート PC 上で実行するための 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 をインストールし、実行可能なサンプルをビルドしてお使いのマシンで実行し、そのあと一歩ずつ拡張していきます。
はじめに最初のサンプルを実行する
実行可能な各サンプルは、aggrega CLI でビルドする完全なワークスペースです。
サンプルを見るインストール
1 つのコマンドで、管理者権限なしに aggrega バイナリを自分のユーザーにインストールできます。
バイナリをインストールする
オープンソース
Aggrega コンパイラーは Apache-2.0 のオープンソースであり、今後もそうあり続けます。コンパイラーのクローズドなエディションが作られることはなく、open-core にもなりません。コンパイラーのすべての機能は、オープンソース版で提供されます。
コンパイラ
aggrega バイナリとそのコマンドラインインターフェース。
GitHub の aggrega-ai/aggrega-cliVisual Studio Code
aggrega バイナリに支えられた、Aggrega YAML の検証、ナビゲーション、ホバー、補完。
GitHub の拡張機能