Features i polityki
Ta strona wyjaśnia jedną ideę, dołączanie zachowania do komponentu i sprawdzanie wyniku za pomocą polityki, i nie jest uruchamialnym obszarem roboczym. Polityka, która zatrzymuje kompilację, gdy dane objęte ograniczeniami docierają do zarządzanego modelu bez maskowania pokazuje oba elementy w obszarze roboczym, który się kompiluje; można go zapisać we własnym folderze za pomocą:
aggrega scaffold --example policy-data-class-routeNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności:
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 1Encja Feature jest dołączana i realizowana przez encję FeatureRecipe
Encja Feature to zachowanie, którego komponent nie ma sam z siebie — maskowanie, kopia zapasowa, ingress, poświadczenie — a które autor dołącza do niego w features:. To, kto ją dołącza, wynika z tego, kto decyduje o jej danych wejściowych: deweloper dołącza w encji Aggregate encję Feature, której zachowanie jest częścią tego, czym jest aplikacja; operator dołącza w encji Release taką, której wszystkie dane wejściowe są operacyjne. W obu przypadkach encja Manifest wiąże każdą encję Feature z encją FeatureRecipe, która decyduje, jak zostanie ona zrealizowana dla celu.
W przykładzie deweloper dołącza core/data-masking z biblioteki standardowej do bramy AI i wymienia, co maskować, z pliku aggregate.yaml z pominiętymi komentarzami:
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]Deweloper nie podaje żadnego adresu, zabezpieczenia ani ustawienia dostawcy. Encja Manifest wiąże core/data-masking z helm/data-masking-litellm, który zapisuje maskowanie w konfiguracji, którą renderuje własna encja Recipe bramy, za pomocą kroków potoku wtyczek zamykającego renderowanie, i dodaje obok moduł ładowany przez bramę. Każdy inny plik zapisywany przez kompilację jest bajt w bajt identyczny z plikiem z kompilacji bez dołączenia.
To, czego dołączenie nie robi, opisano równie starannie jak to, co robi: tekst, do którego nie pasuje żaden wzorzec i którego nie wykrywa rozpoznawacz, przechodzi bez zmian, brama i obie usługi rozpoznawania widzą oryginalny tekst, a ruch, który nie przechodzi przez bramę, pozostaje nienaruszony. Komentarze w encji FeatureRecipe wymieniają, co ta brama odrzuca, a co przekazuje w postaci wysłanej.
Etykiety decydują, gdzie może trafić encja Feature
Etykiety są semantyczną tożsamością komponentu i sterują rozmieszczaniem encji Feature, selektorami gniazd oraz politykami bez żadnych zmian w kompilatorze. Pole appliesTo encji Feature to selektor etykiet działający na komponencie, do którego jest ona dołączona. core/data-masking deklaruje appliesTo: "dataplane.aggrega.ai/content-masking", sam klucz, który pasuje do każdego komponentu z tą etykietą, niezależnie od jej wartości; core/gateway/litellm ma tę etykietę z wartością entity-recognition. Selektor może też dopasowywać wartości, component.aggrega.ai/type in (server, worker), albo wykluczać etykietę, !model.aggrega.ai/capability; wszystkie wymagania jednego selektora, oddzielone przecinkami, muszą być spełnione, a encja Feature zostaje dołączona tylko do komponentu, do którego one pasują. Dołączanie na podstawie etykiet przedstawia pełną gramatykę selektorów.
Dołączenia ograniczają jeszcze dwie deklaracje:
- Interoperacyjność. Encja Feature może wskazać encje Features, z którymi nie może współdzielić komponentu.
core/data-maskingdeklarujeinteroperability.conflictsWith: [core/semantic-caching], więc kompilacja, w której jeden komponent ostatecznie przenosi obie — dołączone do samego komponentu albo do podsystemu lub granicy, które go zawierają — zatrzymuje się przed renderowaniem. - Wymogi obecności. Encja Component może wymagać, aby obecne było dołączenie danego typu.
example/compute/servicez katalogu ma adnotacjęfeatures.aggrega.ai/requiredType.monitoring: core/prometheus-exporter, więc kompilacja, w której jego instancja nie macore/prometheus-exporterw żadnym zakresie, zatrzymuje się, wskazując wymaganiemonitoring. Aby wymagać drugiego typu, należy powtórzyć klucz z innym sufiksem; różnicę między wymogiem obecności a slotem dołączenia opisuje sekcja „Presence mandates” w entities/component.md.
Encja Feature trafia do komponentu, którego zachowanie zmienia. core/caller-allowlist dołącza się do serwera modeli, a nie do bram, które mogą go wywoływać; przykład Serwer modeli, który może wywoływać tylko jego brama to kompiluje.
Polityka odczytuje zbudowany graf
Polityki dołącza operator w plugins.governance w konfiguracji obszaru roboczego, każde dołączenie w określonej roli. Polityka w roli label-transform dodaje etykiety do grafu; polityka w roli ir-verdict ocenia go i może zatrzymać kompilację. Obie uruchamia silnik Rego; jest on wkompilowany w CLI, a governance/rego to jego encja Plugin w katalogu biblioteki standardowej.
Pierwsza reguła poniżej taguje każdą bramę, która parsuje przekazywany przez siebie ładunek modelu, jako punkt, w którym prompty wychodzą do dostawcy modelu. W tej roli węzły znajdują się w 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"}Druga zatrzymuje każdą ścieżkę przez taką bramę, na której nie ma maskowania:
# 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] )}Identyfikator węzła to klucz, pod którym węzeł znajduje się w input.graph.spec.nodes; attached_features wymienia typy encji Feature dołączonych do dowolnego węzła na ścieżce, więc przynależność sprawdza się za pomocą in; reguła sprawdza, czy maskowanie jest dołączone, a nie, co ono wymienia; a decyzja zebrana pod deny jest zgłaszana z poziomem ważności halt, który zatrzymuje kompilację. Reguła dotycząca ścieżek widzi węzeł tylko tam, gdzie dochodzi do niego lub wychodzi z niego krawędź, więc polityka, która musi obejmować także niepołączony węzeł, odczytuje same węzły.
Operator dołącza silnik raz na rolę, a każde dołączenie ma własny plik polityki; ścieżka względna w sources jest rozwiązywana względem katalogu pliku konfiguracji, a transformacja działa przed werdyktem:
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.regoStrona gniazda ładu opisuje pełną powierzchnię tworzenia: ładunek udostępniany przez każdą rolę, klucze decyzji i sposób nadawania własnych nazw. Przykład Polityki kształtujące etykiety dołącza politykę kształtującą etykiety obok dwóch wbudowanych wtyczek tagujących i ją kompiluje.