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 1Сутність Feature приєднується і реалізується сутністю FeatureRecipe
Сутність Feature — це поведінка, якої компонент не має сам по собі, — маскування, резервна копія, ingress, облікові дані, — і яку автор приєднує до нього в features:. Хто її приєднує, визначається тим, хто вирішує її вхідні дані: розробник приєднує в сутності Aggregate таку Feature, поведінка якої є частиною того, чим є застосунок; оператор приєднує в сутності Release таку, усі вхідні дані якої є операційними. В обох випадках Manifest прив’язує кожну Feature до сутності 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, селекторами сокетів і політиками без жодних змін у компіляторі. Поле 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. Щоб вимагати другий тип, повторіть ключ з іншим суфіксом; див. розділ «Presence mandates» у entities/component.md, щоб дізнатися, чим обов’язкова присутність відрізняється від слота приєднання.
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] )}Ідентифікатор вузла — це ключ, під яким він розміщений у 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Сторінка сокета врядування описує всі можливості створення: корисне навантаження, яке надає кожна роль, ключі рішень і те, як називати власні. Приклад Політики, що формують мітки приєднує політику, що формує мітки, поруч із двома вбудованими плагінами позначення і збирає її.