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

Налаштування Aggrega за допомогою ШІ-асистента

ШІ-асистент, який може виконувати команди на вашій машині, — агент для програмування у вашому терміналі чи редакторі — може налаштувати Aggrega за вас: встановити двійковий файл aggrega, додати собі навичку Aggrega й підключитися до MCP-сервера Aggrega. Асистент, який встановлює плагіни, виконує два останні кроки за один, встановивши плагін Aggrega; будь-який інший додає навичку й підключає сервер один за одним. Вставте в нього наведений нижче промпт, і він пройде ці кроки; промпт велить йому погодити з вами будь-яке встановлення, перш ніж щось встановлювати.

Коли все готово, асистент має два способи працювати з Aggrega. Навичка — це тека з файлом SKILL.md, яку асистент завантажує, коли ваш запит стосується Aggrega: вона пояснює асистентові, як відбувається цикл створення, і велить брати будь-яку відповідь про схему чи файл із двійкового файлу, а не з пам’яті. MCP-сервер, aggrega mcp, надає асистентові інструменти Aggrega — scaffold, validate, build та інші — і довідкові матеріали, на які вони спираються. Навичку й плагін описано в розділі Навичка Aggrega, сервер — у розділі Підключення сервера MCP, а те, до чого асистент має доступ через нього, — у розділі Що ваш асистент може робити з Aggrega.

Після налаштування сторінка Початок роботи, кожен покроковий посібник у розділі Імпорт і сторінка кожного виконуваного прикладу, який збирається за допомогою Aggrega, подають завдання, якого вони навчають, як промпт для вставлення в асистента поруч із командами.

Промпт

Налаштуйте для мене Aggrega крок за кроком і на кожному кроці повідомляйте, що ви запустили.
1. Запустіть `aggrega version`. Якщо команду не знайдено, спитайте мене, перш ніж установлювати Aggrega, а потім установіть його для мого користувача офіційним інсталятором: у Linux або macOS — `curl -fsSL https://aggrega.ai/install.sh | sh`, у Windows у PowerShell — `irm https://aggrega.ai/install.ps1 | iex`. Знову запустіть `aggrega version`. Якщо інсталятор вивів рядок, який треба додати до мого `PATH`, покажіть його мені.
2. Якщо `https://aggrega.ai/docs/ai-assistants/skill/` наводить спосіб встановити у вас плагін Aggrega, спитайте мене, перш ніж його встановлювати, а потім встановіть його в такий спосіб або скажіть мені, що зробити, якщо це крок, який я виконую у вашому інтерфейсі. Плагін додає навичку Aggrega і підключає вас до MCP-сервера Aggrega. Інакше запустіть `aggrega skills install --help` і знайдіть свій ідентифікатор у списку, який вона виведе. Спитайте мене, чи потрібна мені навичка в цьому проєкті чи в усіх проєктах, а потім запустіть `aggrega skills install --agent <your identifier>`, додавши `--global` для всіх проєктів. Якщо вас немає в списку, пропустіть установлення навички й повідомте про це.
3. Якщо ви встановили плагін, ви вже підключені до MCP-сервера Aggrega. Інакше підключіться до MCP-сервера Aggrega, тобто до команди `aggrega mcp`, у той спосіб, у який ви додаєте MCP-сервер, як описано для вас на `https://aggrega.ai/docs/ai-assistants/mcp-server/`. Якщо для завантаження плагіна чи сервера потрібен перезапуск або перезавантаження, скажіть мені, що зробити.
4. Після підключення викличте інструмент `describe-capabilities` без аргументів і підсумуйте те, що він перелічує.

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

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

Що відрізняється від асистента до асистента

Три частини промпту залежать від асистента: спосіб, у який він встановлює плагін Aggrega, якщо він встановлює плагіни; інакше — ідентифікатор, який він передає в --agent під час встановлення навички, і спосіб додавання сервера. Асистент визначає їх за промптом, але якщо ви їх знаєте, можна вписати їх у промпт.

