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

Features とポリシー

このページでは、コンポーネントに振る舞いをアタッチし、その結果をポリシーで検査するという 1 つの考え方を説明します。実行可能なワークスペースではありません。制限付きデータがマスクされないままマネージドモデルに届いたときにビルドを停止するポリシーは、その両方をビルド可能なワークスペースで示します。次のコマンドで自分のフォルダーに書き出します:

Terminal window
aggrega scaffold --example policy-data-class-route

その後、次に実行するコマンドを表示します。

Terminal window
cd policy-data-class-route
aggrega build --release release-masked.yaml --config governance-rego.yaml --auto-pull
aggrega build --release release-unmasked.yaml --config governance-rego.yaml --auto-pull # halts; exits 1
aggrega build --release release-masking-off-route.yaml --config governance-rego.yaml --auto-pull # halts; exits 1

Feature はアタッチされ、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 role
package 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 role
package 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 の下の相対パスは設定ファイルのディレクトリを基準に解決され、変換は判定より先に実行されます:

.aggrega-config.yaml
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 つの組み込みタグ付けプラグインの横にラベルを整形するポリシーをアタッチし、ビルドします。