Features dan kebijakan
Halaman ini menjelaskan satu gagasan, yaitu melampirkan perilaku pada komponen dan memeriksa hasilnya dengan kebijakan, dan bukan workspace yang dapat dijalankan. Kebijakan yang menghentikan build ketika data terbatas mencapai model terkelola tanpa disamarkan menunjukkan keduanya dalam workspace yang Anda build; tuliskan ke dalam folder milik Anda sendiri dengan:
aggrega scaffold --example policy-data-class-routeKemudian ia mencetak perintah yang dijalankan berikutnya:
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 1Feature dilampirkan, dan diwujudkan oleh FeatureRecipe
Feature adalah perilaku yang tidak dibawa oleh komponen dengan sendirinya — penyamaran, cadangan, ingress, kredensial — yang dilampirkan oleh seorang penulis pada komponen tersebut di bawah features:. Siapa yang melampirkannya ditentukan oleh siapa yang menentukan masukannya: pengembang melampirkan, di dalam Aggregate, Feature yang perilakunya merupakan bagian dari hakikat aplikasi itu; operator melampirkan, di dalam Release, Feature yang semua masukannya bersifat operasional. Dalam kedua kasus, Manifest mengikat setiap Feature ke sebuah FeatureRecipe, yang menentukan bagaimana Feature itu diwujudkan untuk target.
Dalam contoh ini, pengembang melampirkan core/data-masking dari pustaka standar pada gateway AI dan mencantumkan apa yang harus disamarkan, dari aggregate.yaml dengan komentarnya dihilangkan:
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]Pengembang tidak menyebutkan alamat, guardrail, atau pengaturan penyedia apa pun. Manifest mengikat core/data-masking ke helm/data-masking-litellm, yang menulis penyamaran ke dalam konfigurasi yang dirender oleh Recipe milik gateway sendiri, melalui langkah-langkah pipeline plugin yang menutup rendering, dan menambahkan modul yang dimuat gateway di sampingnya. Setiap berkas lain yang ditulis build identik byte demi byte dengan build tanpa pemasangan tersebut.
Apa yang tidak dilakukan lampiran ini dinyatakan sama cermatnya dengan apa yang dilakukannya: teks yang tidak cocok dengan pola mana pun dan tidak terdeteksi oleh recognizer lolos tanpa perubahan, gateway dan kedua layanan recognizer melihat teks aslinya, dan lalu lintas yang tidak melewati gateway tidak tersentuh. Komentar FeatureRecipe mencantumkan apa yang ditolak gateway ini dan apa yang diteruskannya sebagaimana dikirim.
Label menentukan ke mana sebuah Feature boleh ditempatkan
Label adalah identitas semantik sebuah komponen, dan label menggerakkan penempatan Feature, selector soket, dan kebijakan tanpa perubahan apa pun pada kompiler. appliesTo milik sebuah Feature adalah selector label atas komponen tempat Feature itu dilampirkan. core/data-masking mendeklarasikan appliesTo: "dataplane.aggrega.ai/content-masking", sebuah kunci polos, yang cocok dengan komponen mana pun yang membawa label tersebut, apa pun nilainya; core/gateway/litellm membawanya, dengan nilai entity-recognition. Selector juga dapat mencocokkan nilai, component.aggrega.ai/type in (server, worker), atau mengecualikan label, !model.aggrega.ai/capability; semua persyaratan dari satu selector, yang dipisahkan koma, harus terpenuhi, dan Feature hanya dilampirkan pada komponen yang cocok dengan persyaratan tersebut. Lampiran berbasis label memberikan seluruh tata bahasa selector.
Dua deklarasi lagi membatasi lampiran:
- Interoperabilitas. Sebuah Feature dapat menyebutkan Features yang tidak dapat berbagi komponen dengannya.
core/data-maskingmendeklarasikaninteroperability.conflictsWith: [core/semantic-caching], sehingga build yang di dalamnya satu komponen akhirnya membawa keduanya — yang dilampirkan pada komponen itu sendiri, atau pada subsistem atau batas yang memuatnya — akan berhenti sebelum rendering. - Mandat kehadiran. Sebuah Component dapat mewajibkan adanya lampiran dari tipe tertentu.
example/compute/servicedalam katalog membawa anotasifeatures.aggrega.ai/requiredType.monitoring: core/prometheus-exporter, sehingga build yang di dalamnya sebuah instansnya tidak membawacore/prometheus-exporterpada cakupan mana pun akan berhenti dengan menyebutkan persyaratanmonitoring. Ulangi key dengan sufiks lain untuk mewajibkan tipe kedua; lihat entities/component.md “Presence mandates” untuk mengetahui perbedaan mandat dengan slot lampiran.
Sebuah Feature ditempatkan pada komponen yang perilakunya diubahnya. core/caller-allowlist dilampirkan pada server model, bukan pada gateway yang diizinkan memanggilnya; Server model yang hanya dapat dipanggil oleh gateway-nya mem-build hal tersebut.
Kebijakan membaca graf yang telah dibangun
Kebijakan dilampirkan oleh operator di bawah plugins.governance dalam konfigurasi workspace, masing-masing lampiran dalam suatu peran. Kebijakan pada peran label-transform menambahkan label ke graf; kebijakan pada peran ir-verdict menilainya dan dapat menghentikan build. Mesin Rego menjalankan keduanya; mesin ini dikompilasi ke dalam CLI, dan governance/rego adalah entitas Plugin-nya dalam katalog pustaka standar.
Aturan pertama di bawah ini menandai setiap gateway yang mengurai payload model yang diteruskannya sebagai titik tempat prompt keluar menuju penyedia model. Pada peran ini, node berada di 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"}Aturan kedua menghentikan setiap jalur melalui gateway semacam itu yang tidak membawa penyamaran:
# 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] )}ID sebuah node adalah kunci tempat node itu berada di input.graph.spec.nodes; attached_features mencantumkan tipe Feature yang terpasang pada node mana pun di jalur tersebut, sehingga keanggotaan diuji dengan in; aturan memeriksa bahwa penyamaran terpasang, bukan apa yang dicantumkannya; dan keputusan yang dikumpulkan di bawah deny dilaporkan pada tingkat keparahan halt, yang menghentikan build. Aturan atas jalur hanya melihat sebuah node di tempat sebuah edge mencapai atau meninggalkannya, sehingga kebijakan yang juga harus mencakup node yang tidak terhubung membaca node itu sendiri.
Operator melampirkan mesin sekali per peran, masing-masing lampiran dengan file kebijakannya sendiri; path relatif di bawah sources diresolusi terhadap direktori file konfigurasi, dan transformasi berjalan sebelum putusan:
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.regoHalaman soket tata kelola adalah permukaan penulisan lengkapnya: payload yang diekspos setiap peran, kunci keputusan, dan cara menamai milik Anda sendiri. Kebijakan yang membentuk label melampirkan kebijakan pembentuk label di samping dua plugin penanda bawaan dan mem-build-nya.