Features와 정책
이 페이지는 컴포넌트에 동작을 연결하고 그 결과를 정책으로 검사한다는 하나의 개념을 설명하며, 실행 가능한 워크스페이스가 아닙니다. 제한된 데이터가 마스킹되지 않은 채 관리형 모델에 도달하면 빌드를 중단하는 정책은 직접 빌드하는 워크스페이스에서 두 가지를 모두 보여 줍니다. 다음 명령으로 자신의 폴더에 작성합니다:
aggrega scaffold --example policy-data-class-route그런 다음 이어서 실행할 명령을 출력합니다:
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는 연결되고, FeatureRecipe가 실현합니다
Feature는 컴포넌트가 스스로 갖추지 않은 동작 — 마스킹, 백업, 인그레스, 자격 증명 — 으로, 작성자가 features: 아래에서 컴포넌트에 연결합니다. 누가 연결하는지는 누가 그 입력을 결정하는지에 따라 정해집니다. 동작이 애플리케이션을 이루는 일부인 Feature는 개발자가 Aggregate에서 연결하고, 입력이 모두 운영에 관한 Feature는 운영자가 Release에서 연결합니다. 어느 경우든 Manifest는 각 Feature를 FeatureRecipe에 바인딩하며, FeatureRecipe는 대상에 맞게 그것이 어떻게 실현되는지를 결정합니다.
이 예제에서 개발자는 표준 라이브러리의 core/data-masking을 AI 게이트웨이에 연결하고 마스킹할 대상을 나열합니다. 다음은 주석을 생략한 aggregate.yaml입니다:
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]개발자는 주소, 가드레일, 제공자 설정을 하나도 지정하지 않습니다. Manifest는 core/data-masking을 helm/data-masking-litellm에 바인딩하며, 이는 렌더링을 마무리하는 플러그인 파이프라인의 단계를 통해 게이트웨이 자체 Recipe가 렌더링하는 구성에 마스킹을 작성하고, 그 옆에 게이트웨이가 로드하는 모듈을 추가합니다. 빌드가 작성하는 다른 모든 파일은 연결이 없는 빌드와 바이트 단위로 동일합니다.
연결이 하지 않는 일은 하는 일만큼 신중하게 명시되어 있습니다. 어떤 패턴과도 일치하지 않고 인식기가 감지하지 못한 텍스트는 그대로 통과하고, 게이트웨이와 두 인식기 서비스는 원본 텍스트를 보며, 게이트웨이를 거치지 않는 트래픽은 건드리지 않습니다. FeatureRecipe의 주석에 이 게이트웨이가 거부하는 것과 보낸 그대로 전달하는 것이 나열되어 있습니다.
레이블은 Feature가 갈 수 있는 곳을 결정합니다
레이블은 컴포넌트의 의미적 정체성이며, 컴파일러를 전혀 변경하지 않고도 Feature 배치, 소켓 셀렉터, 정책을 좌우합니다. Feature의 appliesTo는 그 Feature가 연결된 컴포넌트에 대한 레이블 셀렉터입니다. core/data-masking은 appliesTo: "dataplane.aggrega.ai/content-masking"을 선언하는데, 이는 값 없는 키로서 값과 관계없이 해당 레이블을 가진 모든 컴포넌트와 일치합니다. core/gateway/litellm은 이 레이블을 entity-recognition 값으로 가지고 있습니다. 셀렉터는 component.aggrega.ai/type in (server, worker)처럼 값을 비교하거나 !model.aggrega.ai/capability처럼 레이블을 제외할 수도 있습니다. 한 셀렉터에서 쉼표로 구분된 요구 사항은 모두 충족되어야 하며, Feature는 그 요구 사항과 일치하는 컴포넌트에만 연결됩니다. 레이블 기반 연결에서 전체 셀렉터 문법을 설명합니다.
두 가지 선언이 추가로 연결을 제약합니다:
- 상호 운용성. Feature는 컴포넌트를 함께 공유할 수 없는 Features를 지정할 수 있습니다.
core/data-masking은interoperability.conflictsWith: [core/semantic-caching]을 선언하므로, 한 컴포넌트가 둘 다 갖게 되는 빌드는 — 컴포넌트 자체에 연결되었든, 그 컴포넌트를 포함하는 서브시스템이나 경계에 연결되었든 — 렌더링 전에 중단됩니다. - 존재 의무. Component는 주어진 유형의 연결이 존재하도록 요구할 수 있습니다. 카탈로그의
example/compute/service에는features.aggrega.ai/requiredType.monitoring: core/prometheus-exporter어노테이션이 있으므로, 그 인스턴스가 어떤 범위에서도core/prometheus-exporter를 갖지 않는 빌드는monitoring요구 사항을 명시하며 중단됩니다. 두 번째 유형을 요구하려면 다른 접미사로 키를 반복합니다. 의무가 연결 슬롯과 어떻게 다른지는 entities/component.md의 “Presence mandates”를 참조하십시오.
Feature는 자신이 동작을 바꾸는 컴포넌트에 둡니다. core/caller-allowlist은 이를 호출할 수 있는 게이트웨이가 아니라 모델 서버에 연결됩니다. 자신의 게이트웨이만 호출할 수 있는 모델 서버가 이를 빌드합니다.
정책은 빌드된 그래프를 읽습니다
정책은 운영자가 워크스페이스 구성의 plugins.governance 아래에 연결하며, 각 연결은 하나의 역할에 속합니다. label-transform 역할의 정책은 그래프에 레이블을 추가하고, ir-verdict 역할의 정책은 그래프를 판정하며 빌드를 중단할 수 있습니다. Rego 엔진이 둘 다 실행합니다. 이 엔진은 CLI에 컴파일되어 들어가 있으며, governance/rego는 표준 라이브러리 카탈로그에 있는 그 Plugin 엔터티입니다.
아래 첫 번째 규칙은 전달하는 모델 페이로드를 파싱하는 모든 게이트웨이에 프롬프트가 모델 제공자로 나가는 지점이라는 태그를 지정합니다. 이 역할에서 노드는 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"}두 번째 규칙은 그러한 게이트웨이를 통과하면서 마스킹이 없는 모든 경로를 중단시킵니다:
# 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는 input.graph.spec.nodes에서 해당 노드가 놓인 키입니다. attached_features는 경로상의 어느 노드에든 연결된 Feature 유형을 나열하므로, 포함 여부는 in으로 검사합니다. 규칙은 마스킹이 무엇을 나열하는지가 아니라 연결되어 있는지를 확인합니다. 그리고 deny 아래에 수집된 결정은 halt 심각도로 보고되며, 이것이 빌드를 중단시킵니다. 경로에 대한 규칙은 엣지가 도달하거나 떠나는 노드만 볼 수 있으므로, 연결되지 않은 노드도 다루어야 하는 정책은 노드 자체를 읽습니다.
운영자는 역할마다 한 번씩 엔진을 연결하며, 각 연결에는 자체 정책 파일이 있습니다. sources 아래의 상대 경로는 구성 파일의 디렉터리를 기준으로 해석되며, 변환이 판정보다 먼저 실행됩니다:
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거버넌스 소켓 페이지는 전체 작성 인터페이스로, 각 역할이 노출하는 페이로드, 결정 키, 직접 이름을 붙이는 방법을 다룹니다. 레이블을 다듬는 정책은 두 개의 내장 태깅 플러그인 옆에 레이블을 다듬는 정책을 연결하고 빌드합니다.