Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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ą:

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

Następnie wypisuje polecenia do uruchomienia w dalszej kolejności:

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

Encja 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-masking deklaruje interoperability.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/service z katalogu ma adnotację features.aggrega.ai/requiredType.monitoring: core/prometheus-exporter, więc kompilacja, w której jego instancja nie ma core/prometheus-exporter w żadnym zakresie, zatrzymuje się, wskazując wymaganie monitoring. 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 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"
}

Druga zatrzymuje każdą ścieżkę przez taką bramę, na której nie ma maskowania:

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

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:

.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

Strona 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.