コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

Aggrega

Aggrega とは

Aggrega は、AI 時代のアーキテクチャのためのオープンソースのコンパイラです。アプリケーションのコンポーネントとそれらの接続方法を記述すると、Aggrega がそれらを決定的に、アプリケーションを実行するデプロイファイルへと変換します。

  • 使い慣れた言語をそのまま使えます。 すでに使っている言語のためのコンパイラです。YAML を入力すると、Helm チャート、Kubernetes マニフェスト、そして Compose、Terraform、CloudFormation のファイルを出力します。
  • 開発者が記述し、Ops が実装します。 開発者はコンポーネント、その機能、そして誰が誰を使うかを宣言し、プラットフォームチームがそれぞれをどのように、どこで実行するかを決めます。
  • 1 つのアプリケーション、多数のプラットフォーム。 同じアプリケーションが、ノート PC 上の Docker Compose でも本番環境の Kubernetes でも動作します。ターゲットを変えるときに変わるのはマッピングであり、コードではありません。
  • 再現可能で、ガバナンスが効いています。 同じ入力からは同じ出力が得られ、すべての依存関係は lockfile で固定されます。ポリシーはコンパイラに組み込まれ、ポリシーに違反するビルドを停止して、何を修正すべきかを示します。

Aggrega はイタリア語で「まとめ上げる」という意味です。この名前は、アプリケーションの各部分を 1 つの記述に集めるという、このツールの役割を表しています。

  • AI アシスタントと一緒に使う

    コマンドを実行できるアシスタントに 1 つのプロンプトを貼り付けてください。アシスタントは Aggrega をインストールし、Aggrega スキルを追加し、Aggrega MCP サーバーに接続します。何かをインストールする前には必ず確認を求めます。

  • クイックスタート

    Aggrega をインストールし、実行可能なサンプルをフォルダーに書き出してお使いのマシンで実行し、そのあと一歩ずつ拡張していきます。ローカルモデルで動く AI エージェントか、PostgreSQL を使う Web アプリのどちらかを選べます。

  • Aggrega を学ぶ

    Aggrega の目的から言語リファレンスまで、ドキュメントを読む順にたどる道筋です。

インストール

Linux と macOS の場合:

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

Windows では、PowerShell で次を実行します。

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

どちらのコマンドも、現在のユーザー向けに aggrega バイナリをインストールします。インストールでは、コマンドの動作、Homebrew、Scoop、winget、手動ダウンロードについて説明しており、AI アシスタントの接続は MCP サーバーの接続で行います。Visual Studio Code 向け Aggrega 拡張機能は、aggrega バイナリをバックエンドとして、Aggrega YAML に検証、ナビゲーション、ホバー、補完を提供します。

ドキュメント

Aggrega の言語とコンパイラのユーザー向けドキュメントです。英語で書かれ、サイトが提供する他のすべての言語に翻訳されています。3 つの部分で構成されています。

  • アーキテクチャ — Aggrega の「なぜ」。ビジョン、ポジショニング、メンタルモデル、概念レベルでのコンパイラパイプライン、エンタープライズガバナンス、カタログ、拡張性、設計上の選択。初めて読む場合は、番号付きの章 01 から 16 までを順番に読んでください。
  • オーサリングガイド — Aggrega の「腰を据えてオーサリングする方法」。オーサリングのループ、協働する 4 つのロール、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 のもとでオープンソースとして公開されており、今後もそれは変わりません。コンパイラにクローズドなエディションが設けられることはなく、オープンコアになることもありません。コンパイラのすべての機能は、オープンソース版で提供されます。

このエコシステムは 4 つの柱の上に築かれています。

  1. 分離モデル(OAM に着想を得たもの): 開発者の意図(抽象的な「何を」と「どれだけ」)を Platform Ops の物理的な現実(物理的な「どのように」と「どこで」)から分離する設計上の指針です。コンパイラはこの分離を強制せず、スキーマ検証に通るあらゆるオーサリングパターンを受け入れます。
  2. セマンティック DSL & 運用オントロジー: 開発者は、閉じたユニバーサルなクラウドプリミティブの集合(例: server、worker、stateful-server)を使い、Aggrega の予約済みラベル component.aggrega.ai/type 上でアーキテクチャをマッピングします。高度なコンテキスト—AI エージェントの自律性、生成機能、データコンプライアンスなど—はすべて静的な Duck-Typing ラベルによってその上に重ねられ、独自の軸でコンポーネントを分類するカタログは独自のラベルキーを追加します。
  3. プログラマブルなポリシー & 検証: コアの Go コンパイラは主張を持たないものです。企業のガバナンスは、業界標準とプラグ可能な WebAssembly によって完全に駆動されます。カタログの検証には JSON Schema 2020-12(コンパクトな YAML 形式の略記法、または完全な JSON Schema YAML で記述)を、動的なトポロジーのタグ付けにはガバナンスソケットの label-transform ロールを、アーキテクチャ上のセキュリティ境界の評価にはその判定ロールを使用します。
  4. AOT コンパイラ & 実行への引き渡し: 厳格なコンパイルパイプラインが、DSL を機能に依存しない中間表現(IR)グラフへと変換します。IR はコンポーネントのトポロジーと、それらの間の uses エッジ(誰が誰を使うか)を捉えます。コンパイラはこのグラフを WebAssembly(Wasm)ガバナンスソケットに渡して推移的な信頼の脆弱性を検出し、その後 Wasm レンダリングプラグインを実行して、正確なプロキシとガードレールの構成を生成します。Aggrega はこれらの成果物をディスクに書き込み、CI/CD パイプラインやランタイムオーケストレーターなどの他のツールに引き渡し、それらのツールがデプロイを行います。

ライセンス

Aggrega のドキュメントは Apache License, Version 2.0 のもとで公開されています。全文はリポジトリの LICENSE ファイルにあります。