Features e políticas
Esta página explica uma única ideia, anexar um comportamento a um componente e verificar o resultado com uma política, e não é um espaço de trabalho executável. Uma política que interrompe uma compilação quando dados restritos chegam sem mascaramento a um modelo gerido mostra ambas as coisas num espaço de trabalho que se compila; pode escrevê-lo numa pasta própria com:
aggrega scaffold --example policy-data-class-routeDepois, imprime os próximos comandos a executar:
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 1Uma Feature é anexada, e realizada por uma FeatureRecipe
Uma Feature é um comportamento que um componente não tem por si só — mascaramento, uma cópia de segurança, um ingress, uma credencial — e que um autor lhe anexa em features:. Quem a anexa decorre de quem decide as suas entradas: o programador anexa, no Aggregate, uma Feature cujo comportamento faz parte do que a aplicação é; o operador anexa, na Release, uma cujas entradas são todas operacionais. Em ambos os casos, o Manifest associa cada Feature a uma FeatureRecipe, que decide como é realizada para o destino.
No exemplo, o programador anexa a core/data-masking da biblioteca standard a um gateway de IA e enumera o que mascarar, a partir de aggregate.yaml sem os comentários:
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]O programador não indica nenhum endereço, guardrail ou definição de fornecedor. O Manifest associa core/data-masking a helm/data-masking-litellm, que escreve o mascaramento na configuração que a própria Recipe do gateway renderiza, através de passos do pipeline de plugins que encerra a renderização, e acrescenta ao lado um módulo que o gateway carrega. Todos os outros ficheiros que a compilação escreve são idênticos byte a byte aos de uma compilação sem a associação.
O que o anexo não faz é indicado com o mesmo cuidado que o que faz: o texto a que nenhum padrão corresponde e que o reconhecedor não deteta passa inalterado, o gateway e os dois serviços do reconhecedor veem o texto original, e o tráfego que não passa pelo gateway não é tocado. Os comentários da FeatureRecipe listam o que este gateway recusa e o que deixa passar tal como foi enviado.
Os rótulos decidem onde uma Feature pode ir
Os rótulos são a identidade semântica de um componente e determinam o posicionamento de uma Feature, os seletores de sockets e as políticas sem qualquer alteração ao compilador. O campo appliesTo de uma Feature é um seletor de rótulos sobre o componente a que está anexada. core/data-masking declara appliesTo: "dataplane.aggrega.ai/content-masking", uma chave isolada, que corresponde a qualquer componente que tenha esse rótulo, seja qual for o seu valor; core/gateway/litellm tem-no, com o valor entity-recognition. Um seletor também pode corresponder a valores, component.aggrega.ai/type in (server, worker), ou excluir um rótulo, !model.aggrega.ai/capability; os requisitos de um mesmo seletor, separados por vírgulas, têm de se verificar todos, e a Feature só é anexada a um componente a que correspondam. Anexo baseado em rótulos apresenta a gramática completa dos seletores.
Mais duas declarações restringem os anexos:
- Interoperabilidade. Uma Feature pode nomear Features com as quais não pode partilhar um componente.
core/data-maskingdeclarainteroperability.conflictsWith: [core/semantic-caching], pelo que uma compilação em que um componente acabe por ter ambas — anexadas ao próprio componente, ou a um subsistema ou fronteira que o contenha — é interrompida antes da renderização. - Exigências de presença. Um Component pode exigir que esteja presente um anexo de um determinado tipo. O
example/compute/servicedo catálogo tem a anotaçãofeatures.aggrega.ai/requiredType.monitoring: core/prometheus-exporter, pelo que uma compilação em que uma instância dele não tenha nenhumacore/prometheus-exporter, em nenhum âmbito, é interrompida indicando o requisitomonitoring. Repita a chave com outro sufixo para exigir um segundo tipo; ver entities/component.md «Presence mandates (Exigências de presença)» para a forma como uma exigência difere de um slot de anexo.
Uma Feature fica no componente cujo comportamento altera. core/caller-allowlist é anexada a um servidor de modelos, não aos gateways autorizados a chamá-lo; Um servidor de modelos que só o seu gateway pode chamar compila esse cenário.
Uma política lê o grafo construído
As políticas são anexadas pelo operador em plugins.governance na configuração do espaço de trabalho, cada anexo num papel. Uma política no papel label-transform acrescenta rótulos ao grafo; uma no papel ir-verdict julga-o e pode interromper a compilação. O motor Rego executa ambas; está compilado na CLI, e governance/rego é a sua entidade Plugin no catálogo da biblioteca standard.
A primeira regra abaixo marca cada gateway que analisa o payload de modelo que encaminha como um ponto onde os prompts saem para um fornecedor de modelos. Neste papel, os nós encontram-se em 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"}A segunda interrompe qualquer caminho através de um gateway desse tipo que não tenha mascaramento:
# 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] )}O id de um nó é a chave sob a qual se encontra em input.graph.spec.nodes; attached_features enumera os tipos de Feature anexados a qualquer nó do caminho, pelo que a pertença se testa com in; a regra verifica que o mascaramento está anexado, e não o que enumera; e uma decisão recolhida em deny é comunicada com a severidade halt, que interrompe a compilação. Uma regra sobre caminhos só vê um nó onde uma aresta chega a ele ou parte dele, pelo que uma política que tenha de abranger também um nó não ligado lê os próprios nós.
O operador anexa o motor uma vez por papel, cada anexo com o seu próprio ficheiro de política; um caminho relativo em sources é resolvido em relação ao diretório do ficheiro de configuração, e a transformação é executada antes do veredicto:
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.regoA página do socket de governação é a superfície de criação completa: o payload que cada papel expõe, as chaves de decisão e como nomear as próprias. O exemplo Políticas que moldam rótulos anexa uma política que molda rótulos ao lado dos dois plugins de rotulagem incorporados e compila-a.