Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

Features und Richtlinien

Diese Seite erläutert eine einzige Idee, nämlich ein Verhalten an eine Komponente anzubinden und das Ergebnis mit einer Richtlinie zu prüfen, und ist kein ausführbarer Workspace. Eine Richtlinie, die einen Build anhält, wenn eingeschränkte Daten unmaskiert ein verwaltetes Modell erreichen zeigt beides in einem Workspace, den Sie bauen; schreiben Sie ihn in einen eigenen Ordner mit:

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

Danach gibt er die als Nächstes auszuführenden Befehle aus:

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

Ein Feature wird angebunden und von einem FeatureRecipe realisiert

Ein Feature ist ein Verhalten, das eine Komponente nicht von sich aus mitbringt — Maskierung, ein Backup, ein Ingress, eine Anmeldeinformation —, und das ein Autor ihr unter features: anbindet. Wer es anbindet, ergibt sich daraus, wer seine Eingaben bestimmt: Der Entwickler bindet im Aggregate ein Feature an, dessen Verhalten Teil dessen ist, was die Anwendung ausmacht; der Operator bindet im Release eines an, dessen Eingaben alle operativ sind. In beiden Fällen bindet das Manifest jedes Feature an ein FeatureRecipe, das entscheidet, wie es für das Ziel realisiert wird.

Im Beispiel bindet der Entwickler core/data-masking aus der Standardbibliothek an ein KI-Gateway an und listet auf, was maskiert werden soll, aus aggregate.yaml ohne seine Kommentare:

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]

Der Entwickler nennt keine Adresse, keine Guardrail und keine Anbietereinstellung. Das Manifest bindet core/data-masking an helm/data-masking-litellm, das die Maskierung in die Konfiguration schreibt, die das eigene Recipe des Gateways rendert, und zwar über Schritte der Plugin-Pipeline, die das Rendering abschließt, und daneben ein Modul hinzufügt, das das Gateway lädt. Jede andere Datei, die der Build schreibt, ist byte-identisch mit einem Build ohne die Anhängung.

Was die Anbindung nicht tut, wird ebenso sorgfältig angegeben wie das, was sie tut: Text, auf den kein Muster passt und den der Erkenner nicht erkennt, geht unverändert durch, das Gateway und die beiden Dienste des Erkenners sehen den Originaltext, und Datenverkehr, der nicht über das Gateway läuft, wird nicht berührt. Die Kommentare des FeatureRecipe führen auf, was dieses Gateway ablehnt und was es so weitergibt, wie es gesendet wurde.

Labels entscheiden, wohin ein Feature darf

Labels sind die semantische Identität einer Komponente, und sie steuern die Feature-Platzierung, Socket-Selektoren und Richtlinien ohne jede Änderung am Compiler. Das Feld appliesTo an einem Feature ist ein Label-Selektor über die Komponente, an die es angebunden ist. core/data-masking deklariert appliesTo: "dataplane.aggrega.ai/content-masking", einen bloßen Schlüssel, der auf jede Komponente passt, die dieses Label trägt, unabhängig von seinem Wert; core/gateway/litellm trägt es, mit dem Wert entity-recognition. Ein Selektor kann auch Werte abgleichen, component.aggrega.ai/type in (server, worker), oder ein Label ausschließen, !model.aggrega.ai/capability; die Anforderungen eines Selektors, durch Kommas getrennt, müssen alle erfüllt sein, und das Feature wird nur an eine Komponente angebunden, auf die sie passen. Label-basierte Anbindung beschreibt die vollständige Selektorgrammatik.

Zwei weitere Deklarationen schränken Anbindungen ein:

  • Interoperabilität. Ein Feature kann Features benennen, mit denen es sich keine Komponente teilen kann. core/data-masking deklariert interoperability.conflictsWith: [core/semantic-caching], sodass ein Build, in dem eine Komponente am Ende beide trägt — angebunden an die Komponente selbst oder an ein Subsystem oder eine Boundary, die sie enthält —, vor dem Rendering abbricht.
  • Präsenzvorgaben. Eine Component kann verlangen, dass eine Anbindung eines bestimmten Typs vorhanden ist. example/compute/service aus dem Katalog trägt die Annotation features.aggrega.ai/requiredType.monitoring: core/prometheus-exporter, sodass ein Build, in dem eine Instanz davon auf keiner Ebene ein core/prometheus-exporter trägt, unter Nennung der Anforderung monitoring abbricht. Wiederholen Sie den Schlüssel mit einem anderen Suffix, um einen zweiten Typ zu verlangen; siehe entities/component.md „Presence mandates (Präsenzvorgaben)“ dazu, wie sich eine Vorgabe von einem Anbindungs-Slot unterscheidet.

Ein Feature gehört an die Komponente, deren Verhalten es ändert. core/caller-allowlist wird an einen Modellserver angebunden, nicht an die Gateways, die ihn aufrufen dürfen; Ein Modellserver, den nur sein Gateway aufrufen darf baut das.

Eine Richtlinie liest den gebauten Graphen

Richtlinien bindet der Operator unter plugins.governance in der Workspace-Konfiguration an, jede Anbindung in einer Rolle. Eine Richtlinie in der Rolle label-transform fügt dem Graphen Labels hinzu; eine in der Rolle ir-verdict beurteilt ihn und kann den Build anhalten. Die Rego-Engine führt beide aus; sie ist in die CLI kompiliert, und governance/rego ist ihre Plugin-Entität im Katalog der Standardbibliothek.

Die erste Regel unten kennzeichnet jedes Gateway, das die weitergeleitete Modell-Payload parst, als Punkt, an dem Prompts zu einem Modellanbieter hinausgehen. In dieser Rolle liegen die Knoten unter 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"
}

Die zweite hält jeden Pfad durch ein solches Gateway an, der keine Maskierung trägt:

# 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]
)
}

Die ID eines Knotens ist der Schlüssel, unter dem er in input.graph.spec.nodes steht; attached_features listet die Feature-Typen auf, die an irgendeinem Knoten des Pfads angebunden sind, daher wird die Zugehörigkeit mit in geprüft; die Regel prüft, dass die Maskierung angebunden ist, nicht, was sie auflistet; und eine unter deny gesammelte Entscheidung wird mit dem Schweregrad halt gemeldet, der den Build stoppt. Eine Regel über Pfade sieht einen Knoten nur dort, wo eine Kante ihn erreicht oder verlässt, daher liest eine Richtlinie, die auch einen nicht verbundenen Knoten abdecken muss, die Knoten selbst.

Der Operator bindet die Engine einmal pro Rolle an, jede Anbindung mit ihrer eigenen Richtliniendatei; ein relativer Pfad unter sources wird relativ zum Verzeichnis der Konfigurationsdatei aufgelöst, und die Transformation läuft vor dem Verdikt:

.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

Die Seite zum Governance-Socket ist die vollständige Authoring-Oberfläche: die Payload, die jede Rolle bereitstellt, die Entscheidungsschlüssel und wie Sie Ihre eigenen benennen. Das Beispiel Richtlinien, die Labels formen bindet eine Label-formende Richtlinie neben den beiden eingebauten Tagging-Plugins an und baut sie.