Features y políticas
Esta página explica una sola idea, vincular un comportamiento a un componente y comprobar el resultado con una política, y no es un espacio de trabajo ejecutable. Una política que detiene una compilación cuando datos restringidos llegan sin enmascarar a un modelo gestionado muestra ambas cosas en un espacio de trabajo que compilas; escríbelo en una carpeta propia con:
aggrega scaffold --example policy-data-class-routeDespués imprime los comandos que hay que ejecutar a continuación:
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 1Una Feature se vincula, y la realiza una FeatureRecipe
Una Feature es un comportamiento que un componente no tiene por sí mismo — enmascaramiento, una copia de seguridad, un ingress, una credencial — y que un autor le vincula bajo features:. Quién la vincula se deduce de quién decide sus entradas: el desarrollador vincula, en el Aggregate, una Feature cuyo comportamiento forma parte de lo que la aplicación es; el operador vincula, en la Release, una cuyas entradas son todas operativas. En ambos casos, el Manifest enlaza cada Feature con una FeatureRecipe, que decide cómo se realiza para el destino.
En el ejemplo, el desarrollador vincula la core/data-masking de la biblioteca estándar a un gateway de IA y enumera qué enmascarar, desde aggregate.yaml sin sus comentarios:
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]El desarrollador no indica ninguna dirección, guardrail ni ajuste del proveedor. El Manifest enlaza core/data-masking con helm/data-masking-litellm, que escribe el enmascaramiento en la configuración que renderiza la propia Recipe del gateway, mediante pasos del pipeline de plugins que cierra el renderizado, y añade a su lado un módulo que el gateway carga. Todos los demás archivos que escribe la compilación son idénticos byte a byte a los de una compilación sin el adjunto.
Lo que la vinculación no hace se indica con el mismo cuidado que lo que hace: el texto con el que no coincide ningún patrón y que el reconocedor no detecta pasa sin cambios, el gateway y los dos servicios del reconocedor ven el texto original, y el tráfico que no pasa por el gateway no se toca. Los comentarios de la FeatureRecipe enumeran lo que este gateway rechaza y lo que deja pasar tal como se envió.
Las etiquetas deciden adónde puede ir una Feature
Las etiquetas son la identidad semántica de un componente, y determinan la colocación de una Feature, los selectores de sockets y las políticas sin ningún cambio en el compilador. El campo appliesTo de una Feature es un selector de etiquetas sobre el componente al que está vinculada. core/data-masking declara appliesTo: "dataplane.aggrega.ai/content-masking", una clave sola, que coincide con cualquier componente que lleve esa etiqueta, sea cual sea su valor; core/gateway/litellm la lleva, con el valor entity-recognition. Un selector también puede comparar valores, component.aggrega.ai/type in (server, worker), o excluir una etiqueta, !model.aggrega.ai/capability; los requisitos de un mismo selector, separados por comas, deben cumplirse todos, y la Feature se vincula solo a un componente con el que coincidan. Vinculación basada en etiquetas ofrece la gramática completa de los selectores.
Otras dos declaraciones restringen las vinculaciones:
- Interoperabilidad. Una Feature puede nombrar Features con las que no puede compartir un componente.
core/data-maskingdeclarainteroperability.conflictsWith: [core/semantic-caching], así que una compilación en la que un componente acaba llevando ambas — vinculadas al propio componente, o a un subsistema o límite que lo contiene — se detiene antes del renderizado. - Mandatos de presencia. Un Component puede exigir que esté presente una vinculación de un tipo dado. El
example/compute/servicedel catálogo lleva la anotaciónfeatures.aggrega.ai/requiredType.monitoring: core/prometheus-exporter, así que una compilación en la que una instancia suya no lleva ningunacore/prometheus-exporter, en ningún ámbito, se detiene nombrando el requisitomonitoring. Repite la clave con otro sufijo para exigir un segundo tipo; consulta entities/component.md «Presence mandates (Mandatos de presencia)» para ver en qué se diferencia un mandato de un slot de vinculación.
Una Feature va en el componente cuyo comportamiento cambia. core/caller-allowlist se vincula a un servidor de modelos, no a los gateways autorizados a llamarlo; Un servidor de modelos al que solo su gateway puede llamar lo compila.
Una política lee el grafo construido
El operador vincula las políticas bajo plugins.governance en la configuración del espacio de trabajo, cada vinculación en un rol. Una política en el rol label-transform añade etiquetas al grafo; una en el rol ir-verdict lo juzga y puede detener la compilación. El motor Rego ejecuta ambas; está compilado en la CLI, y governance/rego es su entidad Plugin en el catálogo de la biblioteca estándar.
La primera regla de abajo etiqueta cada gateway que analiza la carga útil del modelo que reenvía como un punto donde los prompts salen hacia un proveedor de modelos. En este rol, los nodos están en 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"}La segunda detiene cualquier ruta a través de un gateway así que no lleve enmascaramiento:
# 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] )}El id de un nodo es la clave bajo la que está en input.graph.spec.nodes; attached_features enumera los tipos de Feature vinculados a cualquier nodo de la ruta, así que la pertenencia se comprueba con in; la regla comprueba que el enmascaramiento esté vinculado, no lo que enumera; y una decisión recogida bajo deny se notifica con la severidad halt, que detiene la compilación. Una regla sobre rutas solo ve un nodo donde una arista llega a él o sale de él, así que una política que también deba cubrir un nodo no conectado lee los propios nodos.
El operador vincula el motor una vez por rol, cada vinculación con su propio archivo de política; una ruta relativa bajo sources se resuelve respecto al directorio del archivo de configuración, y la transformación se ejecuta antes que el veredicto:
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.regoLa página del socket de gobernanza es la superficie de creación completa: la carga útil que expone cada rol, las claves de decisión y cómo nombrar las tuyas. El ejemplo Políticas que dan forma a las etiquetas vincula una política que da forma a las etiquetas junto a los dos plugins de etiquetado integrados, y la compila.