# Як ми вимірюємо

Canonical source: https://maguyva.ai/uk/methodology

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Ця сторінка — буквально те місце, де можна прочитати, на чому ґрунтуються твердження Maguyva про якість і вартість. Тут лише факти: що ми вимірюємо, як це оцінюємо і що ми не вдаємо, ніби перевірили аудитом.

Останнє оновлення: 2026-10. Поточні кількісні показники генеруються заново з вихідних даних; ця сторінка пояснює модель вимірювання. Запис із підтвердними матеріалами за посиланням відокремлює реалізовані правила тестових фікстур від неперевірених історичних цілей пошуку.

- Перевірки на тестових наборах
- Виміри language-audit
- Прозорість витрат

> Це переклад, створений за допомогою ШІ, наданий для вашої зручності. Офіційною є лише англійська версія — будь-яка угода, яку ви укладаєте під час реєстрації, регулюється саме англійським текстом. [Прочитати офіційну англійську версію](https://maguyva.ai/methodology)

**tl;dr**: У звітності про якість використовуються класифікації тестових фікстур і багатовимірні панелі аудиту мов. Статус GREEN на відомих фікстурах не означає незалежно підтверджену правильність видобування і не гарантує, що кожна ввімкнена мова відповідає цим порогам. Твердження про вартість спираються на розрахунок цін робочих просторів і відкриті операційні витрати, а не на порівняльний аудит третьої сторони.

## 1. Навіщо існує ця сторінка

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

## 2. Що ми вимірюємо

Якість інтелекту коду вимірюється передусім на мовному рушії — вилучення символів, зв'язків і графів із вихідного коду, — а не за суб'єктивними оцінками «задоволеності агента».

- Тестові набори для кожної мови: очікувані ребра та символи, які обробник має вилучити коректно
- Класифікація точності на фікстурах: GREEN вимагає точності ≥ 0.95, повноти ≥ 0.99, F1 ≥ 0.97 і щонайменше 20 очікуваних ребер, а також додаткових перевірок добору фікстур. Це правило для відомих тестових випадків, а не оцінка статистичної впевненості чи твердження, що кожна ввімкнена мова має статус GREEN.
- Виміри language-audit: точність, структурна цілісність, повнота, якість і продуктивність на дошці валідації
- Цикли за корпусами та вибірковими перевірками: ребра з реальних репозиторіїв, узяті як вибірка та класифіковані за рубрикою (правильно, хибнопозитивно, помилка типу/області/метаданих), — описані в наших дописах блогу про language-grind
- Прапорці можливостей продукту: те, що оголошує сервер (AST, аналіз локальних областей видимості, вилучення графа), окремо від розміру каталогу

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

## 3. Зелений статус проти незалежно підтвердженого

Дошка language-audit використовує кілька осей, щоб один зелений індикатор не можна було прочитати як «доведено бездоганно». Ключові числа на дошці зазвичай розбиті на:

- overall_green — відсутність регресій відносно тестових наборів на основі власних знімків і пов'язаних перевірок на корпусах (необхідна, але не достатня умова)
- independently_verified — має сильний сигнал оцінювання, наприклад початкова вибірка для вибіркової перевірки (включає мови, де все ще видно оцінені помилки)
- verified_clean / нуль оцінених помилок на вибіркових ребрах — суворіша підмножина оцінених мов
- добір тестових випадків / довіра до еталона — чи вважаються самі тестові набори надійними еталонами
- структурні прапорці — вилучення графа та можливість AST не тотожні членству в каталозі

Маркетинговий лічильник мов (наприклад, «285+ мов») — це розмір каталогу: налаштовані мови та записи сервера. Розмір каталогу не є SLA якості AST. Надавайте перевагу багаторівневій звітності перед єдиною ефектною цифрою. Актуальні можливості продукту див. у розділах «Сумісність» і «Посібники з мов»; оповідні деталі — у дописі блогу про рекурсивне самовдосконалення мов.

## 4. Якість пошуку та отримання результатів

Якість семантичного пошуку мультимодальна: об'єднуються текст, AST, граф та ембединги. Ми документуємо свідомі інженерні компроміси, а не заявляємо про неперевершену якість пошуку:

- Ембединги використовують комерційне сімейство моделей (voyage-4-large станом на знімок блогу за червень 2026 року), обране відносно публічних рейтингів якості пошуку на момент ухвалення рішення
- Вектори бінарно квантуються заради зберігання та вартості; це свідомо жертвує частиною точності пошуку заради дешевшого та швидшого пошуку Геммінга без окремої векторної бази даних
- Маршрутизація за наміром і ваги злиття — це спроєктовані евристики. У пропозиції від грудня 2025 року початкову частку запитів без результатів оцінювали приблизно у 15%, а цільове значення встановили нижче 5%; ми не надали набору запитів або протоколу вимірювань, що підтверджує таке зниження. Запис із підтвердними матеріалами виправляє попереднє твердження про досягнуте поліпшення.
- Дописи блогу містять розділи «що все ще недосконале» — недосконалі сигнали є частиною запису, а не виносками для приховування

## 5. Твердження про вартість

Мова вартості в Maguyva стосується структури ціноутворення та операційної прозорості, а не формального дослідження TCO, сертифікованого третьою стороною.

- Ціноутворення робочого простору: рахунок виставляється за репозиторіями, проіндексованими рядками та частотою перезбирання, а не за місце людини чи агента. FAQ і текст тарифів докладно описують ці виміри.
- Приклад ціни порівнює 25 платних місць за ілюстративною ціною $19–$59 за місце з Crew за $49/місяць. Економія залежить від розміру команди й альтернативного продукту; це не порівняння однакових функцій і не незалежний конкурентний бенчмарк.
- Чесність операційних витрат: сторінка /team публікує реальну помісячну розбивку витрат на ПЗ (підписки, інструменти MCP/пошуку, витрати, залежні від використання). Це прозорість «клієнта номер нуль», а не аудійована фінансова звітність.
- Витрати на ембединги та інфраструктуру — це прийняті продуктові витрати (преміальні ембединги, зберігання, перезбирання графа). Ми несемо їх навмисно і говоримо про це в дописі про voyage-4-large та в описі ціноутворення.

## 6. Чого ми не заявляємо

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

- Жодної всеосяжної гарантії абсолютної точності для кожної мови. Пороги для тестових наборів застосовуються для кожної мови до відомих випадків; залишкові помилки в реальному коді очікувані, і ми постійно працюємо над їх усуненням.
- Жодного твердження, що overall_green дорівнює ідеальному в продакшені вилученню для кожної ідіоми репозиторію
- Жодного пакета сертифікації відповідності від третьої сторони, заявленого як методологічний артефакт на цій сторінці (факти про обробку даних див. у розділі «Безпека», а не значки відповідності)
- Жодного незалежного багатопостачальницького порівняння на спільних корпусах, опублікованого як постійна оцінна таблиця
- Результати пошуку та аналізу надаються з докладанням усіх зусиль, але без гарантій згідно з Умовами обслуговування — Maguyva не замінює рев'ю коду, тестування чи аудит безпеки

## 7. Як перевірити самостійно

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

- Почніть безкоштовно: невеликі репрезентативні репозиторії першого ж дня кращі, ніж індекс усієї компанії
- Використовуйте інструменти MCP (intelligent_search, find_symbol, dependency_search) і відкривайте процитовані шляхи
- Прочитайте «Як це працює», щоб зрозуміти архітектуру завантаження даних та пошуку
- Прочитайте «Сумісність» і «Посібники з мов», щоб дізнатися рівні можливостей, а не лише розмір каталогу
- Прочитайте «Безпека» і «Конфіденційність» про обробку даних; ця сторінка їх не замінює

- [Підтвердні матеріали та виправлення щодо якості пошуку (англійською)](https://maguyva.ai/evidence/search-quality.md)
- [Підтвердні матеріали щодо якості пошуку (JSON, англійською)](https://maguyva.ai/evidence/search-quality.json)
- [Як це працює](https://maguyva.ai/uk/docs/how-it-works)
- [Сумісність](https://maguyva.ai/uk/docs/compatibility)
- [Ціни](https://maguyva.ai/uk/pricing)
- [Команда](https://maguyva.ai/uk/team)
- [Безпека](https://maguyva.ai/uk/security)
- [Конфіденційність](https://maguyva.ai/uk/privacy)
- [Статус](https://maguyva.ai/uk/status)
- [Рекурсивне самовдосконалення мов: шліфування інтелекту коду для ~280 мов](https://maguyva.ai/uk/blog/autonomous-quality-loops-language-grind)
- [Чому ми оновили пошук коду до voyage-4-large](https://maguyva.ai/uk/blog/upgrading-code-search-to-voyage-4-large)

Запитання про межі вимірювання або про твердження, яке видається необґрунтованим: [support@maguyva.ai](mailto:support@maguyva.ai)