Налаштування проєктів
Це сторінка, яка відповідає на центральне питання: як зробити, щоб Makion дотримувався наших точних інструкцій, коли він будує код або діє в системі? Відповідь — це проєкт. Проєкт поєднує SAP-систему з налаштуваннями та стандартами, що формують кожне виконання задачі проти неї — AI-рушій, стиль ABAP, чи можна виконувати без нагляду, а також правила, ролі та приклади, які агент читає під час кожного виконання.
Один раз добре налаштуйте проєкт — і кожен розробник, який у ньому працює, отримує ту саму передбачувану поведінку. Ця сторінка проводить усе налаштування по порядку.
Один проєкт на «команда × SAP-система × спосіб роботи». Якщо дві команди мають різні стандарти або різні системи, дайте їм окремі проєкти й налаштуйте кожен незалежно.
Чотири речі, що керують агентом#
Поведінка Makion у проєкті походить із чотирьох шарів, заданих на двох вкладках:
| Шар | Де ви його задаєте | Що він контролює |
|---|---|---|
| Ціль і рушій | Вкладка Адмін → таблиця «Проєкти» | Яка SAP-система, який стиль ABAP, який AI-рушій і чи дозволені автономні виконання. |
| Базові правила | Вкладка Методологія | Стандарти, яких агент завжди дотримується — іменування, патерни, що робити / чого не робити. |
| Методології ролей | Вкладка Методологія | Як поводиться кожна роль і чи може ця роль писати в SAP. |
| База знань | Вкладка Методологія | Стандарти та опрацьовані приклади, які агент читає під час кожного виконання. |
Точний механізм: на кожну задачу Makion поєднує базові правила + роль, яку обрав розробник + файли бази знань у контекст, з якого працює агент. Тож точні базові правила + хороші приклади = агент надійно «дотримується інструкцій». Сторінка Методологія повністю пояснює це нашарування; ця сторінка розповідає, у якому порядку це робити.
Чекліст налаштування#
1. Створіть проєкт#
У селекторі проєктів верхньої панелі клацніть + Новий проєкт і дайте йому назву. Той, хто створює проєкт, стає його адміністратором проєкту, тож може керувати його методологією та учасниками навіть без прав суперадміна. Див. Вхід і проєкти щодо селектора.
2. Спрямуйте його на SAP-систему#
Відкрийте вкладку Системи й налаштуйте SAP-підключення, на яке націлений цей проєкт — рівні DEV / QAS / PROD, де QAS і PROD лише для читання. Потім у таблиці Проєкти вкладки Адмін задайте стовпчик Система SAP на цю систему, щоб проєкт і його підключення були спарені.
3. Задайте технічний профіль проєкту (Адмін → Проєкти)#
У вкладці Адмін таблиця Проєкти має один рядок на проєкт. Задайте:
| Стовпчик | Варіанти | Що робить |
|---|---|---|
| Проєкт | — | Назва проєкту (мітка рядка лише для читання). |
| Система SAP | ваші налаштовані системи | На яку SAP-систему націлений цей проєкт. |
| Версія ABAP | modern (7.40+ / S/4) або classic (<7.40 / ECC) | Формує, які мовні конструкції та патерни використовує агент — сучасний inline / CDS / RAP-стиль проти класичного ECC-безпечного ABAP. Задайте це відповідно до цільової системи. |
| Рушій | Claude, Gemini, Codex, Kimi або Grok | Яка AI-модель виконує цей проєкт. Див. AI-рушії та вхід. |
| Автономний | прапорець | Коли увімкнено, цей проєкт може виконувати виконання агента без нагляду. Див. Автономний режим. |
Увімкнений автономний режим дозволяє виконання агента без нагляду. Автономна робота все одно лише для читання й пропонує зміни в чергу змін (ship queue), яку людина схвалює та застосовує — але лишайте його вимкненим для проєктів, які мають виконуватися тільки інтерактивно. Див. Автономний режим.
4. Напишіть методологію (вкладка «Методологія»)#
Відкрийте вкладку Методологія й задайте три блоки — саме тут насправді кодується «дотримуйся наших точних інструкцій»:
- Базові правила — стандарти, яких агент завжди дотримується в цьому проєкті, незалежно від ролі: угоди про іменування, очікування щодо clean-core, дисципліна транспортів, звички рев'ю. Напишіть їх звичайною мовою й клацніть Зберегти базові правила. Точні, недвозначні базові правила — це найбільший важіль того, наскільки вірно працює агент.
- Ролі — для кожної ролі, яку розробник може обрати в Чаті, відредагуйте її методологію та перемкніть Може змінювати SAP (запис). Знята галка означає лише читання: агентові фізично передаються тільки інструменти читання. Налаштуйте кожну роль так, щоб точно описати, як ваша команда будує, рев'юїть або підтримує ABAP. Див. Як працюють ролі.
- База знань — додайте стандарти та опрацьовані приклади як файли (наприклад, канонічний «як ми структуруємо звіт», бажаний патерн обробки помилок, чекліст перед завершенням). Вони читаються під час кожного виконання, тож це найкраще місце для конкретних прикладів, які агент має наслідувати.
5. Додайте розробників#
Надайте доступ людям, які працюватимуть у проєкті:
- Суперадмін використовує Адмін → Доступ до проєктів і ставить галку для цього проєкту в рядку кожного розробника.
- Адміністратор проєкту використовує вкладку Учасники проєкту — Додати розробника, потім задає його роль.
Повні деталі — у Користувачі та доступ.
Після налаштування#
- Розробники обирають проєкт у селекторі верхньої панелі, підключаються в Системах і працюють у Чаті.
- Уточнюйте в міру навчання: жорсткіше формулюйте базові правила, додавайте приклади в базу знань і дозвольте Retro виявляти виправлення правил і знань із реальних сесій.
- Усе, що робить агент, записується — див. Журнал аудиту.
Куди далі#
- Методологія — базові правила, ролі й база знань у повному обсязі.
- AI-рушії та вхід — оберіть і автентифікуйте рушій проєкту.
- Користувачі та доступ — надання доступу й керування учасниками.
- Автономний режим — як виконання без нагляду пропонують зміни для схвалення людиною.