Τι σημαίνει το source στο V2;
Το πεδίο source δείχνει ποια διαδρομή παρήγαγε το τελικό αποτέλεσμα: την αναζήτηση στο αποθηκευμένο σύνολο δεδομένων, ένα συμπέρασμα του AI ή καμία επιλεγμένη πηγή. Δεν είναι αναφορά στον αρχικό εκδότη μιας εγγραφής, ούτε απόδειξη άδειας χρήσης, ούτε εγγύηση ότι το συμπέρασμα είναι σωστό.
Αυτός ο οδηγός περιγράφει την τρέχουσα σύμβαση απόκρισης του V2 και ένα προφίλ της βάσης δεδομένων που κατάρτισε το GenderAPI.io. Οι παρατηρήσεις που ακολουθούν είναι μετρήσεις απογραφής και έλεγχοι συνέπειας. Ένας επαληθευμένος κατάλογος των αρχικών πηγών και μια ανεξάρτητη αξιολόγηση της ακρίβειας δεν έχουν δημοσιευθεί ακόμη.
| source | Σημασία | Τι δεν δείχνει |
|---|---|---|
dataset | Επιλέχθηκε μια αποθηκευμένη εγγραφή. Με ακριβώς ίσες συχνότητες το φύλο μπορεί παρ' όλα αυτά να είναι άγνωστο | Αρχικό εκδότη, μέθοδο συλλογής, άδεια χρήσης, ηλικία της εγγραφής ή ανεξαρτησία των παρατηρήσεων |
ai | Η τελική απάντηση προέρχεται από τη ρυθμισμένη διαδρομή συμπερασμού του AI. Το gender μπορεί παρ' όλα αυτά να είναι null | Ένα μετρημένο δείγμα, μια αναφορά στο σύνολο δεδομένων ή μια βαθμονομημένη ακρίβεια της πρόβλεψης |
none | Στη λειτουργία μόνο με το σύνολο δεδομένων δεν επιλέχθηκε καμία αποθηκευμένη εγγραφή για το τελικό αποτέλεσμα | Ότι η είσοδος δεν έχει πιθανή συσχέτιση ονόματος σε όλους τους πληθυσμούς και σε όλες τις γλώσσες |
Προφίλ της βάσης δεδομένων: 26 Σεπτεμβρίου 2026
Τα μεταδεδομένα των συλλογών διαβάστηκαν στις 2026-09-26T15:28:18.227Z και τα τυχαία δείγματα λήφθηκαν στις 2026-09-26T15:31:54.045Z. Τα δύο πλήθη εγγράφων προέρχονται το καθένα χωριστά από τα μεταδεδομένα collStats του MongoDB για την αντίστοιχη συλλογή και όχι από μια ανεξάρτητη πλήρη καταμέτρηση. Η γενική συλλογή περιέχει εγγραφές ονομάτων και η συλλογή ανά χώρα ζεύγη ονόματος και χώρας. Μην προσθέτετε τους δύο αριθμούς για να βρείτε ένα σύνολο μοναδικών ονομάτων ή μοναδικών ατόμων.
Για κάθε συλλογή, το MongoDB επέλεξε τυχαία 5.000 έγγραφα και υπολόγισε στον διακομιστή τους συγκεντρωτικούς ελέγχους που αναφέρονται παρακάτω. Η δημόσια αναφορά δεν περιέχει ονόματα ούτε ακατέργαστα δεδομένα. Πρόκειται για παρατηρήσεις του GenderAPI.io στη βάση δεδομένων παραγωγής και όχι για ανεξάρτητο έλεγχο ούτε για παγωμένο σύνολο δεδομένων αξιολόγησης. Οι έλεγχοι αφορούν τη συνέπεια των μετρητών και όχι την ακρίβεια των προβλέψεων, τον αριθμό μοναδικών ατόμων ή ονομάτων ή την κάλυψη του API.
| Παρατήρηση | Γενικές εγγραφές | Εγγραφές ανά χώρα |
|---|---|---|
| Συλλογή | general | country-specific |
| Αριθμός εγγράφων σύμφωνα με τα μεταδεδομένα | 2.483.220 | 4.080.692 |
| Αποθηκευμένο μοναδικό κλειδί | name | name + country |
| Τυχαία επιλεγμένα έγγραφα | 5.000 | 5.000 |
| Αριθμητικοί έλεγχοι που απέτυχαν στο δείγμα | 0 | 0 |
| male + female διαφορετικό από total στο δείγμα | 0 | 0 |
| Ίσες συχνότητες για male και female στο δείγμα | 124 | 94 |
| Πεδίο updated_at παρόν στο δείγμα | 667 / 5.000 | 741 / 5.000 |
Τι δείχνουν οι έλεγχοι της βάσης δεδομένων
Ο αριθμητικός έλεγχος απαιτεί το total να είναι θετικός ασφαλής ακέραιος και οι συχνότητες male και female να είναι πεπερασμένες και να βρίσκονται μεταξύ μηδέν και total. Ένας χωριστός έλεγχος συγκρίνει το male + female με το total. Όλοι οι μετρητές των δειγμάτων πέρασαν τους ελέγχους. Αυτό δεν σημαίνει ότι κάθε εγγραφή των συλλογών είναι συνεπής ούτε ότι μια πρόβλεψη είναι σωστή.
Ίσες συχνότητες για male και female εντοπίστηκαν σε 124 εγγραφές του δείγματος της γενικής συλλογής και σε 94 εγγραφές του δείγματος της συλλογής ανά χώρα. Πρόκειται για ίσες αποθηκευμένες συχνότητες και όχι για αμφίσημες ταυτότητες επαληθευμένες ανεξάρτητα ούτε για το μερίδιο άγνωστων αποτελεσμάτων του API. Τα πραγματικά αποτελέσματα του API εξαρτώνται από την είσοδο, τη διαθεσιμότητα του Redis, την επιλογή των υποψηφίων και τις ρυθμίσεις του AI.
Μια χωριστή απογραφή του πεδίου country στη γενική συλλογή, που έγινε στις 2026-09-26T15:33:13.811Z, εντόπισε 244 διακριτές αποθηκευμένες τιμές: 239 σε μορφή δύο κεφαλαίων γραμμάτων και 5 σε άλλη μορφή. Η συμμόρφωση με το ISO, η κατανομή των εγγραφών ανά χώρα και η κάλυψη των υποστηριζόμενων χωρών δεν μετρήθηκαν. Αυτοί οι αριθμοί δεν είναι ο αριθμός των υποστηριζόμενων χωρών.
Σε κανένα από τα δείγματα δεν εντοπίστηκαν πεδία σχετικά με την πηγή ή την άδεια χρήσης. Αυτό δεν αποδεικνύει ότι οι πληροφορίες προέλευσης λείπουν από κάθε εγγραφή ή από εξωτερικά συστήματα: η παρουσία ή η απουσία ενός πεδίου δεν αποδεικνύει την άδεια χρήσης μιας πηγής. Το πεδίο updated_at υπήρχε σε ορισμένες εγγραφές ως αριθμητική τιμή, αλλά οι τιμές και η σημασία του δεν επαληθεύτηκαν. Δεν δείχνει ούτε την επικαιρότητα των δεδομένων ούτε πρόγραμμα ενημέρωσης.
Το V2 εκτελεί τις αναζητήσεις στο σύνολο δεδομένων μέσω του Redis. Στις 26 Σεπτεμβρίου 2026 το GenderAPI.io, ως υπεύθυνος του συστήματος, επιβεβαίωσε ότι το MongoDB και το Redis περιέχουν το ίδιο σύνολο δεδομένων. Η ισοδυναμία βασίζεται σε αυτή την επιβεβαίωση: δεν έγινε καμία ανεξάρτητη σύγκριση ανάμεσα στις δύο βάσεις δεδομένων και αυτός ο έλεγχος εκκρεμεί ακόμη. Η παραπάνω απογραφή περιγράφει τις αποθηκευμένες εγγραφές. Η κάλυψη των απαντήσεων του API εξαρτάται επιπλέον από τις εισόδους που στέλνονται, την αντιστοίχιση των υποψηφίων και τις ρυθμίσεις του AI. Τα δείγματα λήφθηκαν χωρίς σταθερό seed, διαβάστηκαν χωρίς παγωμένο στιγμιότυπο και επεξεργάστηκαν χωρίς ανεξάρτητες ετικέτες αναφοράς. Δεν επιτρέπουν τη μέτρηση της ακρίβειας των προβλέψεων, της βαθμονόμησης ή της κάλυψης των απαντήσεων.
Ανίχνευση των πληροφοριών στην απόκριση
| Πεδίο | Σημασία | Περιορισμός |
|---|---|---|
input | Επαναλαμβάνει τον τύπο, την τιμή και το πλαίσιο χώρας που στάλθηκαν | Μια τιμή εισόδου δεν είναι στοιχείο ταυτότητας επαληθευμένο ανεξάρτητα |
match.name / match.method | Δείχνει τον υποψήφιο που επιλέχθηκε και αν κανονικοποιήθηκε, εξήχθη ως μέρος ή υποσυμβολοσειρά ή συνάχθηκε από το μοντέλο | Μια αντιστοίχιση σε ένα μέρος δεν εγγυάται ότι εξήχθη πραγματικό μικρό όνομα από το πλήρες όνομα ή το αναγνωριστικό |
match.scope / match.country | Δείχνει αν η εγγραφή που επιλέχθηκε προέρχεται από την αναζήτηση ανά χώρα ή από τη γενική αναζήτηση | Η αναφορά μιας χώρας δεν εγγυάται ότι υπήρχε διαθέσιμη εγγραφή για αυτή τη χώρα |
sample_count | Το αποθηκευμένο συνολικό πλήθος στην εγγραφή που επιλέχθηκε, null στον συμπερασμό του AI | Δεν δείχνει απαραίτητα μοναδικά άτομα, παρατηρήσεις που συλλέχθηκαν ανεξάρτητα ή το μέγεθος του δείγματος μιας αξιολόγησης της ακρίβειας |
confidence / confidence_kind | Διακρίνει έναν λόγο που υπολογίζεται από αποθηκευμένες συχνότητες από μια τιμή που αναφέρει το μοντέλο | Καμία από τις δύο τιμές δεν είναι επαληθευμένη πιθανότητα για την ταυτότητα φύλου ενός ατόμου |
country / country_source | Μεταδεδομένα χώρας της εγγραφής που επιστράφηκε ή μια συσχέτιση του ονόματος με χώρα που αναφέρει το AI, όταν είναι διαθέσιμα | Δεν δείχνουν ούτε εθνικότητα ούτε τόπο διαμονής ούτε επαληθευμένη καταγωγή και δεν αποδεικνύουν ότι βρέθηκε αντιστοίχιση για τη χώρα που στάλθηκε |
Πώς η αντιστοίχιση της εισόδου επηρεάζει το αποτέλεσμα
Η αναζήτηση στο σύνολο δεδομένων κανονικοποιεί το κείμενο και εξάγει από αυτό υποψηφίους. Για τις διευθύνσεις email οι υποψήφιοι προέρχονται από το τμήμα πριν από το @. Για τα ονόματα χρήστη αφαιρείται ένα προαιρετικό @ στην αρχή. Οι κανονικές αναζητήσεις διευθύνσεων email και ονομάτων χρήστη μπορούν επιπλέον να ελέγξουν υποσυμβολοσειρές περιορισμένου μήκους. Αν υπάρχουν περισσότερες υποψήφιες εγγραφές, επιλέγεται εκείνη με το υψηλότερο αποθηκευμένο συνολικό πλήθος. Μπορεί να πρόκειται για μέρος διαφορετικό από το αναμενόμενο μικρό όνομα.
Όταν δίνεται πλαίσιο χώρας, για κάθε υποψήφιο η αναζήτηση ελέγχει την εγγραφή της συγκεκριμένης χώρας και, αν δεν υπάρχει, τη γενική εγγραφή. Το τελικό αποτέλεσμα αναφέρει την αντιστοίχιση που επιλέχθηκε. Μια αμφίσημη εγγραφή συγκεκριμένης χώρας δεν αντικαθίσταται αυτόματα από τη γενική εγγραφή για αυτόν τον υποψήφιο.
Το κανονικό prompt του AI αναζητά ένα αναγνωρίσιμο μικρό όνομα. Το forceToGenderize επιτρέπει επιπλέον συσχετίσεις με βάση προσωπικά ψευδώνυμα ή aliases: σε αυτή τη λειτουργία ένα φύλο διαφορετικό από null μαζί με name: null είναι έγκυρο αποτέλεσμα. Πρόκειται για διαφορετικές εργασίες συμπερασμού που πρέπει να αξιολογούνται χωριστά.
Αναζήτηση στο σύνολο δεδομένων και επεξεργασία με AI
Όταν χρησιμοποιείται AI, το V2 διαβιβάζει τα type, value και το πλαίσιο χώρας που στάλθηκαν στη ρυθμισμένη υπηρεσία συμπερασμού του AI. Για τις διευθύνσεις email το prompt ζητά από το μοντέλο να αγνοήσει τον τομέα και το επίθημα μετά το σύμβολο συν. Αυτό δεν εγγυάται ότι οι χαρακτήρες αυτοί αφαιρούνται από την τιμή πριν την επεξεργαστεί το AI. Αν η ροή εργασίας σας απαιτεί πρόβλεψη μόνο με το σύνολο δεδομένων, χρησιμοποιήστε ai_mode: off χωρίς forceToGenderize.
Η επικύρωση της απόκρισης του AI ελέγχει τα πεδία JSON, τους τύπους τους και τη μεταξύ τους συνέπεια. Δεν αποδεικνύει ότι το όνομα που επιστράφηκε, η συσχέτιση φύλου ή η συσχέτιση με χώρα είναι σωστά. Το δημόσιο αποτέλεσμα δεν περιέχει ούτε αναγνωριστικό ή έκδοση του μοντέλου ούτε πηγή που να τεκμηριώνει το συμπέρασμά του.
| Επιλογή | Διαδρομή συμπερασμού | Πληροφορίες που επιστρέφονται |
|---|---|---|
| ai_mode: off | Μόνο αναζήτηση στο σύνολο δεδομένων | Μεταδεδομένα της εγγραφής που επιλέχθηκε ή ένα άγνωστο αποτέλεσμα χωρίς επιλεγμένη εγγραφή |
| ai_mode: fallback | Ελέγχει πρώτα το σύνολο δεδομένων και χρησιμοποιεί AI αν δεν επιστράφηκε φύλο | Πληροφορίες της τελικής διαδρομής και όχι ένα συνδυασμένο δείγμα συνόλου δεδομένων και AI |
| ai_mode: always | Χρησιμοποιεί απευθείας τη ρυθμισμένη διαδρομή συμπερασμού του AI | Μια τιμή που αναφέρει το μοντέλο ή ένα άγνωστο αποτέλεσμα με confidence null. Το sample_count είναι πάντα null |
| forceToGenderize: true | Ελέγχει το σύνολο δεδομένων και, αν το αποτέλεσμα μείνει ανοιχτό, χρησιμοποιεί AI λαμβάνοντας υπόψη τα ψευδώνυμα | Πληροφορίες του συνόλου δεδομένων ή μια συσχέτιση μέσω ψευδωνύμου που αναφέρει το μοντέλο. Το name μπορεί να είναι null |
Τεκμηρίωση των πηγών που δεν έχει δημοσιευθεί ακόμη
Δεν έχει δημοσιευθεί εδώ επαληθευμένος κατάλογος πηγών. Η σύμβαση απόκρισης και η συμπεριφορά της υλοποίησης δεν αρκούν από μόνες τους για να επαληθευτεί η προέλευση των δεδομένων, το δικαίωμα χρήσης μιας πηγής, η αντιπροσωπευτικότητά της ή η ποιότητα των ετικετών της. Πριν διατυπωθούν ισχυρισμοί για συγκεκριμένες πηγές, οι παρακάτω πληροφορίες πρέπει να τεκμηριωθούν και να επαληθευτούν.
Αυτή η επισκόπηση της τεκμηρίωσης δεν καθορίζει αν οι αρχικές πηγές διαθέτουν ή όχι άδεια χρήσης ούτε αν είναι πλήρεις ή ελλιπείς. Περιγράφει τα όρια των δημόσια διαθέσιμων τεκμηρίων. Επικοινωνήστε με το GenderAPI.io αν η περίπτωση χρήσης σας απαιτεί την αξιολόγηση μιας συγκεκριμένης πηγής.
| Τεκμήριο | Απαιτούμενη τεκμηρίωση | Δημόσια κατάσταση |
|---|---|---|
| Προέλευση και δικαίωμα χρήσης | Κατονομαζόμενη πηγή ή εκδότης, περίοδος συλλογής, άδεια χρήσης ή άλλη τεκμηριωμένη βάση για τη χρήση | Δεν έχει δημοσιευθεί εδώ επαληθευμένος κατάλογος |
| Ιστορικό επεξεργασίας | Μετασχηματισμοί, κανονικοποίηση, αφαίρεση διπλοτύπων, συγκέντρωση και κάθε συνθετική ή παραγόμενη από μοντέλο συνεισφορά | Δεν προκύπτει από την ετικέτα source: dataset |
| Κάλυψη του πληθυσμού | Κάλυψη χωρών και συστημάτων γραφής, διαδικασία δειγματοληψίας, ορισμοί των ετικετών και τεκμηριωμένες μεροληψίες | Δεν έχουν δημοσιευθεί εδώ δεδομένα κάλυψης αξιολογημένα ανεξάρτητα |
| Επικαιρότητα | Αναγνωριστικά στιγμιοτύπων, ημερομηνίες ενημέρωσης των επιμέρους πηγών και ένα υποστηριζόμενο πρόγραμμα ενημέρωσης | Η απόκριση V2 δεν περιέχει ούτε πληροφορίες για την επικαιρότητα των επιμέρους εγγραφών ούτε αναγνωριστικό στιγμιοτύπου |
| Ποιότητα και διορθώσεις | Αποτελέσματα επικύρωσης, έλεγχοι επικαλύψεων, χειρισμός διορθώσεων και διαγραφών και ευθύνη για τον έλεγχο | Δεν έχουν δημοσιευθεί εδώ αποτελέσματα ελέγχου για τις επιμέρους πηγές |
Προστασία δεδομένων, επεξεργασία και υπεύθυνη χρήση
Η προέλευση των πηγών, η επεξεργασία προσωπικών δεδομένων και οι νομικοί όροι είναι ξεχωριστά ζητήματα. Οι ρόλοι στην επεξεργασία, οι περίοδοι διατήρησης, οι πάροχοι και οι συμβατικοί όροι περιγράφονται στις πολιτικές που είναι δημοσιευμένες σήμερα. Αυτός ο τεχνικός οδηγός δεν εισάγει νέες δεσμεύσεις για τη διατήρηση δεδομένων και δεν βεβαιώνει κανονιστική συμμόρφωση.
Στείλτε μόνο τα δεδομένα που χρειάζεται η ροή εργασίας σας. Διατηρήστε τους τύπους βαθμού βεβαιότητας και τα άγνωστα αποτελέσματα και μην παρουσιάζετε ένα συμπέρασμα ως την ταυτότητα που δηλώνει ένα άτομο. Μην παίρνετε αποφάσεις με σημαντικές συνέπειες για ένα άτομο με βάση ένα φύλο που συνάγεται.
Τεκμήρια για την ακρίβεια και ιστορικό αλλαγών
Η ετικέτα της πηγής εξηγεί τη διαδρομή συμπερασμού και όχι τη μετρημένη ποιότητά της. Ο οδηγός για την ακρίβεια δείχνει πώς να διακρίνετε ανάμεσα στα αποτελέσματα των απαντήσεων, την κάλυψη των απαντήσεων, τα σφάλματα και τις πληροφορίες που χρειάζονται για μια αναπαραγώγιμη αξιολόγηση.
| Ημερομηνία | Έκδοση του εγγράφου | Αλλαγή |
|---|---|---|
| 2026-09-29 | 1.0.0 | Ελληνική έκδοση της χρονολογημένης απογραφής του MongoDB, των ελέγχων συνέπειας στα δείγματα, των πεδίων source και match του V2, των ορίων της επεξεργασίας με AI και των κενών που υπάρχουν ακόμη στον κατάλογο των πηγών. Η ισοδυναμία MongoDB και Redis βασίζεται στην επιβεβαίωση του GenderAPI.io της 26ης Σεπτεμβρίου 2026. Η ανεξάρτητη σύγκριση εκκρεμεί ακόμη. Δεν προστέθηκε ούτε ποσοστιαία τιμή ακρίβειας ούτε ισχυρισμός για την άδεια χρήσης των πηγών. |