# Miten mittaamme

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

Tämä sivu on kirjaimellisesti paikka, jossa kerrotaan, miten Maguyva perustelee laatu- ja kustannusväitteensä todellisella datalla. Sivu sisältää vain faktoja: mitä mittaamme, miten pisteytämme sen ja mitä emme väitä auditoineemme.

Viimeksi päivitetty: 2026-10. Ajantasaiset lukumäärät generoidaan lähdedatasta; tämä sivu selittää mittausmallin. Linkitetty näyttöaineisto erottaa toteutetut testitapausten säännöt todentamattomista historiallisista hakutavoitteista.

- Fixture-portit
- Language-audit-ulottuvuudet
- Kustannusläpinäkyvyys

> Tämä on tekoälyavusteinen käännös, joka tarjotaan käyttömukavuuden vuoksi. Virallinen englanninkielinen versio on ainoa sitova versio — kaikkia rekisteröitymisen yhteydessä syntyviä sopimuksia säätelee englanninkielinen teksti. [Lue virallinen englanninkielinen versio](https://maguyva.ai/methodology)

**tl;dr**: Laaturaportointi käyttää testitapausten luokituksia ja moniulotteisia kieliauditoinnin näkymiä. GREEN tunnetuissa testitapauksissa ei tarkoita riippumattomasti todennettua poiminnan oikeellisuutta eikä takaa, että jokainen käytössä oleva kieli täyttää nämä raja-arvot. Kustannusväitteet perustuvat työtilan hinnoittelulaskelmiin ja julkisiin käyttökustannuksiin, eivät kolmannen osapuolen kilpailijavertailuun.

## 1. Miksi tämä sivu on olemassa

Skeptisten ostajien ei pitäisi joutua reverse-engineeraamaan markkinointitekstiä. Maguyva indeksoi repositoryjä ja näyttää tarkkuus-, kielikattavuus- ja kustannusväitteitä koko sivustolla. Nämä väitteet tarvitsevat menetelmäsivun, joka on rehellinen mittausalueesta: mikä on fixture-tuettua, mikä on arviointiin perustuvaa ja mikä on framingia riippumattoman sertifioinnin sijaan.

## 2. Mitä mittaamme

Koodiälyn laatua mitataan ensisijaisesti kielimoottorissa — symbolien, suhteiden ja graafien poiminnassa lähdekoodista — ei subjektiivisilla ”agentin tyytyväisyys” -pisteillä.

- Kielikohtaiset fixture-sarjat: odotetut edget ja symbolit, jotka handlerin täytyy extraktoida oikein
- Testitapausten tarkkuusluokitus: GREEN edellyttää precision-arvoa ≥ 0.95, recall-arvoa ≥ 0.99, F1-arvoa ≥ 0.97 ja vähintään 20 odotettua kaarta sekä testitapausten kuratoinnin lisätarkistuksia. Tämä on tunnettuja testitapauksia koskeva sääntö, ei tilastollisen luottamuksen arvio eikä väite siitä, että jokaisen käytössä olevan kielen tila on GREEN.
- Language-audit-ulottuvuudet: tarkkuus, rakenteellinen eheys, kattavuus, laatu ja suorituskyky validointitaulussa
- Corpus- ja pistotarkastussilmukat: näytteistetyt edget oikeista repositoryistä, luokiteltuina rubriikin mukaan (oikein, false positive, tyyppi-/laajuus-/metadatavirhe) — kuvattu language-grind-blogijulkaisuissamme
- Tuotteen ominaisuusliput: mitä palvelin ilmoittaa tukevansa (AST, locals, graafipoiminta), erillään katalogin koosta

**Tärkeää:** Fixturet validoidaan itse kirjoittamiamme fixtureita vasten. VIHREÄ tarkoittaa, että tunnetut tapaukset menevät läpi. Se ei automaattisesti tarkoita, että jokainen todellisen maailman idiomi extraktoituu puhtaasti. Tämä ero on tarkoituksellinen ja julkinen.

## 3. Vihreä vs. riippumattomasti todennettu

Language-audit-taulu käyttää useita akseleita, joten yhtä vihreää valoa ei voi tulkita “todistetusti täydelliseksi.” Taulun pääluvut jaetaan yleensä näin:

- overall_green — regressiopuhdas self-snapshot-fixtureita ja niihin liittyviä corpus gateja vasten (tarpeellinen, mutta ei riittävä)
- independently_verified — sisältää vahvan arviointisignaalin, kuten pistotarkastussiemenen (mukana kielet, joissa on yhä arvioinnissa havaittuja virheitä)
- verified_clean / nolla arvioinnissa havaittua virhettä näytteistetyissä edgeissä — tiukempi osajoukko arvioiduista kielistä
- curation / oracle trust — kohdellaanko fixtureita itseään luotettuina oracleina
- structural flags — graafiextraktio ja AST-kyvykkyys eivät ole sama asia kuin katalogijäsenyys

Markkinoinnin kielimäärä (esimerkiksi “285+ kieltä”) on katalogin koko: konfiguroidut kielet ja palvelinmerkinnät. Katalogin koko ei ole AST-laadun SLA. Suosimme monitasoista raportointia yhden ylpeilyluvun sijaan. Nykyisen tuotepinnan osalta katso Yhteensopivuus ja Kielioppaat; kerronnallisia yksityiskohtia varten katso blogin kirjoitus kielten rekursiivisesta itseparannuksesta.

## 4. Haun ja retrievalin laatu

Semanttisen haun laatu on monimodaalinen: teksti, AST, graafi ja embeddingit yhdistetään. Dokumentoimme tietoisia insinöörikompromisseja sen sijaan, että väittäisimme retrievalia voittamattomaksi:

- Embeddingit käyttävät kaupallista malliperhettä (voyage-4-large kesäkuun 2026 blogitilannekuvan mukaan), valittu julkisten retrieval-ranking-listojen perusteella päätöshetkellä
- Vektorit on binäärikvantisoitu tallennusta ja kustannuksia varten; tämä vaihtaa tietoisesti hieman retrieval-tarkkuutta halvempaan ja nopeampaan Hamming-hakuun ilman erillistä vektoritietokantaa
- Aikeen mukainen reititys ja yhdistämisen painot ovat suunniteltuja heuristiikkoja. Joulukuun 2025 ehdotuksessa tuloksettomien hakujen lähtöosuudeksi arvioitiin noin 15 % ja tavoitteeksi asetettiin alle 5 %; emme ole toimittaneet kyselyjoukkoa tai mittausraporttia, joka osoittaisi tämän laskun. Näyttöaineisto korjaa aiemman väitteen saavutetusta parannuksesta.
- Blogijulkaisut sisältävät osiot “mikä on yhä epätäydellistä” — epätäydelliset signaalit ovat osa tallennetta, eivät piiloteltuja alaviitteitä

## 5. Kustannusväitteet

Maguyva-palvelun kustannuskieli kertoo hinnoittelurakenteesta ja toiminnan läpinäkyvyydestä, ei kolmannen osapuolen sertifioimasta virallisesta TCO-tutkimuksesta.

- Workspace-hinnoittelu: laskutus perustuu repositoryihin, indeksoituihin riveihin ja rebuild-tiheyteen — ei ihmis- tai agenttipaikkoihin. Usein kysytyt kysymykset ja tilaustasojen kuvaukset selittävät ulottuvuudet.
- Hintaesimerkki vertaa 25 maksullista käyttäjäpaikkaa havainnollistavalla $19–$59 paikkahinnalla Crew-tilaukseen, joka maksaa $49/kuukausi. Säästöt riippuvat tiimin koosta ja vaihtoehtoisesta tuotteesta; kyse ei ole vastaavien ominaisuuksien vertailusta eikä riippumattomasta kilpailuvertailusta.
- Toimintakustannusten rehellisyys: /team-sivu julkaisee todellisen kuukausittaisen ohjelmistokustannusten erittelyn (tilaukset, MCP-/hakutyökalut, käyttöpohjaiset kustannukset). Se on customer-zero-läpinäkyvyyttä, ei auditoitu tilinpäätös.
- Embedding- ja infrakustannukset ovat hyväksyttyjä tuotekustannuksia (premium-embeddingit, tallennustila, graafien rebuildit). Maksamme ne tarkoituksella ja kerromme siitä voyage-4-large-julkaisussa ja hinnoittelukertomuksessa.

## 6. Mitä emme väitä

Tämä sivu on myös lista ei-väitteistä. Jos jokin ei ole mittaustaululla, älä pidä markkinointisävyä todisteena.

- Ei yleistä absoluuttisen tarkkuuden takuuta jokaiselle kielelle. Testitapausten kynnysarvot koskevat kunkin kielen tunnettuja tapauksia; todellisessa koodissa on odotettavissa jäljelle jääviä virheitä, joita vähennetään jatkuvasti.
- Ei väitettä, että overall_green vastaisi tuotantotasoisen täydellistä extraktiota jokaiselle repository-idiomille
- Ei kolmannen osapuolen compliance-sertifiointipakettia, jota väitettäisiin menetelmäartefaktiksi tällä sivulla (katso Tietoturva tietojenkäsittelyn faktoja varten, ei compliance-merkkejä)
- Ei riippumatonta usean toimittajan bake-offia jaetuilla korpuksilla julkaistuna pysyvänä tuloskorttina
- Hakutulokset ja analyysit pysyvät best-effort-tasoisina käyttöehtojen mukaisesti — Maguyva ei korvaa koodikatselmointia, testausta tai tietoturva-auditointeja

## 7. Miten voit todentaa itse

Ostajan odotettu liike on yhä tämä: indeksoi repo, jonka jo ymmärrät, esitä yksi oikea kysymys ja tarkasta viittaukset.

- Aloita ilmaiseksi: pienet edustavat repot voittavat koko yrityksen indeksin ensimmäisenä päivänä
- Käytä MCP-työkaluja (intelligent_search, find_symbol, dependency_search) ja avaa viitatut polut
- Lue sisäänluku- ja hakuarkkitehtuurista sivulta Näin se toimii
- Lue ominaisuustasoista sivuilta Yhteensopivuus ja Kielioppaat, älä katso vain katalogin kokoa
- Lue tietojenkäsittelystä sivuilta Tietoturva ja Tietosuoja; tämä sivu ei korvaa niitä

- [Hakulaadun näyttöaineisto ja korjaukset (englanniksi)](https://maguyva.ai/evidence/search-quality.md)
- [Hakulaadun näyttöaineisto (JSON, englanniksi)](https://maguyva.ai/evidence/search-quality.json)
- [Miten se toimii](https://maguyva.ai/fi/docs/how-it-works)
- [Yhteensopivuus](https://maguyva.ai/fi/docs/compatibility)
- [Hinnat](https://maguyva.ai/fi/pricing)
- [Tiimi](https://maguyva.ai/fi/team)
- [Turvallisuus](https://maguyva.ai/fi/security)
- [Tietosuoja](https://maguyva.ai/fi/privacy)
- [Tila](https://maguyva.ai/fi/status)
- [Kielten rekursiivinen itseparannus: koodiälyn hiominen noin 280 kielessä](https://maguyva.ai/fi/blog/autonomous-quality-loops-language-grind)
- [Miksi päivitimme koodihaun malliin voyage-4-large](https://maguyva.ai/fi/blog/upgrading-code-search-to-voyage-4-large)

Kysymyksiä mittausalueesta tai väitteestä, joka vaikuttaa perusteettomalta: [support@maguyva.ai](mailto:support@maguyva.ai)