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.

Schema của Aggrega Wasm Policy Socket

Tài liệu tham khảo được sinh tự động. Không chỉnh sửa thủ công — hãy sinh lại từ JSON Schema đã xuất bản.

Id của schema: https://aggrega.ai/schemas/wasm-policy-v1beta1.schema.json

Các dạng dữ liệu truyền mà một plugin quản trị gắn ở một vai trò phán quyết tiếp nhận — PolicyInput ở vai trò ir-verdict, RenderPolicyInput ở vai trò render-verdict — và phát ra (PolicyOutput). Một phán quyết có mức độ nghiêm trọng halt dừng bản dựng với một chẩn đoán tại thời điểm dựng; một phán quyết warn hoặc info được báo cáo và bản dựng tiếp tục. Đồ thị đầu vào của giai đoạn IR là toàn bộ đồ thị IR không phụ thuộc vào capability, được tham chiếu từ ir-v1beta1.schema.json thay vì khai báo lại ở đây, để plugin policy thấy cùng chi tiết về nút, cạnh và phần gắn như trình biên dịch; tác giả plugin theo dõi phiên bản của schema IR. Đầu vào của giai đoạn render mang các tệp đầu ra đã render thay cho đồ thị. Các kiểu payload Go, Rust và TypeScript được sinh từ schema này vào các gói plugin-ABI, nên ba ngôn ngữ đọc và ghi cùng một dạng dữ liệu truyền; một guest nhập chúng từ các gói đó, hoặc thông qua bộ kit plugin của nó nếu bộ kit tái xuất chúng.

Một trong các dạng sau

  • PolicyInput
  • RenderPolicyInput
  • PolicyOutput

Định nghĩa

PolicyInput

Payload mà phân tích tĩnh trao cho socket policy: toàn bộ đồ thị IR (cùng dạng mà Topology Builder phát ra) cùng với các đường định tuyến được tính trước mà trình phân tích liệt kê kèm theo.

Thuộc tínhLoạiBắt buộcMô tả
graphIRGraphcóToàn bộ đồ thị IR không phụ thuộc vào capability, có một nguồn duy nhất từ ir-v1beta1.schema.json. Plugin policy suy luận trên đầy đủ chi tiết nút/cạnh/phần gắn thay vì một phép chiếu hẹp.
precalculated_pathsPrecalculatedPath[]cóCác đường định tuyến mà trình phân tích đã liệt kê trước để các policy có thể suy luận về khả năng tiếp cận mà không phải duyệt lại đồ thị.
sourcesPolicySource[]khôngCác tệp định nghĩa mà host đọc tại thời điểm biên dịch và trao nguyên văn cho plugin, dưới dạng một danh sách có thứ tự được sắp xếp theo đường dẫn. Host đọc các byte như nội dung mờ và không phân tích chúng. Vắng mặt khi phần gắn không khai báo nguồn nào.
settingsobjectkhôngMột đối tượng thiết lập dạng tự do mà host trao nguyên văn cho plugin. Host không phân tích hay xử lý nội dung của nó. Vắng mặt khi phần gắn không khai báo thiết lập nào.

Không cho phép thuộc tính bổ sung.

PolicyOutput

Dạng phản hồi mà plugin policy phát ra: các phán quyết đã kích hoạt trong quá trình đánh giá, mỗi phán quyết kích hoạt một chẩn đoán. Một quy tắc cho phép không phát ra gì, nên một mảng results rỗng nghĩa là không có phán quyết nào kích hoạt.

Thuộc tínhLoạiBắt buộcMô tả
resultsDiagnostic[]cóCác phán quyết đã kích hoạt, mỗi phán quyết một chẩn đoán, theo thứ tự plugin phát ra chúng. Rỗng khi không có phán quyết nào kích hoạt.
errorstringkhôngMột thông điệp lỗi được đặt khi guest đã chạy nhưng không thể hoàn tất thao tác; vắng mặt khi thành công. Nó khác với mọi chẩn đoán mà đầu ra mang theo: chẩn đoán báo cáo các vấn đề phát hiện trong một lần chạy vẫn tạo ra kết quả, còn error báo cáo rằng bản thân thao tác đã không hoàn tất. Host hiển thị một error có mặt như một lần gọi plugin thất bại.

