# Jak měříme

Canonical source: https://maguyva.ai/cs/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).

Tato stránka je doslova místem, kde si můžete přečíst, na čem jsou založena tvrzení Maguyva o kvalitě a nákladech. Obsahuje pouze fakta: co měříme, jak to hodnotíme a co nepředstíráme, že bylo auditováno.

Naposledy aktualizováno: 2026-10. Aktuální počty se znovu generují ze zdrojových dat; tato stránka vysvětluje model měření. Odkazovaný záznam důkazů rozlišuje implementovaná pravidla testovacích případů od neověřených historických cílů vyhledávání.

- Kontroly testovacích případů
- Dimenze auditu jazyků
- Transparentnost nákladů

> Toto je překlad vytvořený s pomocí AI, poskytnutý pro vaše pohodlí. Závaznou je pouze oficiální anglická verze — jakákoli smlouva, kterou uzavřete při registraci, se řídí anglickým textem. [Přečíst oficiální anglickou verzi](https://maguyva.ai/methodology)

**tl;dr**: Reportování kvality využívá klasifikaci testovacích případů a vícerozměrné přehledy auditu jazyků. GREEN u známých případů není nezávislým ověřením správnosti extrakce ani zárukou, že tyto prahy splňuje každý zapnutý jazyk. Tvrzení o nákladech vycházejí z výpočtu cen pracovního prostoru a zveřejněných provozních nákladů, nikoli z konkurenčního auditu třetí strany.

## 1. Proč tato stránka existuje

Skeptičtí kupující by neměli muset zpětně analyzovat marketingové texty. Maguyva indexuje repozitáře a na celém webu prezentuje tvrzení o přesnosti, jazykovém pokrytí a nákladech. Tato tvrzení potřebují popis metodiky, která je upřímná ohledně rozsahu měření: co je podloženo testovacími případy, co je podloženo odborným úsudkem a co je jen rámování, nikoli nezávislá certifikace.

## 2. Co měříme

Kvalitu code intelligence měříme primárně na úrovni jazykového enginu — extrakce symbolů, vztahů a grafů ze zdrojového kódu — nikoli na základě subjektivních skóre „spokojenosti agenta“.

- Sady testovacích případů pro jednotlivé jazyky: očekávané hrany a symboly, které musí handler správně extrahovat
- Klasifikace přesnosti testovacích případů: GREEN vyžaduje precision ≥ 0.95, recall ≥ 0.99, F1 ≥ 0.97 a nejméně 20 očekávaných hran, přičemž platí další kontroly kurátorské kvality případů. Jde o pravidlo pro známé testovací případy, nikoli o odhad statistické spolehlivosti nebo tvrzení, že každý zapnutý jazyk má stav GREEN.
- Dimenze auditu jazyků: přesnost, strukturální integrita, úplnost, kvalita a výkon ve validačním přehledu
- Opakované kontroly korpusu a namátkové kontroly: vzorkované hrany z reálných repozitářů se klasifikují podle hodnoticích kritérií (správně, falešně pozitivní, chyba typu/rozsahu/metadat) — popsáno v našich blogových příspěvcích o soustavném zlepšování jazyků
- Příznaky schopností produktu: co server skutečně nabízí (AST, lokální proměnné, extrakce grafu) — odděleně od velikosti katalogu

**Důležité:** Validujeme vůči testovacím případům, které jsme sami napsali. GREEN znamená, že známé případy procházejí. Automaticky to neznamená, že se každý reálný vzor kódu extrahuje bez chyb. Toto rozlišení je záměrné a veřejné.

## 3. Zelená vs. nezávisle ověřeno

Tabule language-audit používá více os, takže jediné zelené světlo nelze číst jako „dokázaná dokonalost“. Hlavní čísla na tabuli jsou typicky rozdělena na:

- overall_green — bez regresí vůči testovacím případům z vlastních snímků a souvisejícím kontrolám korpusu (nutná, nikoli postačující podmínka)
- independently_verified — existuje silný signál odborného úsudku, například namátková kontrola (zahrnuje i jazyky, u nichž se stále vyskytují posouzené chyby)
- verified_clean / nula posouzených chyb na vzorkovaných hranách — přísnější podmnožina posouzených jazyků
- Kurátorská kvalita / důvěra v testovací orákulum — zda jsou samotné testovací případy považovány za spolehlivý zdroj správných odpovědí
- strukturální příznaky — extrakce grafu a schopnost AST nejsou totéž co pouhá příslušnost ke katalogu

Počet jazyků v marketingovém textu (například „285+ jazyků“) je velikost katalogu: nakonfigurované jazyky a položky serveru. Velikost katalogu není SLA pro kvalitu AST. Dáváme přednost vrstvenému reportování před jediným efektním číslem. Aktuální stav produktu najdete v sekcích Kompatibilita a Jazykové průvodce; podrobný popis v příspěvku o jazykovém rekurzivním sebezlepšování na blogu.

## 4. Kvalita vyhledávání a získávání dat

Kvalita sémantického vyhledávání je multimodální: text, AST, graf a embeddingy jsou fúzovány. Dokumentujeme záměrné inženýrské kompromisy, místo abychom tvrdili, že máme nepřekonatelné vyhledávání:

- Embeddingy používají komerční rodinu modelů (voyage-4-large ke dni červnového snímku blogu 2026), vybranou podle veřejných žebříčků retrieval v době rozhodování
- Vektory jsou binárně kvantizovány kvůli úložišti a nákladům; to záměrně vyměňuje část přesnosti retrieval za levnější a rychlejší Hammingovo vyhledávání bez samostatné vektorové databáze
- Směrování podle záměru a váhy fúze jsou navržené heuristiky. Návrh z prosince 2025 odhadoval výchozí podíl dotazů bez výsledků zhruba na 15 % a stanovil cíl pod 5 %; neposkytli jsme sadu dotazů ani záznam měření, který by takový pokles prokazoval. Záznam důkazů opravuje dřívější tvrzení o dosaženém zlepšení.
- Blogové příspěvky obsahují sekce „co je stále nedokonalé“ — nedokonalé signály jsou součástí záznamu, nikoli skrývanými poznámkami pod čarou

## 5. Tvrzení o nákladech

Jazyk o nákladech u Maguyva se týká cenové struktury a provozní transparentnosti, nikoli formální studie TCO certifikované třetí stranou.

- Ceny pracovního prostoru: podle počtu repozitářů, indexovaných řádků a frekvence přestavby — nikoli podle uživatelských licencí pro lidi či agenty. FAQ a popisy plánů tyto parametry rozepisují.
- Příklad cen porovnává 25 placených uživatelských licencí za ilustrativních $19–$59 za uživatele s Crew za $49/měsíc. Úspory se liší podle velikosti týmu a alternativního produktu; nejde o srovnání shodných funkcí ani nezávislý konkurenční benchmark.
- Poctivost provozních nákladů: stránka /team publikuje reálný měsíční rozpad výdajů na software (předplatná, nástroje MCP/search, náklady odvozené od využití). Jde o otevřené zveřejnění toho, jak sami používáme svůj produkt, nikoli auditovanou účetní závěrku.
- Náklady na embeddingy a infrastrukturu jsou přijaté náklady produktu (prémiové embeddingy, úložiště, přestavby grafu). Neseme je záměrně a otevřeně to říkáme v příspěvku o voyage-4-large i v popisu cen.

## 6. Co netvrdíme

Tato stránka je také seznamem ne-tvrzení. Pokud něco není na měřicí tabuli, neberte marketingový tón jako důkaz.

- Žádná plošná záruka absolutní přesnosti pro každý jazyk. Prahy testovacích případů platí pro každý jazyk na známých případech; zbývající chyby v reálném kódu očekáváme a průběžně je odstraňujeme.
- Žádné tvrzení, že overall_green znamená produkčně dokonalou extrakci pro každý idiom v každém repozitáři
- Žádný balíček certifikace shody třetí strany prezentovaný jako metodický artefakt na této ploše (viz Zabezpečení pro fakta o nakládání s daty, nikoli odznaky shody)
- Žádné nezávislé srovnání více dodavatelů na sdílených korpusech publikované jako stálý žebříček
- Výsledky vyhledávání a analýzy poskytujeme podle našich nejlepších možností v souladu s Podmínkami služby — Maguyva nenahrazuje code review, testování ani bezpečnostní audity

## 7. Jak si to ověřit sami

Zamýšlený postup kupujícího je stále tento: indexujte repozitář, kterému už rozumíte, položte jednu skutečnou otázku a prozkoumejte citace.

- Začněte zdarma: malé reprezentativní repozitáře fungují první den lépe než index celé firmy
- Použijte nástroje MCP (intelligent_search, find_symbol, dependency_search) a otevřete citované cesty
- Přečtěte si Jak to funguje pro architekturu ingestování a vyhledávání
- Úrovně schopností, nejen velikost katalogu, najdete v sekcích Kompatibilita a Průvodci jazyky
- Informace o nakládání s daty najdete v sekcích Zabezpečení a Zásady ochrany osobních údajů; tato stránka je nenahrazuje

- [Důkazy a opravy ke kvalitě vyhledávání (anglicky)](https://maguyva.ai/evidence/search-quality.md)
- [Důkazy ke kvalitě vyhledávání (JSON, anglicky)](https://maguyva.ai/evidence/search-quality.json)
- [Jak to funguje](https://maguyva.ai/cs/docs/how-it-works)
- [Kompatibilita](https://maguyva.ai/cs/docs/compatibility)
- [Ceník](https://maguyva.ai/cs/pricing)
- [Tým](https://maguyva.ai/cs/team)
- [Zabezpečení](https://maguyva.ai/cs/security)
- [Soukromí](https://maguyva.ai/cs/privacy)
- [Stav](https://maguyva.ai/cs/status)
- [Jazykové rekurzivní sebezlepšování: brousíme code intelligence napříč ~280 jazyky](https://maguyva.ai/cs/blog/autonomous-quality-loops-language-grind)
- [Proč jsme upgradovali vyhledávání v kódu na voyage-4-large](https://maguyva.ai/cs/blog/upgrading-code-search-to-voyage-4-large)

Dotazy k rozsahu měření nebo tvrzení, které vypadá neopodstatněně: [support@maguyva.ai](mailto:support@maguyva.ai)