АсистентВстановлення плагінаВстановлення навички без плагіна
Claude Codeclaude plugin install aggrega --marketplace aggrega-ai/aggrega-skillsaggrega skills install --agent claude-code
Codexcodex plugin marketplace add aggrega-ai/aggrega-skills, потім codex plugin add aggrega@aggregaaggrega skills install --agent codex
GitHub Copilot CLIcopilot plugin marketplace add aggrega-ai/aggrega-skills, потім copilot plugin install aggrega@aggregaaggrega skills install --agent github-copilot
Gemini CLIgemini extensions install https://github.com/aggrega-ai/aggrega-skillsaggrega skills install --agent gemini-cli
Antigravityagy plugin install https://github.com/aggrega-ai/aggrega-skillsaggrega skills install --agent antigravity або --agent antigravity-cli для Antigravity CLI
Cursorgit clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega, потім Developer: Reload Windowaggrega skills install --agent cursor

Visual Studio Code з GitHub Copilot, Kiro та OpenClaw також встановлюють плагін; розділ Встановлення плагіна наводить спосіб для кожного асистента, а також те, що OpenClaw запитує перед встановленням. Ідентифікатори, які приймає --agent, і тека, яку записує кожен із них, перелічені в aggrega skills і виводяться командою aggrega skills install --help. Спосіб, у який кожен асистент додає сервер, — власна команда або запис у його налаштуваннях чи у файлі зі списком серверів — описано для кожного клієнта окремо в розділі Підключення сервера MCP.

Коли частина промпту не застосовується

  • Асистент, який встановлює плагін, пропускає підключення сервера: його підключив плагін. Плагін не встановлює двійковий файл, тож крок 1 і далі потрібен. Якщо асистент запускає сервер плагіна поза вашим проєктом — Codex запускає його у власній теці плагіна, — навичка велить йому вказати серверу теку вашого проєкту, як описано в розділі Тека, у якій працює сервер.
  • Асистент, який не встановлює жодного плагіна і якого немає в списку --agent, пропускає встановлення навички. Після підключення він усе одно має доступ до інструментів Aggrega через MCP-сервер, а сервер під час підключення передає йому власні вказівки.
  • Асистент, який не може виконувати команди, — чат-застосунок без доступу до вашого термінала — не може виконати промпт. Встановіть двійковий файл, як описано в розділі Встановлення, і підключіть застосунок самостійно, як описано в розділі Підключення сервера MCP. Про Claude Desktop див. розділ Claude Desktop нижче.
  • Серверу, який запускає для вас хтось інший і до якого ви звертаєтеся через HTTPS, не потрібні ні двійковий файл, ні плагін, ні навичка. Натомість укажіть адресу в клієнті асистента, як описано в розділі Сервер, доступний через HTTPS.

Claude Desktop

Claude Desktop підключається до Aggrega через пакет розширення, який входить до кожного випуску, і цей пакет запускає aggrega, встановлений на вашому комп’ютері. Налаштуйте обидва компоненти на своєму комп’ютері самостійно:

  1. Встановіть aggrega у PowerShell у Windows за допомогою irm https://aggrega.ai/install.ps1 | iex або в терміналі в macOS чи Linux за допомогою curl -fsSL https://aggrega.ai/install.sh | sh. У розділі Встановлення двійкового файлу описано, що робить інсталятор.
  2. Встановіть пакет розширення, задайте його Workspace folder і перезапустіть Claude Desktop, як описано в розділі Claude Desktop на сторінці «Підключення сервера MCP».

Сеанс Claude Desktop може виконувати свої команди в хмарному контейнері, а не на вашому комп’ютері, тож наведений вище промпт, вставлений у нього, діє на контейнер. Там aggrega встановлюється й запускається з оболонки сеансу, щойно мережева політика контейнера дозволяє aggrega.ai, — власник організації дозволяє це в налаштуваннях мережевого доступу організації. Сервер MCP Aggrega там не підключено: Claude Desktop додає локальний сервер лише з налаштувань своїх розширень, а розширення запускає aggrega на вашому комп’ютері, а не той, що в контейнері.

aggrega skills install не має запису для Claude Desktop, тому сеанс Claude Desktop пропускає встановлення навички. Після встановлення розширення він має доступ до інструментів Aggrega через сервер MCP, а сервер під час підключення передає йому власні вказівки.