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.

aggrega get-schema

In JSON Schema cho một loại thực thể hoặc loại contract

Cú pháp

aggrega get-schema [kind] [flags]

Mô tả

Print the canonical JSON Schema for an embedded kind.
The kind is the lowercase-hyphenated schema name — for example component, aggregate, ir, or template-context. Entity kinds, the intermediate-representation and wire-format contracts, and the wasm-* plugin socket contracts are all addressable. The emitted bytes are identical to the distributed schema file.
Use --list to enumerate every available kind, one per line.

Cờ

CờMặc địnhMô tả
--listfalseLiệt kê mọi loại schema, mỗi loại một dòng.

Chức năng

aggrega get-schema <kind> in JSON Schema chuẩn của một loại thực thể hoặc loại hợp đồng ra đầu ra chuẩn. Schema là hợp đồng cấu trúc có thẩm quyền: các trường bắt buộc, các giá trị được phép và cách lồng nhau mà trình biên dịch chấp nhận cho loại đó. Schema được lấy từ các schema tích hợp sẵn trong tệp nhị phân, nên đầu ra luôn khớp với phiên bản aggrega mà bạn đang chạy.

aggrega get-schema --list in tên của mọi loại mà bạn có thể yêu cầu, mỗi loại một dòng — các loại thực thể mà tác giả viết (aggregate, component, feature, recipe, featurerecipe, manifest, release, plugin, schemalibrary, mappinglibrary, workloadlibrary, artifactlibrary, workload) cùng với các schema hợp đồng nội bộ mà trình biên dịch sử dụng. Hãy chạy lệnh này trước khi bạn không chắc chắn về token chính xác cần truyền vào.

Khi nào nên dùng

Hãy dùng get-schema khi bạn cần hình dạng chính xác của một loại trong lúc soạn thảo — trường nào bắt buộc, một giá trị có thể là gì, một khối lồng nhau ra sao. Đây là chuẩn tham chiếu để kiểm tra một tệp viết tay, và là điểm khởi đầu khi tìm hiểu một loại chưa quen. Vì lệnh in ra JSON Schema mà máy đọc được, bạn cũng có thể đưa nó vào một trình soạn thảo hiểu schema hoặc một công cụ kiểm tra hợp lệ.

Một trợ lý AI được kết nối qua aggrega mcp đọc cùng các byte đó từ tài nguyên schema://<kind>, nên schema mà trợ lý dựa vào để soạn thảo và schema mà bạn lấy trên dòng lệnh là giống hệt nhau. Trang này mô tả lệnh; trang không sao chép nội dung của bất kỳ schema nào — hãy chạy lệnh, hoặc mở trang tham chiếu thực thể tương ứng để xem giải thích từng trường về ý nghĩa của mỗi trường.

Ví dụ

In schema cho một Component:

Terminal window
aggrega get-schema component

Liệt kê mọi loại mà bạn có thể yêu cầu:

Terminal window
aggrega get-schema --list

Lấy một schema và xem xét một trường duy nhất bằng một công cụ JSON:

Terminal window
aggrega get-schema recipe | jq '.properties.spec'

Về vòng lặp soạn thảo mà lệnh này phục vụ — tìm hiểu hình dạng, tạo khung, điền nội dung, kiểm tra hợp lệ — xem Soạn thảo tệp Aggrega.