Features とポリシー
このページでは、コンポーネントに振る舞いをアタッチし、その結果をポリシーで検査するという 1 つの考え方を説明します。実行可能なワークスペースではありません。制限付きデータがマスクされないままマネージドモデルに届いたときにビルドを停止するポリシーは、その両方をビルド可能なワークスペースで示します。次のコマンドで自分のフォルダーに書き出します:
aggrega scaffold --example policy-data-class-routeその後、次に実行するコマンドを表示します。
cd policy-data-class-routeaggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pullaggrega build --release release-unmasked.yaml --config governance-rego.yaml --auto-pull # halts; exits 1aggrega build --release release-masking-off-route.yaml --config governance-rego.yaml --auto-pull # halts; exits 1Feature はアタッチされ、FeatureRecipe によって実現される
Feature は、コンポーネントがそれ自体では持たない振る舞い — マスキング、バックアップ、イングレス、認証情報 — であり、作成者が features: の下でコンポーネントに付与します。誰が付与するかは、誰がその入力を決めるかによって決まります。振る舞いがアプリケーションそのものの一部である Feature は開発者が Aggregate で付与し、入力がすべて運用上のものである Feature は運用担当が Release で付与します。いずれの場合も、Manifest が各 Feature を FeatureRecipe にバインドし、FeatureRecipe がターゲットに対してそれをどのように実現するかを決めます。
この例では、開発者が標準ライブラリの core/data-masking を AI ゲートウェイにアタッチし、マスクする対象を列挙します。以下はコメントを省いた aggregate.yaml からの抜粋です:
masking-gateway: type: core/gateway/litellm values: model: chat features: masking: type: core/data-masking values: patterns: - name: claim_number regex: '\bCLM-[0-9]{8}\b' entities: [PERSON, EMAIL_ADDRESS]開発者は、アドレス、ガードレール、プロバイダー設定のいずれも指定しません。Manifest は core/data-masking を helm/data-masking-litellm にバインドし、これがレンダリングを締めくくるプラグインパイプラインのステップを通じて、ゲートウェイ自身の Recipe がレンダリングする構成にマスキングを書き込み、その横にゲートウェイが読み込むモジュールを追加します。ビルドが書き出すその他のファイルは、アタッチなしのビルドとバイト単位で同一です。
アタッチが行わないことも、行うことと同じく慎重に述べられています。どのパターンにも一致せず、認識器も検出しないテキストは、変更されずに通過します。ゲートウェイと 2 つの認識器サービスは元のテキストを参照します。また、ゲートウェイを経由しないトラフィックには一切手が加えられません。FeatureRecipe のコメントに、このゲートウェイが拒否するものと、送信されたまま渡すものが列挙されています。
ラベルが Feature の配置先を決める
ラベルはコンポーネントのセマンティックなアイデンティティであり、コンパイラに一切変更を加えることなく、Feature の配置、ソケットセレクター、ポリシーを左右します。Feature の appliesTo は、アタッチ先のコンポーネントに対するラベルセレクターです。core/data-masking は appliesTo: "dataplane.aggrega.ai/content-masking" を宣言しています。これはキーだけの指定で、値にかかわらずそのラベルを持つすべてのコンポーネントに一致します。core/gateway/litellm はこのラベルを値 entity-recognition で持っています。セレクターは component.aggrega.ai/type in (server, worker) のように値を照合することも、!model.aggrega.ai/capability のようにラベルを除外することもできます。1 つのセレクターのカンマ区切りの要件はすべて満たされる必要があり、Feature はそれらが一致するコンポーネントにのみアタッチされます。セレクターの文法全体は ラベルに基づくアタッチ にあります。
さらに 2 つの宣言がアタッチを制約します:
- 相互運用性。 Feature は、コンポーネントを共有できない Features を指定できます。
core/data-maskingはinteroperability.conflictsWith: [core/semantic-caching]を宣言しているため、1 つのコンポーネントが両方を持つことになるビルドは — コンポーネント自体へのアタッチでも、そのコンポーネントを含むサブシステムや境界へのアタッチでも — レンダリングの前に停止します。 - 存在の義務付け。 Component は、特定の型のアタッチが存在することを要求できます。カタログの
example/compute/serviceはアノテーションfeatures.aggrega.ai/requiredType.monitoring: core/prometheus-exporterを持つため、そのインスタンスがどのスコープにもcore/prometheus-exporterを持たないビルドは、monitoring要件を名指しして停止します。2 つ目の型を要求するには、別の接尾辞を付けてキーを繰り返します。義務付けとアタッチのスロットの違いについては、entities/component.md の「Presence mandates」を参照してください。
Feature は、その振る舞いを変えるコンポーネントにアタッチします。core/caller-allowlist は、呼び出しを許可されたゲートウェイではなく、モデルサーバーにアタッチされます。ゲートウェイからしか呼び出せないモデルサーバーはそれをビルドします。
ポリシーはビルドされたグラフを読む
ポリシーは、運用担当がワークスペース設定の plugins.governance の下でアタッチし、各アタッチはいずれかのロールに属します。label-transform ロールのポリシーはグラフにラベルを追加し、ir-verdict ロールのポリシーはグラフを判定してビルドを停止することがあります。Rego エンジンが両方を実行します。このエンジンは CLI に組み込まれてコンパイルされており、governance/rego は標準ライブラリのカタログにおけるその Plugin エンティティです。
以下の 1 つ目のルールは、転送するモデルペイロードを解析するすべてのゲートウェイに、プロンプトがモデルプロバイダーへ出ていく地点としてタグを付けます。このロールでは、ノードは input.graph.nodes にあります:
# policies/egress-tagging.rego: attached at the label-transform rolepackage aggrega.tagging
import rego.v1
labels contains {"node": id, "key": "compliance.aggrega.ai/egress", "value": "model-provider"} if { some id, node in input.graph.nodes node.labels["gateway.aggrega.ai/intelligence"] == "semantic"}2 つ目のルールは、そのようなゲートウェイを通過し、マスキングを持たないパスをすべて停止させます:
# policies/model-egress.rego: attached at the ir-verdict rolepackage aggrega.security
import rego.v1
deny contains msg if { some path in input.precalculated_paths some egress in path.nodes input.graph.spec.nodes[egress].labels["compliance.aggrega.ai/egress"] == "model-provider" not "core/data-masking" in path.attached_features
msg := sprintf( "BLOCKED: path %v sends model traffic through %v without core/data-masking attached.", [concat(" -> ", path.nodes), egress] )}ノードの id は、input.graph.spec.nodes の中でそのノードが置かれているキーです。attached_features はパス上のいずれかのノードにアタッチされた Feature の型を列挙するため、所属は in で判定します。ルールはマスキングがアタッチされていることを確認し、その内容は確認しません。そして deny の下に集められた決定は halt の重大度で報告され、これがビルドを停止させます。パスに対するルールは、エッジが到達するか出ていくノードしか見ないため、接続されていないノードもカバーする必要があるポリシーは、ノードそのものを読み取ります。
運用担当はロールごとに 1 回ずつエンジンをアタッチし、各アタッチはそれぞれ独自のポリシーファイルを持ちます。sources の下の相対パスは設定ファイルのディレクトリを基準に解決され、変換は判定より先に実行されます:
plugins: governance: - uri: governance/rego:0.9.0 role: label-transform with: sources: - policies/egress-tagging.rego - uri: governance/rego:0.9.0 role: ir-verdict with: sources: - policies/model-egress.regoガバナンスソケットのページが作成のための完全な説明です。各ロールが公開するペイロード、決定のキー、そして独自の名前の付け方を扱います。ラベルを整形するポリシーは、2 つの組み込みタグ付けプラグインの横にラベルを整形するポリシーをアタッチし、ビルドします。