Features ve politikalar
Bu sayfa tek bir fikri, bir bileşene bir davranış eklemeyi ve sonucu bir politikayla denetlemeyi açıklar ve çalıştırılabilir bir çalışma alanı değildir. Kısıtlı veriler maskelenmeden yönetilen bir modele ulaştığında derlemeyi durduran bir politika, ikisini de derlediğiniz bir çalışma alanında gösterir; kendi klasörünüze şu komutla yazın:
aggrega scaffold --example policy-data-class-routeArdından sırada çalıştırılacak komutları yazdırır:
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 1Bir Feature eklenir ve bir FeatureRecipe tarafından gerçekleştirilir
Bir Feature, bir bileşenin kendiliğinden taşımadığı bir davranıştır — maskeleme, bir yedekleme, bir ingress, bir kimlik bilgisi — ve bir yazar onu features: altında bileşene ekler. Onu kimin ekleyeceği, girdilerine kimin karar verdiğinden çıkar: davranışı uygulamanın ne olduğunun bir parçası olan bir Feature’ı geliştirici Aggregate’te ekler; girdilerinin tümü operasyonel olan bir Feature’ı ise operatör Release’te ekler. Her iki durumda da Manifest her Feature’ı bir FeatureRecipe’ye bağlar ve FeatureRecipe onun hedef için nasıl gerçekleştirileceğine karar verir.
Örnekte geliştirici, standart kütüphanedeki core/data-masking’i bir AI ağ geçidine ekler ve neyin maskeleneceğini listeler; yorumları çıkarılmış hâliyle aggregate.yaml dosyasından:
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]Geliştirici hiçbir adres, koruma ya da sağlayıcı ayarı belirtmez. Manifest, core/data-masking’i helm/data-masking-litellm’e bağlar; bu da maskelemeyi, render işlemini kapatan eklenti işlem hattının adımları aracılığıyla ağ geçidinin kendi Recipe’sinin işlediği yapılandırmaya yazar ve yanına ağ geçidinin yüklediği bir modül ekler. Derlemenin yazdığı diğer her dosya, ekleme olmadan yapılan bir derlemeninkiyle bayt bayt aynıdır.
Eklemenin ne yapmadığı, ne yaptığı kadar dikkatle belirtilir: hiçbir desenin eşleşmediği ve tanıyıcının algılamadığı metin değişmeden geçer, ağ geçidi ve iki tanıyıcı hizmet özgün metni görür ve ağ geçidinden geçmeyen trafiğe dokunulmaz. FeatureRecipe’nin yorumları, bu ağ geçidinin neyi reddettiğini ve neyi gönderildiği gibi ilettiğini listeler.
Etiketler bir Feature’ın nereye gidebileceğine karar verir
Etiketler bir bileşenin anlamsal kimliğidir ve derleyicide hiçbir değişiklik yapmadan Feature yerleşimini, soket seçicilerini ve politikayı yönlendirir. Bir Feature’ın appliesTo alanı, eklendiği bileşen üzerinde çalışan bir etiket seçicisidir. core/data-masking, appliesTo: "dataplane.aggrega.ai/content-masking" bildirir; bu, değeri ne olursa olsun o etiketi taşıyan herhangi bir bileşenle eşleşen yalın bir anahtardır; core/gateway/litellm bu etiketi entity-recognition değeriyle taşır. Bir seçici değerleri de eşleştirebilir, component.aggrega.ai/type in (server, worker), ya da bir etiketi dışlayabilir, !model.aggrega.ai/capability; bir seçicinin virgülle ayrılmış gereksinimlerinin tümü sağlanmalıdır ve Feature yalnızca bunların eşleştiği bir bileşene eklenir. Etikete dayalı ekleme, seçici dilbilgisinin tamamını verir.
İki bildirim daha eklemeleri kısıtlar:
- Birlikte çalışabilirlik. Bir Feature, bir bileşeni paylaşamayacağı Features’ı adlandırabilir.
core/data-masking,interoperability.conflictsWith: [core/semantic-caching]bildirir; bu nedenle bir bileşenin sonunda ikisini birden taşıdığı bir derleme — ister bileşenin kendisine, ister onu içeren bir alt sisteme veya sınıra eklenmiş olsun — render işleminden önce durur. - Varlık zorunlulukları. Bir Component, belirli türde bir eklemenin bulunmasını gerektirebilir. Katalogdaki
example/compute/service,features.aggrega.ai/requiredType.monitoring: core/prometheus-exporterek açıklamasını taşır; bu nedenle onun bir örneğinin hiçbir kapsamdacore/prometheus-exportertaşımadığı bir derleme,monitoringgereksinimini adlandırarak durur. İkinci bir türü zorunlu kılmak için anahtarı başka bir sonekle tekrarlayın; bir zorunluluğun ekleme yuvasından nasıl farklılaştığı için entities/component.md içindeki “Presence mandates” bölümüne bakın.
Bir Feature, davranışını değiştirdiği bileşene eklenir. core/caller-allowlist, onu çağırmasına izin verilen ağ geçitlerine değil, bir model sunucusuna eklenir; Yalnızca kendi ağ geçidinin çağırabildiği bir model sunucusu bunu derler.
Bir politika derlenmiş grafı okur
Politika, operatör tarafından çalışma alanı yapılandırmasında plugins.governance altına eklenir ve her ekleme bir roldedir. label-transform rolündeki bir politika grafa etiket ekler; ir-verdict rolündeki bir politika ise grafı değerlendirir ve derlemeyi durdurabilir. İkisini de Rego motoru çalıştırır; motor CLI’ye derlenmiştir ve governance/rego, standart kütüphane kataloğundaki onun Plugin varlığıdır.
Aşağıdaki ilk kural, ilettiği model yükünü ayrıştıran her ağ geçidini, istemlerin bir model sağlayıcısına gittiği bir nokta olarak etiketler. Bu rolde düğümler input.graph.nodes içindedir:
# 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"}İkincisi, böyle bir ağ geçidinden geçen ve hiçbir maskeleme taşımayan her yolu durdurur:
# 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] )}Bir düğümün kimliği, input.graph.spec.nodes içinde altında bulunduğu anahtardır; attached_features yol üzerindeki herhangi bir düğüme eklenmiş Feature türlerini listeler, bu nedenle üyelik in ile sınanır; kural, maskelemenin ne listelediğini değil, eklenmiş olduğunu denetler; ve deny altında toplanan bir karar, derlemeyi durduran halt önem düzeyinde raporlanır. Yollar üzerindeki bir kural bir düğümü yalnızca bir kenarın ona ulaştığı ya da ondan ayrıldığı yerde görür; bu nedenle bağlantısız bir düğümü de kapsaması gereken bir politika düğümlerin kendisini okur.
Operatör motoru her rol için bir kez ekler ve her eklemenin kendi politika dosyası vardır; sources altındaki göreli bir yol yapılandırma dosyasının dizinine göre çözümlenir ve dönüşüm karardan önce çalışır:
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.regoYönetişim soketi sayfası eksiksiz yazma yüzeyidir: her rolün sunduğu yük, karar anahtarları ve kendi kararlarınızı nasıl adlandıracağınız. Etiketleri biçimlendiren politikalar, iki yerleşik etiketleme eklentisinin yanına etiket biçimlendiren bir politika ekler ve bunu derler.