Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Что ваш ассистент может делать с Aggrega

Как только ваш ассистент подключён к MCP-серверу Aggrega, он работает с тем же исполняемым файлом 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 в кеш и записывает её lock-файл, а build рендерит сущность Release в её артефакты — по умолчанию в памяти или в dist/ в корне рабочего пространства, когда ассистент просит их записать. Отклонённая сборка возвращает диагностику, которая сообщает, что исправить. См. Разрешение того, от чего зависит сущность Release и Сборка на основе содержимого, уже закреплённого сущностью Release.

Перенос проекта из другого инструмента

import читает описание, созданное другим инструментом, и записывает черновики файлов Aggrega в рабочее пространство, чтобы вы их просмотрели. Форматы, которые он читает, см. в Преобразование стороннего описания в черновики сущностей и aggrega import.

Публикация, подписание и отзыв

Четыре инструмента помещают сущность или артефакт в реестр, подписывают опубликованное там или отзывают его с помощью подписанного маркера. Их изменения доходят до каждого, кто разрешает зависимости из этого реестра, и ни одно из них нельзя забрать у того, кто уже его получил, поэтому именно об этих инструментах стоит подумать, прежде чем их разрешать. См. Публикация, подписание и отзыв.

Запуск любой команды

Для клиента, который запустил сервер на вашем собственном компьютере через стандартный ввод и вывод, сервер также предлагает инструмент для каждой команды, которую вы могли бы ввести, названный по ней: cli-build запускает aggrega build, cli-validate запускает aggrega validate и так далее. Сервер, доступный по HTTPS, не предлагает ни одного из них.

Что он может делать, не спрашивая вас

Ассистент, подключённый через стандартный ввод и вывод, может вызывать каждый инструмент, который предлагает сервер, не спрашивая вас, если ваш клиент не настроен это запрещать. Именно в клиенте вы разрешаете и запрещаете инструменты по имени. Что ассистент может делать, не спросив вас заранее называет операции, выходящие за пределы вашего рабочего пространства, а Сужение того, что объявляет сервер сокращает список инструментов, когда ваш клиент не принимает его целиком.