Mitä source tarkoittaa V2:ssa?
Kenttä source kertoo, mikä reitti tuotti lopullisen tuloksen: haku tallennetusta tietoaineistosta, tekoälyn ennuste tai ei valittua lähdettä. Se ei ole viittaus tietoaineiston alkuperäiseen julkaisijaan, ei lisenssitodistus eikä takuu siitä, että ennuste on oikea.
Tämä opas kuvaa V2:n nykyisen vastausmäärittelyn ja GenderAPI.io:n itse laatiman tietokantaprofiilin. Alla olevat havainnot ovat mitattuja inventaarioita ja johdonmukaisuustarkistuksia; tarkistettua luetteloa alkuperäisistä lähteistä ja riippumatonta tarkkuusmittausta ei ole vielä julkaistu.
| source | Mitä se kertoo | Mitä se ei osoita |
|---|---|---|
dataset | Tallennettu rivi valittiin; täsmälleen yhtä suurten määrien kohdalla sukupuoli voi silti olla tuntematon | Alkuperäistä julkaisijaa, keruutapaa, lisenssiä, rivin ikää tai sitä, ovatko havainnot riippumattomia |
ai | Lopullinen vastaus tuli määritetyltä tekoälyn ennustereitiltä; gender voi silti olla null | Laskettua otosta, viittausta tietoaineistoon tai ennusteen kalibroitua tarkkuutta |
none | Tallennettua riviä ei valittu lopulliseen lopputulokseen tilassa, jossa käytetään vain tietoaineistoa | Sitä, ettei syötteellä olisi mahdollista nimiyhteyttä missään perusjoukossa tai kielessä |
Tietokantaprofiili: 26. syyskuuta 2026
Kokoelmien metatiedot luettiin 2026-09-26T15:28:18.227Z, ja satunnaisotokset luettiin 2026-09-26T15:31:54.045Z. Molemmat määrät ovat peräisin kunkin kokoelman MongoDB collStats -metatiedoista eivätkä erillisestä täydestä laskennasta. Yleinen kokoelma sisältää tallennettuja nimirivejä ja maakohtainen kokoelma tallennettuja nimen ja maan rivejä. Määriä ei saa laskea yhteen yksilöllisten nimien tai yksilöllisten henkilöiden kokonaismääräksi.
Kustakin kokoelmasta MongoDB poimi satunnaisesti 5 000 dokumenttia ja laski alla olevat kootut tarkistukset tietokantapalvelimella. Julkinen raportti ei sisällä nimiä eikä raakatietueita. Nämä ovat GenderAPI.io:n omia havaintoja tuotannossa olevasta tietokannasta, eivät riippumaton tarkastus eivätkä jäädytetty arviointiaineisto. Tarkistukset koskevat määrien johdonmukaisuutta eivätkä ennusteiden tarkkuutta, yksilöllisten henkilöiden tai nimien määrää tai API:n kattavuutta.
| Havainto | Yleiset rivit | Maakohtaiset rivit |
|---|---|---|
| Kokoelma | general | country-specific |
| Dokumenttien määrä metatietojen mukaan | 2 483 220 | 4 080 692 |
| Tallennettu yksilöllinen avain | name | name + country |
| Satunnaisesti poimitut dokumentit | 5 000 | 5 000 |
| Numeeristen sääntöjen rikkomukset otoksessa | 0 | 0 |
| male + female poikkeaa arvosta total otoksessa | 0 | 0 |
| Yhtä suuret male- ja female-määrät otoksessa | 124 | 94 |
| Kenttä updated_at esiintyy otoksessa | 667 / 5 000 | 741 / 5 000 |
Mitä tietokannan tarkistukset osoittavat
Numeerinen tarkistus edellyttää, että total on positiivinen turvallinen kokonaisluku ja että male- ja female-määrät ovat äärellisiä ja välillä 0–total. Erillinen tarkistus vertaa summaa male + female arvoon total. Kaikki otosten laskurit läpäisivät nämä tarkistukset; se ei ole väite siitä, että jokainen kokoelmien rivi olisi johdonmukainen tai että jokin ennuste olisi oikea.
Yhtä suuret male- ja female-määrät esiintyivät 124 rivissä yleisen kokoelman otoksessa ja 94 rivissä maakohtaisen kokoelman otoksessa. Kyse on tallennettujen määrien tasatilanteista, ei riippumattomasti vahvistetuista monitulkintaisista identiteeteistä eikä API:n tuntemattomien tulosten osuudesta. API:n todelliset tulokset riippuvat syötteistä, Redisin saatavuudesta, ehdokkaiden valinnasta ja tekoälyasetuksista.
Yleisen kokoelman country-kentän erillinen inventaario, joka tehtiin 2026-09-26T15:33:13.811Z, löysi 244 erilaista tallennettua arvoa: 239 oli kahden ison kirjaimen muodossa ja 5 ei ollut. Arvojen kelpoisuutta ISO-koodeina, maakohtaisten rivien jakaumaa ja tuettujen maiden kattavuutta ei mitattu. Nämä luvut eivät ole tuettujen maiden määrä.
Kummassakaan otoksessa ei ollut lähde- tai lisenssikenttiä. Se ei osoita, että alkuperätiedot puuttuisivat jokaisesta rivistä tai ulkoisista järjestelmistä. updated_at esiintyi numeerisena kenttänä joissakin riveissä, mutta sen arvoja ja merkitystä ei tutkittu; se ei osoita tietojen ajantasaisuutta eikä päivitysaikataulua.
V2 tekee tietoaineiston haut Redisin kautta. GenderAPI.io vahvisti järjestelmän ylläpitäjänä 26. syyskuuta 2026, että MongoDB ja Redis sisältävät saman tietoaineiston. Yhtäläisyys perustuu tähän vahvistukseen: tietokantoja ei ole verrattu riippumattomasti, ja tällainen tarkistus on vielä tekemättä. Yllä oleva inventaario kuvaa tallennettuja rivejä; API:n vastauskattavuus riippuu myös lähetetyistä syötteistä, ehdokkaiden osumista ja tekoälyasetuksista. Otokset poimittiin ilman kiinteää siemenarvoa, luettiin ilman jäädytettyä tilannevedosta, eikä niillä ollut riippumattomia viiteluokituksia; niillä ei voi mitata ennusteiden tarkkuutta, kalibrointia eikä vastauskattavuutta.
Seuraa vastauksen perusteita
| Kenttä | Merkitys | Rajoitus |
|---|---|---|
input | Toistaa lähetetyn syötetyypin, arvon ja maakontekstin | Syötearvo ei ole riippumattomasti vahvistettu tieto henkilöllisyydestä |
match.name / match.method | Näyttää valitun ehdokkaan ja sen, normalisoitiinko se, jaettiinko se nimen osiin, poimittiinko se merkkijonon osana vai päättelikö sen malli | Osuma nimen osaan ei takaa, että todellinen etunimi erotettiin koko nimestä tai käyttäjänimestä |
match.scope / match.country | Näyttää, tuliko valittu tallennettu rivi maakohtaisesta vai globaalista hausta | Annettu maa ei takaa, että maakohtainen rivi oli saatavilla |
sample_count | Valittuun riviin tallennettu kokonaismäärä; tekoälyn ennusteessa null | Ei välttämättä yksilöllisiä henkilöitä, riippumattomasti kerättyjä havaintoja eikä tarkkuusarvioinnin kokoa |
confidence / confidence_kind | Erottaa tallennetuista määristä lasketun suhdeluvun mallin ilmoittamasta arvosta | Kumpikaan arvo ei ole vahvistettu todennäköisyys henkilön sukupuoli-identiteetistä |
country / country_source | Palautetun rivin maametatiedot tai tekoälyn antama nimen ja maan välinen yhteys, jos sellainen on | Ei kansalaisuus, asuinpaikka tai vahvistettu alkuperä, eikä todiste siitä, että pyynnön maa tuotti osuman |
Miten syötteen osumat vaikuttavat tulokseen
Tietoaineiston haku normalisoi tekstin ja muodostaa siitä nimen osista koostuvia ehdokkaita. Sähköpostiosoitteissa ehdokkaat muodostetaan paikallisesta osasta; käyttäjänimistä poistetaan valinnainen alussa oleva @. Tavalliset sähköpostiosoitteiden ja käyttäjänimien haut voivat kokeilla ehdokkaina myös rajattua määrää merkkijonon osia. Jos useita ehdokasrivejä on saatavilla, valituksi tulee rivi, jonka tallennettu kokonaismäärä on suurin. Se voi olla jokin muu nimen osa kuin tarkoitettu etunimi.
Kun maakonteksti on annettu, haku kokeilee kunkin ehdokkaan maakohtaista riviä ja käyttää globaalia riviä, jos maakohtaista riviä ei ole. Lopullinen tulos näyttää valitun osuman. Monitulkintaista maakohtaista riviä ei korvata automaattisesti saman ehdokkaan globaalilla rivillä.
Tekoälyn tavallinen kehote pyytää tunnistettavaa etunimeä. forceToGenderize sallii lisäksi henkilökohtaisiin lempinimiin tai aliaksiin perustuvat yhteydet, joten muu kuin null-arvoinen sukupuoli yhdessä arvon name: null kanssa on tässä tilassa kelvollinen. Nämä ovat eri ennustetehtäviä, jotka on arvioitava erikseen.
Tietoaineiston haku ja käsittely tekoälyllä
Kun tekoälyä käytetään, V2 lähettää lähetetyt type, value ja maakontekstin tekoälyn ennusteisiin määritetylle palvelulle. Sähköpostiosoitteiden kohdalla kehote pyytää mallia jättämään huomiotta verkkotunnuksen ja plus-merkin jälkeisen päätteen; se ei ole lupaus siitä, että nämä merkit poistetaan arvosta ennen tekoälyn käsittelyä. Käytä asetusta ai_mode: off ilman forceToGenderize-asetusta, kun työnkulkusi edellyttää ennusteita pelkästä tietoaineistosta.
Tekoälyvastauksen validointi tarkistaa JSON-kentät, tyypit ja kenttien välisen johdonmukaisuuden. Se ei todista, että palautettu nimi, sukupuoliyhteys tai maayhteys on tosiasiallisesti oikea. Julkinen tulos ei sisällä mallin tunnistetta, mallin versiota eikä lähdettä ennusteelle.
| Asetus | Ennustereitti | Palautetut perusteet |
|---|---|---|
| ai_mode: off | Käyttää vain tietoaineiston hakua | Valitun tietoaineiston rivin metatiedot tai tuntematon tulos ilman valittua riviä |
| ai_mode: fallback | Kokeilee ensin tietoaineistoa; käyttää tekoälyä, jos sukupuolta ei palaudu | Lopullisen reitin perusteet, ei yhdistettyä otosta tietoaineistosta ja tekoälystä |
| ai_mode: always | Käyttää määritettyä tekoälyn ennustereittiä suoraan | Mallin ilmoittama arvo tai tuntematon tulos, jossa confidence on null; sample_count on aina null |
| forceToGenderize: true | Kokeilee tietoaineistoa ja sen jälkeen lempinimiä tulkitsevaa tekoälyä, jos tulosta ei ratkaistu | Perusteet tietoaineistosta tai mallin ilmoittama aliakseen perustuva yhteys; name voi olla null |
Lähdedokumentaatio, jota ei ole vielä julkaistu
Tarkistettua lähdeluetteloa ei ole julkaistu tässä. Vastausmäärittely ja toteutuksen toiminta eivät yksinään voi vahvistaa tietojen alkuperää, oikeutta lähteen käyttöön, lähteen edustavuutta tai luokitusten laatua. Ennen kuin tiettyjä lähteitä koskevia väitteitä esitetään, seuraavat perusteet on dokumentoitava ja tarkistettava.
Tämä dokumentaation tarkistus ei osoita, ovatko alkuperäiset lähteet lisensoituja vai lisensoimattomia tai täydellisiä vai puutteellisia. Se kuvaa julkisten perusteiden rajoitukset. Ota yhteyttä GenderAPI.io:hon, jos käyttötarkoituksesi edellyttää tietyn lähteen arviointia.
| Peruste | Vaadittu dokumentaatio | Julkinen tila |
|---|---|---|
| Alkuperä ja käyttöoikeus | Nimetty lähde tai julkaisija, keruujakso, lisenssi tai muu dokumentoitu käytön peruste | Tarkistettua luetteloa ei ole julkaistu tässä |
| Käsittelyhistoria | Muunnokset, normalisointi, kaksoiskappaleiden poisto, yhdistäminen sekä mahdolliset synteettiset tai mallin tuottamat osuudet | Tunniste source: dataset ei näytä tätä |
| Perusjoukon kattavuus | Maiden ja kirjoitusjärjestelmien kattavuus, valintaprosessi, luokitusten määritelmät ja dokumentoitu vinouma | Riippumattomasti arvioituja kattavuuslukuja ei ole julkaistu tässä |
| Ajantasaisuus | Tilannevedosten tunnisteet, lähdekohtaiset päivityspäivät ja vahvistettu päivitysaikataulu | V2-vastaus ei sisällä rivikohtaisia ajantasaisuustietoja eikä tilannevedoksen tunnistetta |
| Laatu ja korjaaminen | Validointitulokset, päällekkäisyystarkistukset, korjausten ja poistojen käsittely sekä vastuu tarkistuksesta | Lähdekohtaisia tarkastustuloksia ei ole julkaistu tässä |
Tietosuoja, käsittely ja vastuullinen käyttö
Lähteiden alkuperä, henkilötietojen käsittely ja oikeudelliset ehdot ovat eri kysymyksiä. Tarkista käsittelyn roolit, säilytysajat, palveluntarjoajat ja sopimusehdot voimassa olevista julkaistuista käytännöistä. Tämä tekninen opas ei anna uusia säilytyslupauksia eikä vahvista lakisääteisten vaatimusten täyttymistä.
Lähetä vain ne tiedot, joita työnkulkusi tarvitsee. Säilytä luottamusarvon tyypit ja tuntemattomat tulokset, äläkä kuvaa ennustetta henkilön itse ilmoittamaksi identiteetiksi. Älä käytä pääteltyä sukupuolta perusteena yksilöä koskeville merkittäville päätöksille.
Tarkkuuden perusteet ja muutoshistoria
Lähdetunniste selittää ennustereitin, ei sen mitattua laatua. Käytä tarkkuusopasta erottaaksesi vastauksen arvot, vastauskattavuuden, virheet ja toistettavaan arviointiin tarvittavat tiedot.
| Päivämäärä | Dokumentin versio | Muutos |
|---|---|---|
| 2026-09-30 | 1.0.0 | Suomenkielinen versio MongoDB:n päivätystä inventaariosta, otosten rajatuista johdonmukaisuustarkistuksista, V2:n source- ja match-kentistä, tekoälykäsittelyn rajoista ja lähdeluettelon jäljellä olevista puutteista. MongoDB:n ja Redisin yhtäläisyys perustuu GenderAPI.io:n vahvistukseen 26. syyskuuta 2026; riippumaton vertailu on vielä tekemättä. Tarkkuusprosenttia tai lähteiden lisenssejä koskevaa väitettä ei esitetä. |