Перейти до вмісту

Як працює Maguyva

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

Проблема контексту#

У міру зростання ваших проєктів ШІ-агенти стикаються з такими труднощами:

  • Обмеження вікна контексту - Занадто багато інформації переобтяжує ШІ-моделі
  • Нерелевантні дані - ШІ-агенти витрачають токени на непотрібну інформацію
  • Низька продуктивність - Зниження точності та повільніша обробка
  • Ручне керування - Розробники витрачають години на ручне впорядкування контексту
  • Вищі витрати - Без керування контекстом витрати на токени зростають з кожним запитом

Що більшим стає проєкт, то більше шуму потрапляє у вікно контексту — і точність агента через це падає.

Рішення Maguyva#

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

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

Пошук поєднує 5 режимів пошуку: semantic, AST, symbol, dependency і text. Результати об'єднуються й ранжуються так, щоб важливі символи виринали раніше за малоцінні допоміжні елементи.

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

1. Обробка репозиторію#

Після підключення GitHub Maguyva сканує репозиторій у хмарі та видобуває саме те, що потрібно агенту для міркувань:

  • Аналіз структури коду
     - Розбирає файли на символи, посилання та архітектурні межі
  • Розв'язання залежностей
     - Мапує, як файли, модулі й символи залежать один від одного
  • Інтеграція документації - Підтягує документацію репозиторію та суміжні довідкові матеріали поряд із кодом

2. Спеціалізовані шари пошуку#

Замість одного універсального індексу Maguyva будує кілька пошукових поверхонь, що швидко відповідають на різні запитання й спираються на різні докази:

Бюджет контексту: Maguyva повертає ранжовані фрагменти коду з шляхами до файлів і номерами рядків, а не вивалює цілі файли в контекст. Реальне скорочення токенів залежить від розміру репозиторію та конкретики запиту.

Маршрутизація та ранжування#

  • Оцінка релевантності
     - Обирає потрібний режим пошуку та піднімає важливі результати нагору
  • Зниження шуму - Прибирає шаблонний код, дублікати й малоцінні збіги
  • Пріоритизація контексту - Упорядковує результати так, щоб агент бачив ключові символи раніше за допоміжні для крайніх випадків

Збережені представлення#

  • Семантичний пошук
     - Знаходить концептуально схожий код і документацію, навіть коли точні слова відрізняються
  • Символьні та структурні представлення - Підтримує точний пошук символів, посилань і запитів на основі AST
  • Аналіз графа залежностей
     - Відстежує викликачів, імпорти та радіус впливу по всій кодовій базі

3. Шар інструментів Model Context Protocol (MCP)#

Maguyva постачається як хмарний MCP-сервер. Ваш агент викликає інструменти для потрібного йому ракурсу, замість того щоб покладатися на пам'ять моделі про вашу архітектуру з нуля. Чотири поверхні вище — це згруповані представлення конкретних інструментів: Семантичний пошук об'єднує semantic_search і intelligent_search; Пошук символів об'єднує find_symbol і get_task_context; Структурний пошук об'єднує structural_search і text_pattern_search; Граф залежностей об'єднує dependency_search і analyze_dependencies — а також get_file, repository_context і ask_maguyva як допоміжні утиліти. Повний перелік усіх 11 інструментів — у довідник MCP API.

Переваги сумісності з MCP#

  • Використовуйте більше чи менше інструментів - Спирайтеся на Maguyva активно під час планування або просто звірте ризиковану зміну
  • Краща перевірка планів - Звіряйте ідеї з реальними символами, посиланнями та документацією перед редагуванням
  • Чіткіший радіус ураження - Інструменти залежностей і графа показують, що може зламатися при зміні символу
  • Сумісність із майбутнім - Працює з будь-яким клієнтом, що підтримує стандарт MCP

Технічна архітектура#

Безпечний конвеєр обробки#

Функції безпеки#

  • Безпека транспорту - З'єднання із сервісом використовують HTTPS/TLS
  • Кероване сховище - Проіндексовані дані зберігаються на керованій інфраструктурі із шифруванням на рівні сховища у стані спокою
  • Ізоляція просторів імен - Дані репозиторію обмежені простором робочого середовища й простором імен на рівні конвеєра та запитів до бази даних
  • Контроль доступу - Доступ до репозиторію обмежений межами організації та простору імен

Характеристики продуктивності#

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

Чого очікувати#

Розумно фільтруючи й упорядковуючи контекст вашої кодової бази, Maguyva допомагає ШІ-агентам працювати ефективніше:

  • Точніше планування - Агенти можуть перевіряти підхід на реальному репозиторії, перш ніж почати писати код
  • Безпечніший рефакторинг - Перевірки радіуса ураження та залежностей зменшують ризик випадкових поломок
  • Менше витрачених токенів - Повертаються лише релевантні фрагменти, а не цілі файли
  • Швидше розуміння репозиторію - Модель отримує обґрунтовані відповіді швидко, замість того щоб заново відкривати структуру проєкту щоразу

Результати залежать від розміру та складності вашої кодової бази й типів запитів, які обробляє ваш ШІ-агент.

Підтримка актуальності індексу#

Автоматичні оновлення#

  • Синхронізація репозиторію - Оновлюється за синхронізаціями з GitHub у міру змін коду
  • Інкрементна обробка - Обробляються лише змінені файли для ефективності
  • Контекст із урахуванням гілок - Підтримує окремі індекси для кожної гілки git, щоб агенти бачили правильний контекст для кожної гілки

Початок роботи#

Готові спробувати?

  1. Почати безкоштовно - Кредитна картка не потрібна
  2. Підключіть репозиторій - прив'яжіть репозиторій GitHub у порталі Maguyva
  3. Спрямуйте агента на Maguyva - Використовуйте інструменти MCP під час планування, перевірки чи редагування (гайд з установлення)

Почати безкоштовно →

Керування репозиторієм#

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