VoyageAI by MongoDB: rerank-3
Το Voyage rerank-3 είναι η έκδοση Rerank 3 με έμφαση στην ποιότητα για βαθμολόγηση συνάφειας ερωτήματος–εγγράφου. Αναδιατάσσει ανακτημένα υποψήφια κείμενα, υποστηρίζει οδηγίες συνάφειας φυσικής γλώσσας και χειρίζεται ζεύγη 32.000 token για αναζήτηση μεγάλων εγγράφων, κώδικα και βάσεων γνώσης.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Voyage rerank-3 είναι reranker κειμένου σχεδιασμένος για βελτίωση της ποιότητας ανακτημένων τεκμηρίων. Με ερώτημα και λίστα υποψήφιων εγγράφων, εξετάζει από κοινού κάθε ζεύγος και επιστρέφει τους υποψηφίους κατά συνάφεια. Τα embeddings και η αναζήτηση λέξεων-κλειδιών μπορούν πρώτα να περιορίζουν μεγάλη συλλογή σε διαχειρίσιμη σύντομη λίστα· το rerank-3 εφαρμόζει έπειτα λεπτομερέστερη αξιολόγηση συνάφειας σε αυτήν. Η έξοδός του είναι βαθμολογημένα τεκμήρια αναζήτησης που μια εφαρμογή εμφανίζει ή προωθεί σε χωριστό βήμα παραγωγής απάντησης.
Rerank 3 με έμφαση στην ποιότητα Ο κατασκευαστής τοποθετεί το rerank-3 ως έκδοση με έμφαση στην ακρίβεια και το rerank-3-lite ως έκδοση για αναζήτηση ευαίσθητη στην καθυστέρηση. Η τρίτη γενιά ενημερώνει τον κορμό και το μείγμα εκπαίδευσης, με ιδιαίτερες βελτιώσεις στην ανάκτηση μεγάλων εγγράφων και πηγαίου κώδικα έναντι των αντίστοιχων προκατόχων 2.5. Ο παραγωγός το αξιολογεί σε τεχνική τεκμηρίωση, κώδικα, πολύγλωσσο υλικό και άλλα πεδία εγγράφων. Τα αποτελέσματα στηρίζουν τον ρόλο ανάκτησης· επιλέξτε έκδοση με τις ερωτήσεις και τα υποψήφια έγγραφα που έχουν σημασία στη δική σας συλλογή.
Μεγάλα έγγραφα με επαρκή συμφραζόμενα Ένας μεγάλος υποψήφιος μπορεί να περιέχει χρήσιμα συμφραζόμενα πολύ πέρα από την πρώτη παράγραφο. Δώστε συνεκτική ενότητα ή έγγραφο με τίτλο και σχετικό περιβάλλον υλικό, ώστε να αξιολογηθεί η σχέση της πραγματικής ερώτησης με το περιεχόμενο. Για αναζήτηση πολιτικής προϊόντος, διατηρήστε επικεφαλίδες και εξαιρέσεις γύρω από το ενδιαφέρον απόσπασμα. Αν πολλές ανακτημένες ενότητες προέρχονται από ίδια πηγή, κρατήστε αναγνωριστικά εγγράφου και ενότητας· η εφαρμογή μπορεί έτσι να δείξει την προέλευση των επιλεγμένων τεκμηρίων.
Το παράθυρο μοιράζονται το ερώτημα και κάθε υποψήφιος. Ο τρέχων οδηγός ορίζει 32.000 token για το ζεύγος, περιλαμβάνοντας ερώτημα έως 8.000 token. Ένα ερώτημα 3.000 token αφήνει επομένως έως 29.000 token για κάθε έγγραφο. Προετοιμάστε την είσοδο ώστε να χωρά το ουσιώδες περιεχόμενο, ειδικά όταν μακρύ προοίμιο ή επαναλαμβανόμενο τυποποιημένο κείμενο θα κατανάλωνε το παράθυρο. Η τεκμηριωμένη περικοπή είναι ενεργή από προεπιλογή και μπορεί να συντομεύει υπερμεγέθη ερωτήματα ή έγγραφα πριν από τη βαθμολόγηση. Εξετάστε τι διατηρείται όταν έχει σημασία η θέση αποσπάσματος.
Ανάκτηση κώδικα και τεχνικού υλικού Για το στάδιο ανάκτησης βοηθού προγραμματισμού, οι υποψήφιοι μπορούν να περιέχουν υλοποιήσεις συναρτήσεων, τεκμηρίωση API ή τεχνικές εξηγήσεις ως κείμενο. Συμπεριλάβετε σύμβολα, υπογραφές και συμφραζόμενα που διακρίνουν παρόμοιους υποψηφίους. Ένα ερώτημα όπως «Βρείτε τη συνάρτηση που κανονικοποιεί διαδρομές διατηρώντας το τελικό διαχωριστικό» δίνει συγκεκριμένη συμπεριφορά προς αντιστοίχιση. Προσθέστε σχετικούς περιορισμούς γλώσσας, πλατφόρμας ή έκδοσης. Μετά την κατάταξη, εξετάστε τον επιλεγμένο κώδικα και τις εξαρτήσεις του πριν τον χρησιμοποιήσετε ως συμφραζόμενα· η βαθμολογία συνάφειας δεν αποδεικνύει ότι η υλοποίηση ικανοποιεί κάθε απαίτηση.
Οι οδηγίες ορίζουν τη συνάφεια Το μοντέλο διατηρεί τη δυνατότητα ανακατάταξης βάσει οδηγιών που εισήχθη στο Rerank 2.5. Προτάξτε ή προσθέστε σύντομη οδηγία στο ερώτημα όταν χρειάζεται διευκρίνιση πρόθεσης χρήστη. Για αναζήτηση ερευνητικών εγγράφων, εξηγήστε αν η εστίαση είναι ο τίτλος, συγκεκριμένη μέθοδος ή πεδίο εφαρμογής. Για εσωτερικό κατάλογο, ορίστε αν το αίτημα αφορά εγκατάσταση, αντιμετώπιση προβλημάτων ή συμβατότητα. Ευθυγραμμίστε την οδηγία με την ερώτηση· πρόσθετες προτιμήσεις που συγκρούονται με το κύριο αίτημα μπορούν να αλλάζουν τον στόχο βελτιστοποίησης της κατάταξης.
Προετοιμάστε υποψήφια έγγραφα και προϋπολογισμούς Η είσοδος είναι λίστα συμβολοσειρών κειμένου. Εξαγάγετε αξιοποιήσιμο κείμενο από αρχικά έγγραφα, διατηρήστε ουσιαστικά όρια ενοτήτων και κρατήστε δίπλα στη λίστα μια αντιστοίχιση εγγραφών με την ίδια σειρά. Ο κατασκευαστής επιτρέπει έως 1.000 έγγραφα σε ένα αίτημα. Ορίζει επίσης συνολικό ανώτατο όριο εισόδου 600.000 token: token ερωτήματος επί αριθμό εγγράφων, συν άθροισμα όλων των token εγγράφων. Αυτό διαφέρει από το όριο παραθύρου ανά ζεύγος. Η μείωση πλεονάζοντος κειμένου ερωτήματος διατηρεί χωρητικότητα ζεύγους και συνολικό προϋπολογισμό αιτήματος.
Μετρήστε token για το σχετικό μοντέλο αντί να υποθέτετε ότι πλήθος λέξεων ή χαρακτήρων είναι πλήθος token. Για μεγάλους υποψηφίους, επιλέξτε συνεκτικά αποσπάσματα ή χωρίστε το υλικό με χρήσιμες επικεφαλίδες, διατηρώντας πληροφορίες γονικής πηγής. Η ανακατάταξη είναι χρησιμότερη αφού η πρώτη αναζήτηση έχει ήδη αναδείξει εύλογους υποψηφίους: δεν μπορεί να κατατάξει απούσα πηγή που δεν μπήκε ποτέ στη λίστα.
Ταξινομημένα αποτελέσματα και επόμενη χρήση Το αποτέλεσμα περιέχει βαθμολογίες συνάφειας και δείκτες που αναφέρονται στα αρχικά έγγραφα εισόδου, σε φθίνουσα σειρά συνάφειας. Η επιλογή top_k περιορίζει τον αριθμό επιστρεφόμενων αποτελεσμάτων· διαφορετικά επιστρέφονται όλοι οι υποψήφιοι εισόδου. Η διεπαφή REST επιτρέπει επίσης συμπερίληψη του κειμένου εγγράφου. Χρησιμοποιήστε κάθε αρχικό δείκτη για ανάκτηση τίτλου, αναγνωριστικού πηγής και μεταδεδομένων της εφαρμογής και έπειτα παρουσιάστε τα επιλεγμένα στοιχεία ή εντάξτε το σχετικό κείμενο στα τεκμήρια μιας απάντησης.
Εξετάστε τα κορυφαία αποτελέσματα έναντι της ερώτησης και κρατήστε ορατή την ταυτότητα πηγής. Υψηλή σχετική κατάταξη δεν επαληθεύει την πραγματολογική ακρίβεια εγγράφου και μια λίστα μόνο κακών υποψηφίων θα έχει πάλι πρώτο στοιχείο. Χωρίστε την επιλογή συνάφειας από την απόφαση επάρκειας των επιλεγμένων τεκμηρίων για απάντηση στον χρήστη.
Μετάβαση έκδοσης Ο κατασκευαστής περιγράφει το rerank-3 ως άμεσο διάδοχο του rerank-2.5, με ίδια σημασιολογία API και βαθμολογίες βαθμονομημένες στην κατανομή του αντίστοιχου προκατόχου. Αυτή η συμβατότητα υποστηρίζει διατήρηση υπάρχοντος σταδίου ανάκτησης και αντιστοίχισης εγγραφών. Συγκρίνετε ουσιαστικές κατατάξεις και κάθε κατώφλι βαθμολογίας στο τρέχον σώμα εγγράφων πριν βασιστείτε στη μετάβαση. Κρατήστε rerank-3 και rerank-3-lite ως διακριτές επιλογές: τα κοινά όρια και η τήρηση οδηγιών δεν κάνουν ταυτόσημες τις προτεραιότητες ποιότητας και καθυστέρησης.
Ailoot Ultra · Επανακατάταξη POST /v1/rerank voyageai/rerank-3
voyageai/rerank-3Εισαγωγή
Το Voyage rerank-3 είναι η έκδοση Rerank 3 με έμφαση στην ποιότητα για βαθμολόγηση συνάφειας ερωτήματος–εγγράφου. Αναδιατάσσει ανακτημένα υποψήφια κείμενα, υποστηρίζει οδηγίες συνάφειας φυσικής γλώσσας και χειρίζεται ζεύγη 32.000 token για αναζήτηση μεγάλων εγγράφων, κώδικα και βάσεων γνώσης.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Αποτελέσματα κατά σειρά συνάφειας
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Επανακατάταξη POST /v1/rerank
- Είσοδος
text- Έξοδος
rerank- Μορφή εξόδου
- json
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοdocuments | Τύποςarray | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια voyageai/rerank-3 | Προεπιλογή— |
Πεδίοprovider | Τύποςschema | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοquery | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοsession_id | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοtop_n | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 | Προεπιλογή— |
Πεδίοtrace | Τύποςschema | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοuser | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοdocuments[].text | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοdocuments[].image | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
text_rerank · Υποχρεωτικό: query, documents array with minItems1
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, query, documents |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςoptional_controls | Σύμβασηprovider, session_id, top_n, trace, user |
Παράμετροςmultimodal_input_binding | Σύμβασηnull |
Κύκλος ζωής: synchronous
Στείλτε το ακριβές ID μοντέλου και διατηρήστε ολόκληρη την εγγενή απόκριση.
Τιμολόγηση
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Χρεώσεις Ailoot
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Μονάδα τιμολόγησης | Χρέωση |
|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Μονάδα τιμολόγησης— | Χρέωση Είσοδος · Token εισόδου — / 1K token Έξοδος · Token εξόδου — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
| ΔιαμόρφωσηUltra | Πίνακας χρεώσεων— | Μονάδα τιμολόγησης/ 1K token | Χρέωση Είσοδος $0.0001 / 1K token |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Επανακατάταξη
{
"documents": [
"Paris is the capital of France.",
"Berlin is the capital of Germany."
],
"model": "voyageai/rerank-3",
"query": "What is the capital of France?",
"top_n": 3
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='voyageai/rerank-3'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Επανακατάταξη
json
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Διατηρήστε κάθε πλήρη απάντηση, αρχείο και τμήμα περιεχομένου που επιστρέφεται.
Διατηρείται κάθε πραγματικός δείκτης αποτελέσματος, κάθε πεπερασμένο relevance_score και κάθε αρχικό αντικείμενο εγγράφου. Οι δείκτες αντιστοιχούν στον αρχικό πίνακα εγγράφων. Ολόκληρο το αρχικό JSON αποθηκεύεται και επιστρέφεται μόνο μετά την εκκαθάριση.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε την αρχική λειτουργία και την πλήρη ή μερική απάντηση· μην επαναλάβετε το POST.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοmodel | Τύποςstring |
Πεδίοid | Τύποςstring |
Πεδίοprovider | Τύποςstring |
Πεδίοresults[].index | Τύποςinteger |
Πεδίοresults[].relevance_score | Τύποςnumber |
Πεδίοresults[].document.text | Τύποςstring |
Πεδίοresults[].document.image | Τύποςstring |
Πεδίοusage.search_units | Τύποςinteger |
Πεδίοusage.total_tokens | Τύποςinteger |
Πεδίοusage.cost | Τύποςnumber |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρο απαιτούμενο πεδίο, αναπαράσταση ή τιμή | Επόμενο βήμαΔιορθώστε το υποδεικνυόμενο πεδίο του αιτήματος. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra voyageai/rerank-3
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · VoyageAI by MongoDB: rerank-3
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/rerank·voyageai/rerank-3:text→rerank- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/rerank·voyageai/rerank-3:documents,model,provider,query,session_id,top_n,trace,user- Ποια όρια ισχύουν;
POST /v1/rerank·voyageai/rerank-3:top_n.minimum:1