어시스턴트가 Aggrega로 할 수 있는 일
어시스턴트가 Aggrega MCP 서버에 연결되면 터미널에서 실행하는 것과 같은 aggrega 바이너리로 작업합니다. 스키마와 문서를 읽고, 파일 초안을 작성하고 검사하며, Release를 빌드하고, 허용하면 게시도 합니다. 이 페이지에서는 그 범위를 그룹별로 설명합니다. 전체 목록은 서버 자체의 답이며, 신뢰해야 할 것도 그것입니다. 인수 없이 describe-capabilities를 호출하거나 어시스턴트에게 호출하도록 요청하면, 서버가 제공하는 모든 도구가 한 줄 용도, 다루는 엔티티 종류, 쓰기 여부와 함께 나열됩니다. 호환성에는 릴리스가 도구에서 무엇을 변경할 수 있는지가 설명되어 있습니다.
스키마와 문서 읽기
서버는 어시스턴트가 YAML을 작성하기 전에 읽는 참조 자료를 제공합니다. 엔티티의 JSON Schema(schema://<kind>), 모든 언어 참조 페이지(langref://<path>), 작성 가이드(authoring://<topic>), 카탈로그 엔티티의 작성된 YAML(catalog://<kind>/<name>), 모든 명령의 도움말(cli://<command>)입니다. 스키마는 바이너리에 내장되어 있고, 페이지는 서버가 컴퓨터의 캐시에 보관하는 문서 사본에서 가져옵니다. 하는 일에 모든 패밀리가 나열되어 있습니다.
역할을 맡거나 워크플로 따르기
작성 프롬프트는 어시스턴트를 개발자, 아키텍트 또는 운영 작성자로 설정하거나 하나의 엔티티 종류에 집중시켜, 제안이 그 역할이 작성하는 범위 안에 머물도록 합니다. 워크플로 프롬프트는 여러 번의 호출이 필요한 목표에 대해 호출 순서를 제시합니다. 새 Aggregate와 그 Release 구성, 기존 chart, 인프라 모듈 또는 Compose 파일을 Aggrega로 가져오기, 빌드가 실패하는 이유 파악 등입니다. 클라이언트는 이를 서버의 프롬프트로 나열합니다.
워크스페이스에 무엇이 있는지 알아보기
list-entities와 list-releases는 워크스페이스에 무엇이 얼마나 있는지 알려 준 다음 레코드를 한 페이지씩 넘겨줍니다. describe는 하나의 엔티티 또는 Release가 도달하는 모든 것을 보여 줍니다. config-show는 적용 중인 구성과 각 설정의 출처를 보고합니다. 서버는 캐시, 구성된 레지스트리, 해석하는 플러그인도 보고합니다. 워크스페이스에 무엇이 있는지 알아보기를 참조하십시오.
파일 초안 작성 및 검사
scaffold는 엔티티 종류에 필요한 필드를 담은 시작 문서 초안을 작성하거나, 문서의 실행 가능한 예제 중 하나를 새 디렉터리에 씁니다. get-schema는 종류의 JSON Schema를 반환하고, validate는 초안을 검사하여 남아 있는 모든 자리 표시자를 알려 주며, lint는 카탈로그 게시 관례를 검사하고, explain-error는 진단을 필요한 수정 사항으로 풀어 설명합니다. 그 밖의 도구는 편집 중에 생기는 질문에 답합니다. 어떤 Features를 컴포넌트에 첨부할 수 있고 그 컴포넌트가 무엇에 연결될 수 있는지, 새 항목이 파일의 어디에 들어가야 하는지, 그리고 문서에 범위가 제한된 편집 하나를 적용하되 건드리지 않는 모든 바이트는 그대로 유지하는 것입니다. 무엇을 첨부할 수 있고 무엇이 무엇에 연결될 수 있는지 묻기와 문서에 범위가 제한된 편집 하나 적용하기를 참조하십시오.
Release 해석 및 빌드
pull은 Release의 종속성을 캐시로 해석하고 잠금 파일을 작성하며, build는 Release를 아티팩트로 렌더링합니다. 기본적으로 메모리에서 수행하며, 어시스턴트가 쓰기를 요청하면 워크스페이스 루트의 dist/에 씁니다. 거부된 빌드는 무엇을 고쳐야 하는지 알려 주는 진단을 돌려줍니다. Release가 종속된 항목 해석하기와 Release가 이미 고정한 콘텐츠로 빌드하기를 참조하십시오.
다른 도구에서 프로젝트 가져오기
import는 다른 도구가 생성한 설명을 읽고, 검토할 수 있도록 Aggrega 초안 파일을 워크스페이스에 씁니다. 읽을 수 있는 형식은 외부 설명을 초안 엔티티로 변환하기와 aggrega import를 참조하십시오.
게시, 서명 및 철회
네 가지 도구는 엔티티나 아티팩트를 레지스트리에 올리거나, 그곳에 게시된 것에 서명하거나, 서명된 마커로 철회합니다. 이 도구들이 변경한 내용은 해당 레지스트리에서 해석하는 모든 사람에게 영향을 미치며, 이미 가져간 사람에게서는 어떤 것도 되돌릴 수 없습니다. 따라서 허용하기 전에 신중히 생각해야 하는 도구입니다. 게시, 서명 및 철회를 참조하십시오.
모든 명령 실행
자신의 컴퓨터에서 표준 입출력으로 서버를 시작한 클라이언트에는, 서버가 입력할 수 있는 각 명령에 대해 그 이름을 딴 도구도 제공합니다. cli-build는 aggrega build를, cli-validate는 aggrega validate를 실행하는 식입니다. HTTPS로 접속하는 서버는 이러한 도구를 제공하지 않습니다.
묻지 않고 할 수 있는 일
표준 입출력으로 연결된 어시스턴트는, 클라이언트에서 거부하도록 설정하지 않는 한 서버가 제공하는 모든 도구를 묻지 않고 호출할 수 있습니다. 도구를 이름으로 허용하거나 거부하는 곳은 클라이언트입니다. 어시스턴트가 먼저 묻지 않고 할 수 있는 일에서는 워크스페이스 밖까지 미치는 작업을 설명하고, 서버가 알리는 내용 좁히기는 클라이언트가 전체를 받지 못할 때 도구 목록을 줄입니다.