Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Посібник з авторингу

Цей посібник — практичне доповнення до розділів про архітектуру та довідника мови. Якщо архітектура пояснює, чому Aggrega влаштована саме так, а довідник визначає, що означає кожне поле, то цей посібник навчає, як сісти й написати — до якої сутності звернутися, у якому порядку і як CLI та ШІ-асистент допомагають вам отримати правильний файл з найменшими зусиллями.

Посібник написано одночасно для двох аудиторій: для людини, яка пише вручну в редакторі, і для ШІ-асистента, який пише від імені людини через сервер Model Context Protocol. Обидва дотримуються того самого циклу й читають ті самі довідкові матеріали, тож наведені нижче сторінки корисні обом.

Читайте в такому порядку

  1. Створення файлів Aggrega — наскрізний цикл авторингу: оберіть свою роль, вивчіть структуру, створіть заготовку, заповніть, перевірте, зберіть. Почніть звідси.
  2. Персони — чотири ролі авторингу, що співпрацюють між собою (розробник, архітектор, експлуатація, оператор), і підхід «настанови, а не примус», що лежить в їхній основі.
  3. Сутності за ролями — кожен тип сутності зіставлено з роллю, яка зазвичай ним володіє, тож ви знаєте, до якого файлу належить кожне питання.
  4. Встановлення — установлення бінарного файлу aggrega, починаючи з команд; розділ про підключення відсилає до сторінки Підключення сервера MCP.
  5. Використання Aggrega у Visual Studio Code — розширення Aggrega для Visual Studio Code: що йому потрібно, сторінка привітання, його панелі та граф топології, а також усі налаштування й команди.

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

Сторінка Вивчення Aggrega вміщує цей посібник у маршрут крізь усю документацію.

Робота з ШІ-асистентом

  1. Налаштування Aggrega за допомогою ШІ-асистента — один промпт, який слід вставити в асистента, що вміє виконувати команди, щоб він установив Aggrega, додав навичку Aggrega і підключився до сервера.
  2. Підключення сервера MCP — запис сервера для кожного клієнта окремо, де кожен клієнт його зберігає, сервер, доступний через HTTPS, і як перевірити підключення.
  3. Навичка Aggrega — інструкції, які асистент завантажує для роботи з Aggrega: їх установлення та підтримання в актуальному стані.
  4. Що ваш асистент може робити з Aggrega — що підключений сервер дає асистентові читати, перевіряти, збирати й публікувати.

Як інтерфейси асистента пов’язані з цим посібником

Сервер aggrega mcp надає цей посібник, довідник мови та схеми JSON Schema як ресурси, які асистент читає перед тим, як писати YAML, а також інструменти, що створюють заготовки сутностей і перевіряють їх. Вбудовані підказки асистента для авторингу посилаються на ці сторінки, а не переказують їх, тож цей посібник — єдине текстове джерело методу авторингу. Цикл описано в розділі Створення файлів Aggrega, а підключення — у розділі Підключення сервера MCP.