Методологія
Вкладка «Методологія» — це місце, де адміністратор задає, як агент працює над проєктом: стандарти, яких він завжди дотримується, методологію для кожної ролі та довідкові файли, які він читає під час кожного запуску. Саме так ви змушуєте Makion дотримуватися точного способу роботи вашої команди, вашими словами, замість загальних типових налаштувань ABAP.
Усе на цій вкладці може редагувати лише адміністратор проєкту або суперадмін. Решта користувачів бачать вкладку в режимі лише для читання з поміткою «Read-only — an admin edits these.», тож вони можуть бачити стандарти, яких дотримується агент, але не можуть їх змінювати.
Методологія задається для кожного проєкту. Якщо дві команди працюють у різних системах SAP з різними стандартами, створіть для них окремі проєкти — див. Configuring projects — і налаштовуйте методологію кожного проєкту незалежно.
Як поєднуються шари#
Makion спрямовує агента з трьох шарів одночасно. Під час кожного запуску вони поєднуються в контекст, з яким працює агент:
- Базові правила — застосовуються завжди, для кожної задачі в проєкті.
- Методологія обраної ролі — системний промпт для ролі, яку розробник обрав у Chat (наприклад, роль із записом проти ролі перегляду лише для читання).
- Файли бази знань — стандарти й приклади, які матеріалізуються в контекст агента під час кожного запуску.
Отже, окремий запит формується базовими правилами + обраною роллю + базою знань разом. Базові правила задають фундаментальну істину для всього проєкту; роль звужує її до типу задачі; база знань постачає конкретні патерни та приклади.
Три блоки#
| Блок | Що містить | Хто може редагувати |
|---|---|---|
| Базові правила | Метод і стандарти, яких агент завжди дотримується в цьому проєкті | Адміністратор проєкту / суперадмін |
| Ролі | Методологія для кожної ролі, яку розробник може обрати в Chat | Адміністратор проєкту / суперадмін |
| База знань | Файли, які агент читає під час роботи | Адміністратор проєкту / суперадмін |
Базові правила#
Базові правила — це метод і стандарти, яких агент завжди дотримується в цьому проєкті, незалежно від обраної ролі. Рядок стану підказує, звідки походять поточні правила:
- «Customized for this project.» — проєкт має власні базові правила.
- «Using built-in ABAP defaults — edit to customize.» — проєкт досі використовує вбудовані типові налаштування ABAP від Makion; відредагуйте їх, щоб зробити своїми.
| Елемент керування | Що робить |
|---|---|
| Текстове поле базових правил | Великий редактор із повним текстом базових правил, які агент завжди застосовує. |
| Save base rules | Зберігає ваші зміни та перемикає стан на «Customized for this project.» |
Пишіть базові правила простою мовою: угоди про іменування, вимоги clean-core, дисципліну транспортів, звички рев'ю — усе, чого агент має дотримуватися в кожній задачі.
Ролі#
Блок «Ролі» визначає методологію для кожної ролі, яку розробник може обрати в Chat. Роль — це одночасно межа дозволів і спосіб роботи: ролі лише для читання не можуть змінювати SAP, і це обмеження реалізоване в наборі інструментів, які отримує агент, а не просто описане текстом. Повну картину того, як ролі окреслюють дії агента, див. у How roles work та Developer roles.
Ролі відображаються як вкладки — по одній на роль. Налаштована роль має позначку «custom», тож ви одразу бачите, які ролі підлаштували, а які досі на типових налаштуваннях.
Для обраної ролі можна редагувати:
| Елемент керування | Що робить |
|---|---|
| Назва | Відображувана назва ролі, як вона з'являється у виборі ролей у Chat. |
| Опис | Короткий рядок, що описує, коли використовувати цю роль. |
| Може змінювати SAP (запис) | Чи може ця роль писати в SAP. Знято позначку = лише для читання: агенту передаються тільки інструменти читання, і він фізично не може змінити SAP. |
| Текстове поле вмісту | Методологія / системний промпт ролі — як агент має підходити до цього типу задач. |
| Save role | Зберігає назву, опис, прапорець запису та вміст для цієї ролі. |
| Reset to default | Для налаштованої вбудованої ролі відновлює типове значення, поставлене Makion. Прибирає позначку «custom». |
«Може змінювати SAP (запис)» визначає, чи може агент змінювати вашу систему в цій ролі. Залиште позначку знятою для всього, що має лише досліджувати або переглядати. Лише для читання означає лише для читання — інструменти запису ніколи не передаються агенту.
Налаштування ролей — найважливіша за важелем частина вкладки «Методологія»: саме так адміністратор закодовує «ось як саме ми будуємо, переглядаємо та підтримуємо ABAP» у кожній розмові. Починайте з Configuring projects, коли розгортаєте методологію нового проєкту.
База знань#
База знань містить файли, які агент читає під час роботи — ваші стандарти, патерни та розібрані приклади. Ці файли матеріалізуються в контекст агента під час кожного запуску, тож усе, що ви сюди помістите, є довідковим матеріалом, на який агент може покладатися напряму.
| Елемент керування | Що робить |
|---|---|
| Список файлів | Усі файли знань проєкту за шляхом. |
| Add | Створити новий файл. Задайте шлях на кшталт knowledge/patterns/my-rule.md. |
| Редактор | Вміст обраного файлу. |
| Edit | Відкрити обраний файл для змін. |
| Save | Зберегти вміст поточного файлу. |
| Delete | Видалити обраний файл з бази знань. |
Використовуйте теки у шляху (наприклад, knowledge/patterns/… або knowledge/examples/…), щоб підтримувати базу впорядкованою в міру її зростання. Хороші кандидати: канонічний приклад «як ми структуруємо звіт», бажаний патерн обробки помилок, шпаргалка з іменування, чек-лист, який агент має пройти перед завершенням.
Базові правила найкраще підходять для коротких, завжди істинних принципів. База знань найкраще підходить для довшого довідкового матеріалу та конкретних прикладів, які агент має наслідувати. Разом вони дають змогу «нарощувати стандарт» з часом, не роздуваючи базові правила.
Куди далі#
- How roles work — як роль окреслює те, що агент може й не може робити.
- Developer roles — вбудовані ролі та призначення кожної.
- Configuring projects — розгортання проєкту та його методології.
- Specifications — версіоновані специфікації розробки, з яких працює агент.