Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Features và chính sách

Trang này giải thích một ý tưởng, gắn một hành vi vào một thành phần và kiểm tra kết quả bằng một chính sách, và không phải là một workspace có thể chạy được. Chính sách dừng bản build khi dữ liệu bị hạn chế đến một mô hình được quản lý mà chưa được che cho thấy cả hai trong một workspace mà bạn build; hãy ghi nó vào một thư mục của riêng bạn bằng:

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

Sau đó nó in ra các lệnh cần chạy tiếp theo:

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

Một Feature được gắn, và được hiện thực hóa bởi một FeatureRecipe

Một Feature là một hành vi mà thành phần không tự mang — che dữ liệu, sao lưu, ingress, thông tin xác thực — mà một tác giả gắn vào nó dưới features:. Ai gắn nó tùy thuộc vào ai quyết định đầu vào của nó: nhà phát triển gắn, trong Aggregate, một Feature có hành vi là một phần của bản chất ứng dụng; người vận hành gắn, trong Release, một Feature có toàn bộ đầu vào mang tính vận hành. Dù theo cách nào, Manifest cũng ràng buộc mỗi Feature với một FeatureRecipe, và FeatureRecipe đó quyết định cách Feature được hiện thực hóa cho mục tiêu.

Trong ví dụ, nhà phát triển gắn core/data-masking của thư viện chuẩn vào một gateway AI và liệt kê những gì cần che, từ aggregate.yaml với các chú thích được lược bỏ:

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]

Nhà phát triển không chỉ định địa chỉ, guardrail hay thiết lập nhà cung cấp nào. Manifest ràng buộc core/data-masking với helm/data-masking-litellm, thứ ghi phần che dữ liệu vào cấu hình mà Recipe của chính gateway kết xuất, thông qua các bước của pipeline plugin khép lại quá trình kết xuất, và thêm bên cạnh một module mà gateway nạp. Mọi tệp khác mà bản build ghi đều giống hệt từng byte với một bản build không có việc gắn này.

Những gì việc gắn không làm được nêu rõ cẩn thận như những gì nó làm: văn bản không khớp mẫu nào và không được bộ nhận dạng phát hiện sẽ đi qua nguyên vẹn, gateway và hai dịch vụ nhận dạng nhìn thấy văn bản gốc, và lưu lượng không đi qua gateway thì không bị động đến. Các chú thích của FeatureRecipe liệt kê những gì gateway này từ chối và những gì nó chuyển tiếp như đã gửi.

Nhãn quyết định một Feature có thể đặt ở đâu

Nhãn là danh tính ngữ nghĩa của một thành phần, và chúng điều khiển việc đặt Feature, bộ chọn socket và chính sách mà không cần bất kỳ thay đổi nào đối với trình biên dịch. appliesTo của một Feature là một bộ chọn nhãn trên thành phần mà Feature được gắn vào. core/data-masking khai báo appliesTo: "dataplane.aggrega.ai/content-masking", một khóa trần, khớp với bất kỳ thành phần nào mang nhãn đó bất kể giá trị của nó; core/gateway/litellm mang nhãn này, với giá trị entity-recognition. Một bộ chọn cũng có thể khớp giá trị, component.aggrega.ai/type in (server, worker), hoặc loại trừ một nhãn, !model.aggrega.ai/capability; các yêu cầu của một bộ chọn, phân tách bằng dấu phẩy, đều phải thỏa mãn, và Feature chỉ được gắn vào thành phần mà chúng khớp. Gắn dựa trên nhãn trình bày toàn bộ ngữ pháp bộ chọn.

Hai khai báo nữa ràng buộc việc gắn:

  • Khả năng tương tác. Một Feature có thể nêu tên các Features mà nó không thể dùng chung một thành phần. core/data-masking khai báo interoperability.conflictsWith: [core/semantic-caching], nên một bản build mà trong đó một thành phần rốt cuộc mang cả hai — được gắn trên chính thành phần đó, hoặc trên một hệ thống con hay ranh giới chứa nó — sẽ dừng lại trước khi kết xuất.
  • Yêu cầu bắt buộc về sự hiện diện. Một Component có thể yêu cầu phải có một việc gắn thuộc một loại nhất định. example/compute/service của catalog mang chú giải features.aggrega.ai/requiredType.monitoring: core/prometheus-exporter, nên một bản build mà trong đó một phiên bản của nó không mang core/prometheus-exporter ở bất kỳ phạm vi nào sẽ dừng lại và nêu tên yêu cầu monitoring. Hãy lặp lại khóa với một hậu tố khác để yêu cầu một loại thứ hai; xem mục “Presence mandates” trong entities/component.md để biết một yêu cầu bắt buộc về sự hiện diện khác với một vị trí gắn như thế nào.

Một Feature được đặt trên thành phần có hành vi mà nó thay đổi. core/caller-allowlist được gắn vào một máy chủ mô hình, chứ không phải vào các gateway được phép gọi nó; Máy chủ mô hình chỉ gateway của nó mới được gọi build điều đó.

Một chính sách đọc đồ thị đã được build

Chính sách được người vận hành gắn dưới plugins.governance trong cấu hình workspace, mỗi lần gắn ở một vai trò. Một chính sách ở vai trò label-transform thêm nhãn vào đồ thị; một chính sách ở vai trò ir-verdict phán xét đồ thị và có thể dừng bản build. Engine Rego chạy cả hai; nó được biên dịch sẵn trong CLI, và governance/rego là thực thể Plugin của nó trong catalog thư viện chuẩn.

Quy tắc đầu tiên dưới đây gắn nhãn cho mọi gateway phân tích payload mô hình mà nó chuyển tiếp là một điểm nơi các prompt rời đi tới một nhà cung cấp mô hình. Ở vai trò này, các nút nằm tại 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"
}

Quy tắc thứ hai dừng mọi đường đi qua một gateway như vậy mà không mang việc che dữ liệu nào:

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

Id của một nút là khóa mà nút đó nằm dưới trong input.graph.spec.nodes; attached_features liệt kê các kiểu Feature được gắn vào bất kỳ nút nào trên đường đi, nên việc thuộc về được kiểm tra bằng in; quy tắc kiểm tra rằng việc che dữ liệu đã được gắn, chứ không kiểm tra nội dung nó liệt kê; và một quyết định được thu thập dưới deny được báo cáo ở mức nghiêm trọng halt, mức dừng bản build. Một quy tắc trên các đường đi chỉ thấy một nút ở nơi có cạnh đi tới hoặc rời khỏi nút đó, nên một chính sách cũng phải bao quát cả nút không được kết nối sẽ đọc chính các nút.

Người vận hành gắn engine một lần cho mỗi vai trò, mỗi lần gắn có tệp chính sách riêng; một đường dẫn tương đối dưới sources được phân giải theo thư mục của tệp cấu hình, và phép biến đổi chạy trước phán quyết:

.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

Trang governance socket là toàn bộ bề mặt soạn thảo: payload mà mỗi vai trò cung cấp, các khóa quyết định, và cách đặt tên cho của riêng bạn. Chính sách định hình nhãn gắn một chính sách định hình nhãn bên cạnh hai plugin gắn nhãn tích hợp sẵn rồi build nó.