Перейти до вмісту
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, не пропонує жодного з них.

Що він може робити, не запитуючи вас

Асистент, під’єднаний через стандартні введення й виведення, може викликати кожен інструмент, який пропонує сервер, не запитуючи вас, якщо ваш клієнт не налаштовано це забороняти. Саме у вашому клієнті ви дозволяєте й забороняєте інструменти за назвою. Що асистент може робити, не запитавши вас спершу називає операції, що виходять за межі вашого робочого простору, а Звуження того, що оголошує сервер скорочує список інструментів, коли ваш клієнт не приймає його повністю.