Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Features і політики

Ця сторінка пояснює одну ідею, приєднання поведінки до компонента та перевірку результату політикою, і не є робочим простором, який можна запустити. Політика, яка зупиняє збирання, коли дані з обмеженим доступом досягають керованої моделі без маскування, показує обидва аспекти в робочому просторі, який ви збираєте; запишіть його у власну теку за допомогою:

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

Потім вона виводить команди, які слід виконати далі:

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

Сутність 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 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"
}

Друге зупиняє будь-який шлях через такий шлюз, на якому немає маскування:

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

Ідентифікатор вузла — це ключ, під яким він розміщений у input.graph.spec.nodes; attached_features перелічує типи Feature, приєднані до будь-якого вузла на шляху, тому належність перевіряють за допомогою in; правило перевіряє, що маскування приєднано, а не те, що воно перелічує; а рішення, зібране під deny, повідомляється з рівнем серйозності halt, який зупиняє збирання. Правило над шляхами бачить вузол лише там, де до нього доходить або з нього виходить ребро, тож політика, яка має охоплювати й не з’єднаний вузол, читає самі вузли.

Оператор приєднує рушій один раз на роль, і кожне приєднання має власний файл політики; відносний шлях у sources розв’язується відносно каталогу файлу конфігурації, а перетворення виконується перед вердиктом:

.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

Сторінка сокета врядування описує всі можливості створення: корисне навантаження, яке надає кожна роль, ключі рішень і те, як називати власні. Приклад Політики, що формують мітки приєднує політику, що формує мітки, поруч із двома вбудованими плагінами позначення і збирає її.