Không cho phép thuộc tính bổ sung.

RenderPolicyInput

Payload mà một plugin quản trị gắn ở vai trò render-verdict nhận được: các tệp đầu ra đã render mà policy suy luận trên đó, thay cho đồ thị IR.

Thuộc tínhLoạiBắt buộcMô tả
artifactsRenderedArtifact[]cóCác tệp đầu ra đã render mà policy suy luận trên đó, dưới dạng một danh sách có thứ tự được sắp xếp theo đường dẫn để dữ liệu truyền giống hệt từng byte giữa các lần chạy với đầu vào giống nhau.
sourcesPolicySource[]khôngCác tệp định nghĩa mà host đọc tại thời điểm biên dịch và trao nguyên văn cho plugin, dưới dạng một danh sách có thứ tự được sắp xếp theo đường dẫn. Host đọc các byte như nội dung mờ và không phân tích chúng. Vắng mặt khi phần gắn không khai báo nguồn nào.
settingsobjectkhôngMột đối tượng thiết lập dạng tự do mà host trao nguyên văn cho plugin. Host không phân tích hay xử lý nội dung của nó. Vắng mặt khi phần gắn không khai báo thiết lập nào.

Không cho phép thuộc tính bổ sung.

RenderedArtifact

Một tệp đầu ra đã render: đường dẫn của nó và nội dung đã render tại đường dẫn đó.

Thuộc tínhLoạiBắt buộcMô tả
pathstringcóĐường dẫn đầu ra của tệp đã render, tương đối so với thư mục gốc render.
contentstringcóNội dung đã render tại đường dẫn này.
treeanykhôngCây có cấu trúc đã được phân tích của artifact này, có mặt khi host đã phân tích nội dung trước khi trao cho plugin — dạng xem JSON chuẩn tắc của một định dạng nguồn mà plugin không đọc được một cách tự nhiên (ví dụ, một artifact HCL được phân tích thành JSON). Cấp trên cùng có thể là một đối tượng, một mảng hoặc một giá trị vô hướng, khớp với dạng riêng của tài liệu đã phân tích. Vắng mặt khi host không phân tích artifact, trong trường hợp đó plugin đọc trực tiếp nội dung gốc. Host truyền cây qua một cách mờ, mang nó nguyên văn mà không diễn giải nội dung.
formatstringkhôngĐịnh dạng mà artifact được render, có mặt khi provider tạo ra nó đã khai báo. Vắng mặt khi provider tạo ra nó không khai báo định dạng nào.

Không cho phép thuộc tính bổ sung.

PolicySource

Một tệp định nghĩa được trao cho plugin: đường dẫn tên cơ sở và nội dung của tệp. Cả hai được truyền nguyên văn; host không phân tích nội dung.

Thuộc tínhLoạiBắt buộcMô tả
pathstringcóTên cơ sở của tệp nguồn. Host chỉ cung cấp tên cơ sở, không bao giờ là một đường dẫn tuyệt đối trên host, để dữ liệu truyền có tính di động và tất định.
contentstringcóNội dung của tệp nguồn, được truyền nguyên văn dưới dạng một chuỗi mờ.

Không cho phép thuộc tính bổ sung.

PrecalculatedPath

Một đường định tuyến được liệt kê trước mà trình phân tích hiện thực hóa để các quy tắc policy có thể suy luận về khả năng tiếp cận mà không phải duyệt lại đồ thị.

Thuộc tínhLoạiBắt buộcMô tả
path_idstringcóĐịnh danh ổn định cho đường này; tất định giữa các lần chạy với đầu vào giống nhau.
nodesstring[]cóChuỗi có thứ tự các ID nút mà đường đi qua, từ nguồn đến điểm cuối.
attached_featuresstring[]cóHợp được sắp xếp theo bảng chữ cái của các URI kiểu Feature gắn vào bất kỳ nút nào dọc theo đường. Ngữ nghĩa thành viên tập hợp: một Feature xuất hiện một lần ngay cả khi nhiều nút mang nó. Rỗng khi không có nút nào dọc theo đường mang phần gắn Feature nào.

Không cho phép thuộc tính bổ sung.