Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

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:

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

Depois, imprime os próximos comandos a executar:

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

Uma 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-masking declara interoperability.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/service do catálogo tem a anotação features.aggrega.ai/requiredType.monitoring: core/prometheus-exporter, pelo que uma compilação em que uma instância dele não tenha nenhuma core/prometheus-exporter, em nenhum âmbito, é interrompida indicando o requisito monitoring. 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 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"
}

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

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:

.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

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