Trợ lý của bạn có thể làm gì với Aggrega
Khi trợ lý của bạn đã kết nối với máy chủ MCP của Aggrega, nó làm việc với cùng tệp nhị phân aggrega mà bạn sẽ chạy tại terminal: nó đọc các schema và tài liệu, soạn thảo và kiểm tra các tệp của bạn, build một Release, và khi bạn cho phép, xuất bản. Trang này cho biết phạm vi đó bao gồm những gì, theo từng nhóm. Câu trả lời của chính máy chủ mới là danh sách đầy đủ, và đó là thứ nên tin cậy: hãy gọi describe-capabilities không kèm đối số, hoặc yêu cầu trợ lý làm việc đó, và nó sẽ liệt kê mọi công cụ máy chủ cung cấp cho bạn, mỗi công cụ kèm mục đích một dòng, các loại thực thể mà nó phục vụ và việc nó có ghi hay không. Khả năng tương thích nêu những gì một bản phát hành có thể thay đổi trong các công cụ.
Đọc các schema và tài liệu
Máy chủ cung cấp tài liệu tham chiếu mà trợ lý đọc trước khi viết YAML: JSON Schema của một thực thể (schema://<kind>), bất kỳ trang tham chiếu ngôn ngữ nào (langref://<path>), hướng dẫn soạn thảo (authoring://<topic>), YAML đã soạn của một thực thể catalog (catalog://<kind>/<name>), và trợ giúp của bất kỳ lệnh nào (cli://<command>). Các schema được tích hợp sẵn trong tệp nhị phân, còn các trang đến từ một bản sao tài liệu mà máy chủ lưu trong bộ nhớ đệm trên máy của bạn. Lệnh này làm gì liệt kê mọi họ tài nguyên.
Đảm nhận một vai trò, hoặc theo một quy trình làm việc
Các prompt soạn thảo đặt trợ lý vào vai một nhà phát triển, một kiến trúc sư hoặc một tác giả vận hành, hoặc tập trung nó vào một loại thực thể, để các gợi ý của nó nằm trong phạm vi những gì vai trò đó viết. Các prompt quy trình làm việc sắp xếp thứ tự các lệnh gọi cho một mục tiêu cần nhiều lệnh gọi: soạn một Aggregate mới và Release của nó, đưa một chart, module hạ tầng hoặc tệp Compose hiện có vào Aggrega, hoặc tìm ra lý do một lần build thất bại. Client của bạn liệt kê chúng như các prompt của máy chủ.
Tìm hiểu một không gian làm việc chứa gì
list-entities và list-releases cho biết không gian làm việc của bạn chứa gì và bao nhiêu, rồi trao các bản ghi theo từng trang; describe hiển thị một thực thể hoặc mọi thứ mà một Release vươn tới; config-show báo cáo cấu hình đang có hiệu lực và nguồn gốc của từng thiết lập. Máy chủ cũng báo cáo các bộ nhớ đệm, các registry đã cấu hình và các plugin mà nó phân giải. Xem Tìm hiểu một không gian làm việc chứa gì.
Soạn thảo và kiểm tra các tệp của bạn
scaffold soạn một tài liệu khởi đầu cho một loại thực thể, mang các trường mà loại đó yêu cầu, hoặc ghi một trong các ví dụ có thể chạy của tài liệu vào một thư mục mới. get-schema trả về JSON Schema của một loại, validate kiểm tra một bản nháp và chỉ ra mọi placeholder vẫn còn trong đó, lint kiểm tra các quy ước xuất bản catalog, và explain-error triển khai một chẩn đoán thành cách sửa mà nó yêu cầu. Các công cụ khác trả lời những câu hỏi nảy sinh khi chỉnh sửa: những Features nào có thể gắn vào một thành phần và thành phần đó có thể kết nối tới những gì, một mục mới nên nằm ở đâu trong tệp, và một chỉnh sửa có giới hạn được áp dụng cho một tài liệu, giữ nguyên mọi byte mà nó không chạm tới. Xem Hỏi những gì có thể gắn vào, và cái gì có thể kết nối với cái gì và Áp dụng một chỉnh sửa có giới hạn cho một tài liệu.
Phân giải và build một Release
pull phân giải các phụ thuộc của một Release vào bộ nhớ đệm và ghi lockfile của nó, còn build render Release thành các artifact của nó, mặc định trong bộ nhớ hoặc vào dist/ ở gốc không gian làm việc khi trợ lý yêu cầu ghi chúng ra. Một lần build bị từ chối trả lại các chẩn đoán cho biết cần sửa gì. Xem Phân giải những gì một Release phụ thuộc vào và Build dựa trên nội dung mà một Release đã ghim.
Đưa vào một dự án từ công cụ khác
import đọc một mô tả do công cụ khác tạo ra và ghi các tệp Aggrega dạng bản nháp vào không gian làm việc để bạn xem xét. Xem Chuyển một mô tả bên ngoài thành các thực thể bản nháp và aggrega import để biết các định dạng mà nó đọc.
Xuất bản, ký và thu hồi
Bốn công cụ đặt một thực thể hoặc một artifact vào registry, ký những gì được xuất bản ở đó, hoặc thu hồi nó bằng một dấu hiệu đã ký. Những gì chúng thay đổi đến với mọi người phân giải từ registry đó, và không phần nào có thể lấy lại từ người đã có nó, vì vậy đây là những công cụ cần cân nhắc trước khi bạn cho phép. Xem Xuất bản, ký và thu hồi.
Chạy bất kỳ lệnh nào
Với một client đã khởi động máy chủ trên chính máy của bạn, qua đầu vào và đầu ra chuẩn, máy chủ còn cung cấp một công cụ cho mỗi lệnh bạn có thể gõ, được đặt tên theo lệnh đó: cli-build chạy aggrega build, cli-validate chạy aggrega validate, và cứ thế. Một máy chủ được truy cập qua HTTPS không cung cấp công cụ nào trong số đó.
Những gì nó có thể làm mà không cần hỏi bạn
Một trợ lý được kết nối qua đầu vào và đầu ra chuẩn có thể gọi mọi công cụ mà máy chủ cung cấp mà không cần hỏi bạn, trừ khi client của bạn được thiết lập để từ chối. Client của bạn là nơi bạn cho phép và từ chối các công cụ theo tên. Những gì một trợ lý có thể làm mà không cần hỏi bạn trước nêu các thao tác vượt ra ngoài không gian làm việc của bạn, và Thu hẹp những gì máy chủ công bố rút ngắn danh sách công cụ khi client của bạn không nhận hết.