İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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:

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

Ardından sırada çalıştırılacak komutları yazdırır:

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

Bir 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-exporter ek açıklamasını taşır; bu nedenle onun bir örneğinin hiçbir kapsamda core/prometheus-exporter taşımadığı bir derleme, monitoring gereksinimini 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 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"
}

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

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:

.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

Yö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.