VoyageAI by MongoDB: rerank-3-lite
Το Voyage rerank-3-lite βαθμολογεί και αναδιατάσσει υποψήφια έγγραφα κειμένου για ένα ερώτημα, με έμφαση στην άμεση απόκριση αναζήτησης. Υποστηρίζει οδηγίες συνάφειας και παράθυρο ερωτήματος–εγγράφου 32.000 token, και χρησιμεύει μετά από διανυσματική ανάκτηση ή ανάκτηση λέξεων-κλειδιών σε ροές αναζήτησης και RAG.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Voyage rerank-3-lite είναι η έκδοση της σειράς Rerank 3 της Voyage με έμφαση στη χαμηλή καθυστέρηση. Δέχεται ερώτημα κειμένου και υποψήφια έγγραφα, αξιολογεί μαζί κάθε ζεύγος ερωτήματος–εγγράφου και επιστρέφει βαθμολογίες συνάφειας σε ταξινομημένη σειρά. Εξυπηρετεί το δεύτερο στάδιο αναζήτησης: ένας μηχανισμός ανάκτησης με embeddings ή λέξεις-κλειδιά βρίσκει τους υποψηφίους και το Lite βελτιώνει τη σειρά τους. Το αποτέλεσμα είναι κατάταξη για αναζήτηση ή ροή παραγωγής ενισχυμένης με ανάκτηση.
Τι αλλάζει στο Rerank 3 Lite Ο παραγωγός τονίζει ισχυρότερη ανάκτηση μεγάλων εγγράφων και κώδικα έναντι του rerank-2.5-lite. Και οι δύο εκδόσεις Rerank 3 διατηρούν τήρηση οδηγιών και την ίδια κατηγορία παραθύρου 32K, ενώ το Lite σχεδιάστηκε για εφαρμογές ευαίσθητες στην καθυστέρηση. Είναι έτσι πρακτικό υποψήφιο για διαδραστική αναζήτηση βάσης γνώσης, ανάκτηση εγγράφων υποστήριξης και εύρεση κώδικα όταν χρειάζονται γρήγορα σχετικά αποτελέσματα. Επιλέξτε το βάσει απαιτήσεων ποιότητας και χρόνου απόκρισης της πραγματικής συλλογής, αντί να υποθέτετε ότι μικρότερη έκδοση σημαίνει μικρότερο παράθυρο συμφραζομένων.
Καθοδηγήστε τη συνάφεια με το ερώτημα Οδηγίες φυσικής γλώσσας μπορούν να συνοδεύουν το ερώτημα για να εξηγούν τι θεωρείται σχετικό. Κρατήστε σύντομες και συνεπείς την ερώτηση και την προτίμηση συνάφειας. Για αναζήτηση υποστήριξης λογισμικού, χρησιμοποιήστε «Βρείτε τη διαδικασία επαναφοράς μιας συσκευής· δώστε προτεραιότητα σε οδηγίες για τη δηλωμένη έκδοση υλικού». Για αμφίσημο όνομα προϊόντος, συμπεριλάβετε την κατηγορία του ώστε να μην κυριαρχούν άσχετες σημασίες. Μια προτίμηση στο ερώτημα καθοδηγεί τη σημασιολογική βαθμολόγηση· χρησιμοποιήστε ρητά μεταδεδομένα συλλογής για επιλογή σωστού προϊόντος, έκδοσης εγγράφου ή πεδίου πρόσβασης πριν δημιουργήσετε τη λίστα υποψηφίων.
Προετοιμάστε σύντομη λίστα υποψήφιων κειμένων Τα έγγραφα εισόδου είναι συμβολοσειρές. Εξαγάγετε ευανάγνωστο κείμενο από το αρχικό υλικό και διατηρήστε χρήσιμους τίτλους, επικεφαλίδες, αναγνωριστικά και γύρω συμφραζόμενα. Κρατήστε σταθερή αντιστοίχιση κάθε θέσης εισόδου με την αρχική εγγραφή. Για άρθρο αντιμετώπισης προβλημάτων, συμπεριλάβετε το σύμπτωμα και τη σχετική διαδικασία, όχι μόνο απομονωμένη πρόταση. Για αναζήτηση πηγαίου κώδικα, συμπεριλάβετε τη συνάρτηση και τις κοντινές πληροφορίες που τη διακρίνουν από παρόμοια ονομασμένες συναρτήσεις. Αφαιρέστε επαναλαμβανόμενη πλοήγηση ή τυποποιημένο κείμενο όταν εκτοπίζει το χρήσιμο απόσπασμα.
Ο reranker μπορεί να αναδιατάσσει μόνο τα έγγραφα που λαμβάνει. Αν η πρώτη αναζήτηση δεν ανακτήσει το σχετικό άρθρο, αυτό το στάδιο δεν μπορεί να ανακτήσει τον απόντα υποψήφιο. Εξετάστε και τη σύντομη λίστα και την τελική κατάταξη όταν ένα αποτέλεσμα φαίνεται λανθασμένο. Όταν μεγάλο έγγραφο καλύπτει πολλά θέματα, χωρίστε συνεκτικές ενότητες και διατηρήστε αναφορές στο γονικό έγγραφο, ώστε να επιλέγεται σχετική ενότητα χωρίς απώλεια πηγής.
Όρια παραθύρου και αιτήματος Ο τρέχων οδηγός του κατασκευαστή ορίζει μέγιστο ερώτημα 8.000 token και συνδυασμένο μέγιστο 32.000 token για το ερώτημα μαζί με κάθε μεμονωμένο έγγραφο. Επιτρέπει έως 1.000 υποψήφια έγγραφα και συνολικό προϋπολογισμό αιτήματος 600.000 token, υπολογιζόμενο ως token ερωτήματος επί αριθμό εγγράφων, συν όλα τα token εγγράφων. Ένα μακρύ ερώτημα επομένως καταναλώνει χώρο σε κάθε ζεύγος και συνεισφέρει επανειλημμένα στον συνολικό προϋπολογισμό. Μετρήστε το υποβαλλόμενο κείμενο με τον κατάλληλο tokenizer μοντέλου αντί να θεωρείτε χαρακτήρες, λέξεις και token εναλλάξιμα.
Για παράδειγμα, ερώτημα 500 token με 100 έγγραφα των 4.000 token το καθένα αντιστοιχεί σε 450.000 token εισόδου βάσει αυτού του τύπου. Αυτό δείχνει υπολογισμό προϋπολογισμού, όχι συνιστώμενο μέγεθος λίστας ή μετρημένη ταχύτητα. Η τεκμηριωμένη επιλογή περικοπής είναι ενεργή από προεπιλογή· υπερμεγέθη κείμενα μπορεί να συντομεύονται πριν από τη βαθμολόγηση. Προετοιμάστε σκόπιμα τις σημαντικές ενότητες ώστε η περικοπή να μην αφαιρεί το ίδιο το απόσπασμα προς αντιστοίχιση.
Διαβάστε και χρησιμοποιήστε το αποτέλεσμα Τα αποτελέσματα ταξινομούνται από την υψηλότερη βαθμολογία συνάφειας προς τα κάτω. Καθένα προσδιορίζει την αρχική θέση εισόδου του εγγράφου, επιτρέποντας στην εφαρμογή να συνδέει δικό της τίτλο, αναγνωριστικό εγγραφής και πηγή. Η ρύθμιση top_k ελέγχει πόσοι ταξινομημένοι υποψήφιοι επιστρέφονται· χωρίς αυτή επιστρέφονται όλοι. Η διεπαφή REST του κατασκευαστή μπορεί επίσης να επιστρέφει το κείμενο εγγράφου. Διατηρήστε τα αρχικά αναγνωριστικά δίπλα στα επιλεγμένα αποτελέσματα όταν εμφανίζετε σελίδα αναζήτησης ή προωθείτε τεκμήρια σε βήμα παραγωγής απάντησης.
Η βαθμολογία συνάφειας εκφράζει πόσο καλά ο υποψήφιος ταιριάζει στο ερώτημα· δεν τεκμηριώνει την ορθότητα των δηλώσεών του. Συγκρίνετε τα κορυφαία στοιχεία με την πραγματική ερώτηση του χρήστη, περιλαμβάνοντας εξαιρέσεις και διαφορές εκδόσεων εγγράφων. Αν όλοι οι υποψήφιοι είναι άσχετοι, εξακολουθεί να υπάρχει πρώτος στην κατάταξη. Αποφασίστε πώς η εφαρμογή χειρίζεται την περίπτωση με αντιπροσωπευτικά ερωτήματα της συλλογής.
Αναβάθμιση και επιλογή έκδοσης Ο κατασκευαστής περιγράφει το rerank-3-lite ως αναβάθμιση του rerank-2.5-lite με αμετάβλητη σημασιολογία API και βαθμολογίες βαθμονομημένες στην κατανομή του αντίστοιχου προκατόχου. Διατηρήστε την υπάρχουσα αντιστοίχιση εγγραφών και το στάδιο ανάκτησης και συγκρίνετε τη σειρά αποτελεσμάτων σε ουσιαστικά ερωτήματα πριν βασιστείτε σε καθιερωμένο κατώφλι βαθμολογίας. Χρησιμοποιήστε Lite για αναζήτηση όπου μετρά ο χρόνος απόκρισης· χρησιμοποιήστε την έκδοση rerank-3 με έμφαση στην ποιότητα ως σύγκριση όταν προέχει η συνάφεια δύσκολων υποψηφίων.
Ailoot Ultra · Επανακατάταξη POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-liteΕισαγωγή
Το Voyage rerank-3-lite βαθμολογεί και αναδιατάσσει υποψήφια έγγραφα κειμένου για ένα ερώτημα, με έμφαση στην άμεση απόκριση αναζήτησης. Υποστηρίζει οδηγίες συνάφειας και παράθυρο ερωτήματος–εγγράφου 32.000 token, και χρησιμεύει μετά από διανυσματική ανάκτηση ή ανάκτηση λέξεων-κλειδιών σε ροές αναζήτησης και RAG.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Αποτελέσματα κατά σειρά συνάφειας
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Επανακατάταξη POST /v1/rerank
- Είσοδος
text- Έξοδος
rerank- Μορφή εξόδου
- json
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοdocuments | Τύποςarray | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια voyageai/rerank-3-lite | Προεπιλογή— |
Πεδίο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.00004 / 1K token |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Επανακατάταξη
{
"documents": [
"Paris is the capital of France.",
"Berlin is the capital of Germany."
],
"model": "voyageai/rerank-3-lite",
"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-lite'
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-lite
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · VoyageAI by MongoDB: rerank-3-lite
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/rerank·voyageai/rerank-3-lite:text→rerank- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/rerank·voyageai/rerank-3-lite:documents,model,provider,query,session_id,top_n,trace,user- Ποια όρια ισχύουν;
POST /v1/rerank·voyageai/rerank-3-lite:top_n.minimum:1