Co oznacza source w V2?
Pole source wskazuje ścieżkę, która dała ostateczny wynik: wyszukiwanie w zapisanym zbiorze danych, inferencję AI albo brak wybranego źródła. Nie jest to odwołanie do pierwotnego wydawcy zbioru danych, certyfikat licencji ani gwarancja, że inferencja jest poprawna.
Ten przewodnik opisuje obecny kontrakt odpowiedzi V2 i profil bazy danych sporządzony przez GenderAPI.io. Poniższe obserwacje to pomiary inwentaryzacyjne i kontrole spójności; nie opublikowano jeszcze zweryfikowanego katalogu pierwotnych źródeł ani niezależnej oceny dokładności.
| source | Co oznacza | Czego nie dowodzi |
|---|---|---|
dataset | Wybrano zapisany rekord; przy dokładnie równych liczbach wystąpień płeć nadal może być nieznana | Pierwotnego wydawcy, metody zbierania danych, licencji, wieku rekordu ani niezależności obserwacji |
ai | Ostateczna odpowiedź pochodzi ze skonfigurowanej ścieżki inferencji AI; gender nadal może mieć wartość null | Policzonej próby, odwołania do zbioru danych ani skalibrowanej dokładności prognoz |
none | W trybie tylko ze zbiorem danych nie wybrano zapisanego rekordu dla ostatecznego wyniku | Tego, że dane wejściowe nie mają żadnego możliwego powiązania z imieniem w żadnej populacji ani w żadnym języku |
Profil bazy danych: 26 września 2026 r.
Metadane kolekcji odczytano 2026-09-26T15:28:18.227Z, a losowe próbki 2026-09-26T15:31:54.045Z. Obie liczby dokumentów pochodzą osobno z metadanych MongoDB collStats każdej kolekcji, a nie z niezależnego pełnego zliczenia. Kolekcja ogólna zawiera rekordy imion, a kolekcja krajowa pary imię–kraj. Nie sumuj tych liczb, aby uzyskać łączną liczbę unikalnych imion lub unikalnych osób.
Dla każdej kolekcji MongoDB losowo wybrało 5000 dokumentów i po stronie serwera obliczyło poniższe kontrole zbiorcze. Publiczny raport nie zawiera żadnych imion ani surowych rekordów. Są to obserwacje GenderAPI.io dotyczące działającej bazy danych, a nie niezależny audyt ani zamrożony zbiór do oceny. Kontrole dotyczą spójności liczników, a nie dokładności prognoz, liczby osób lub unikalnych imion ani pokrycia API.
| Obserwacja | Rekordy ogólne | Rekordy krajowe |
|---|---|---|
| Kolekcja | general | country-specific |
| Liczba dokumentów według metadanych | 2 483 220 | 4 080 692 |
| Zapisany unikalny klucz | name | name + country |
| Losowo wybrane dokumenty | 5000 | 5000 |
| Niepowodzenia kontroli liczbowej w próbie | 0 | 0 |
| male + female różne od total w próbie | 0 | 0 |
| Równe liczby male i female w próbie | 124 | 94 |
| Pole updated_at obecne w próbie | 667 / 5000 | 741 / 5000 |
Co wykazują kontrole bazy danych
Kontrola liczbowa wymaga, aby total był dodatnią bezpieczną liczbą całkowitą, a liczby male i female były skończone i mieściły się w przedziale od zera do total. Osobna kontrola porównuje male + female z total. Wszystkie liczniki w próbach przeszły te kontrole; nie oznacza to, że każdy rekord w kolekcjach jest spójny ani że jakakolwiek prognoza jest poprawna.
Równe liczby male i female wystąpiły w 124 rekordach z próby kolekcji ogólnej i w 94 rekordach z próby kolekcji krajowej. Są to remisy w zapisanych liczbach wystąpień, a nie niezależnie zweryfikowane niejednoznaczne tożsamości ani odsetek wyników unknown w API. Rzeczywiste wyniki API zależą od danych wejściowych, dostępności Redis, wyboru kandydatów i ustawień AI.
Osobna inwentaryzacja pola country w kolekcji ogólnej, przeprowadzona 2026-09-26T15:33:13.811Z, wykazała różne zapisane wartości w liczbie 244: w formacie dwóch wielkich liter – 239, w innym formacie – 5. Nie mierzono zgodności z normą ISO, rozkładu rekordów według krajów ani pokrycia obsługiwanych krajów. Te liczby nie są liczbą obsługiwanych krajów.
W obu próbach nie pojawiły się żadne pola źródła ani licencji. Nie dowodzi to, że informacji o pochodzeniu danych brakuje w każdym rekordzie lub w systemach zewnętrznych: obecność lub brak pola nie jest dowodem licencji źródeł. Pole updated_at występowało w niektórych rekordach jako wartość liczbowa, ale jego wartości i znaczenia nie sprawdzano; nie świadczy ono o aktualności danych ani o harmonogramie aktualizacji.
V2 obsługuje wyszukiwania w zbiorze danych z Redis. 26 września 2026 r. GenderAPI.io jako właściciel systemu potwierdziło, że MongoDB i Redis zawierają ten sam zbiór danych. Ta równoważność opiera się na tym potwierdzeniu: nie przeprowadzono niezależnego porównania obu baz, a taka weryfikacja wciąż oczekuje na wykonanie. Powyższa inwentaryzacja opisuje zapisane rekordy; pokrycie odpowiedzi API zależy także od przesłanych danych wejściowych, dopasowania kandydatów i ustawień AI. Próbki losowano bez stałego ziarna, odczytano bez zamrożonej migawki i bez niezależnych etykiet referencyjnych; nie pozwalają zmierzyć dokładności prognoz, kalibracji ani pokrycia odpowiedzi.
Śledź informacje zawarte w odpowiedzi
| Pole | Znaczenie | Ograniczenie |
|---|---|---|
input | Powtarza przesłany typ, wartość i kontekst kraju | Wartość wejściowa nie jest niezależnie zweryfikowaną informacją o tożsamości |
match.name / match.method | Pokazuje wybranego kandydata i to, czy został znormalizowany, wyodrębniony jako składnik lub fragment, czy wywnioskowany przez model | Dopasowanie składnika nie gwarantuje, że z imienia i nazwiska lub identyfikatora wyodrębniono prawdziwe imię |
match.scope / match.country | Pokazuje, czy wybrany rekord pochodzi z wyszukiwania dla danego kraju, czy z wyszukiwania globalnego | Podanie kraju nie gwarantuje, że był dostępny rekord dla tego kraju |
sample_count | Łączna liczba zapisana w wybranym rekordzie; null przy inferencji AI | Nie musi oznaczać unikalnych osób, niezależnie pobranych obserwacji ani wielkości próby w ocenie dokładności |
confidence / confidence_kind | Odróżnia współczynnik obliczony z zapisanych liczb wystąpień od wyniku podanego przez model | Żadna z tych wartości nie jest zweryfikowanym prawdopodobieństwem tożsamości płciowej danej osoby |
country / country_source | Metadane kraju zwróconego rekordu lub powiązanie imienia z krajem podane przez AI, jeśli są dostępne | Nie oznacza narodowości, miejsca zamieszkania ani zweryfikowanego pochodzenia i nie dowodzi, że przesłany kraj został dopasowany |
Jak dopasowanie danych wejściowych wpływa na wynik
Wyszukiwanie w zbiorze danych normalizuje tekst i wyprowadza z niego kandydatów. W przypadku adresów e-mail kandydaci pochodzą z części przed @; w przypadku nazw użytkowników usuwany jest opcjonalny początkowy znak @. Standardowe wyszukiwania adresów e-mail i nazw użytkowników mogą też sprawdzać fragmenty o ograniczonej długości. Jeśli dostępnych jest kilka rekordów kandydatów, wybierany jest ten o największej zapisanej łącznej liczbie wystąpień, co może oznaczać wybór innego składnika niż zamierzone imię.
Gdy podano kontekst kraju, wyszukiwanie dla każdego kandydata sprawdza rekord dla danego kraju, a jeśli go nie ma, rekord globalny. Ostateczny wynik podaje wybrane dopasowanie. Niejednoznaczny rekord dla danego kraju nie jest automatycznie zastępowany rekordem globalnym dla tego kandydata.
Standardowy prompt AI szuka rozpoznawalnego imienia. forceToGenderize pozwala też na powiązania oparte na osobistych pseudonimach lub aliasach: w tym trybie płeć różna od null razem z name: null jest prawidłowym wynikiem. To różne zadania inferencji, które trzeba oceniać osobno.
Wyszukiwanie w zbiorze danych i przetwarzanie przez AI
Gdy używana jest AI, V2 przekazuje przesłane type, value i kontekst kraju do skonfigurowanej usługi inferencji AI. W przypadku adresów e-mail prompt instruuje model, aby zignorował domenę i przyrostek po znaku +; nie gwarantuje to, że te znaki zostaną usunięte z wartości przed przetworzeniem przez AI. Jeśli Twój proces wymaga prognozy wyłącznie ze zbioru danych, użyj ai_mode: off bez forceToGenderize.
Walidacja odpowiedzi AI sprawdza pola JSON, ich typy i wzajemną spójność. Nie dowodzi, że zwrócone imię, powiązanie z płcią lub powiązanie z krajem są zgodne z rzeczywistością. Publiczny wynik nie zawiera identyfikatora ani wersji modelu, ani żadnego źródła uzasadniającego jego inferencję.
| Opcja | Ścieżka inferencji | Zwracane informacje |
|---|---|---|
| ai_mode: off | Tylko wyszukiwanie w zbiorze danych | Metadane wybranego rekordu albo wynik unknown bez wybranego rekordu |
| ai_mode: fallback | Najpierw sprawdza zbiór danych; korzysta z AI, jeśli nie zwrócono płci | Informacje z ostatecznej ścieżki, a nie łączna próba ze zbioru danych i AI |
| ai_mode: always | Od razu korzysta ze skonfigurowanej ścieżki inferencji AI | Wynik podany przez model albo wynik unknown z pewnością null; sample_count zawsze ma wartość null |
| forceToGenderize: true | Sprawdza zbiór danych, a jeśli wynik jest nierozstrzygnięty, korzysta z AI uwzględniającej pseudonimy | Informacje ze zbioru danych albo podane przez model powiązanie pseudonimu; name może mieć wartość null |
Dokumentacja źródeł, która nie została jeszcze opublikowana
Nie opublikowano tu zweryfikowanego katalogu źródeł. Sam kontrakt odpowiedzi i zachowanie implementacji nie wystarczą, aby zweryfikować pochodzenie danych, prawo do korzystania ze źródła, jego reprezentatywność ani jakość jego etykiet. Zanim pojawią się twierdzenia dotyczące konkretnych źródeł, trzeba udokumentować i zweryfikować poniższe informacje.
Ten przegląd dokumentacji nie ustala, czy pierwotne źródła są licencjonowane, czy nie, ani czy są kompletne, czy niekompletne. Przedstawia ograniczenia publicznie dostępnych dowodów. Skontaktuj się z GenderAPI.io, jeśli Twoje zastosowanie wymaga oceny konkretnego źródła.
| Dowód | Wymagany dokument | Status publiczny |
|---|---|---|
| Pochodzenie i prawo do korzystania | Wskazane źródło lub wydawca, okres zbierania danych, licencja lub inna udokumentowana podstawa korzystania | Nie opublikowano tu zweryfikowanego katalogu |
| Historia przetwarzania | Przekształcenia, normalizacja, usuwanie duplikatów, agregacja oraz wszelki wkład syntetyczny lub wygenerowany przez model | Nie wynika z etykiety source: dataset |
| Pokrycie populacji | Pokrycie krajów i systemów pisma, proces doboru, definicje etykiet i udokumentowane obciążenia | Nie opublikowano tu niezależnie ocenionych danych o pokryciu |
| Aktualność | Identyfikatory migawek, daty aktualizacji poszczególnych źródeł i obsługiwany harmonogram aktualizacji | Odpowiedź V2 nie zawiera informacji o aktualności poszczególnych rekordów ani identyfikatora migawki |
| Jakość i poprawki | Wyniki walidacji, kontrole nakładania się danych, obsługa poprawek i usunięć oraz odpowiedzialność za przegląd | Nie opublikowano tu wyników audytu poszczególnych źródeł |
Prywatność, przetwarzanie i odpowiedzialne korzystanie
Pochodzenie źródeł, przetwarzanie danych osobowych i warunki prawne to odrębne kwestie. Role w przetwarzaniu, okresy przechowywania, dostawców i warunki umowne opisują aktualne opublikowane zasady. Ten przewodnik techniczny nie wprowadza nowych zobowiązań dotyczących przechowywania danych i nie poświadcza zgodności z prawem.
Wysyłaj tylko informacje potrzebne w Twoim procesie. Zachowuj rodzaje pewności i wyniki unknown i nie przedstawiaj inferencji jako tożsamości zadeklarowanej przez daną osobę. Nie opieraj na wywnioskowanej płci decyzji, które mają istotne skutki dla danej osoby.
Dowody dotyczące dokładności i historia zmian
Etykieta źródła wyjaśnia ścieżkę inferencji, a nie jej zmierzoną jakość. Z przewodnika po dokładności dowiesz się, jak odróżnić wyniki w odpowiedziach, pokrycie odpowiedzi, błędy i informacje potrzebne do powtarzalnej oceny.
| Data | Wersja dokumentu | Zmiana |
|---|---|---|
| 2026-09-28 | 1.0.0 | Polska adaptacja datowanej inwentaryzacji MongoDB, kontroli spójności na próbach, pól V2 source i match, ograniczeń przetwarzania przez AI i pozostałych luk w katalogu źródeł. Równoważność MongoDB–Redis opiera się na potwierdzeniu GenderAPI.io z 26 września 2026 r.; niezależne porównanie wciąż oczekuje na wykonanie. Nie dodano żadnego procentu dokładności ani twierdzenia o licencji źródeł. |