VoyageAI by MongoDB: rerank-2.5
rerank-2.5 réordonne un ensemble fourni de candidats textuels selon leur pertinence pour une requête et des consignes facultatives en langage naturel. C’est un modèle de reclassement multilingue axé sur la qualité, avec un contexte requête-document de 32 000 tokens et des scores classés reliés aux indices des candidats originaux.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
rerank-2.5 est le modèle de reclassement de Voyage AI guidé par consignes, conçu pour affiner un ensemble de candidats de recherche. Il examine conjointement la requête et chaque document comme un cross-encoder, puis renvoie un ordre de pertinence. La publication du fabricant met l’accent sur le contrôle en langage naturel de ce qui compte comme pertinent, la récupération multilingue et un contexte requête-document plus long que celui de l’édition précédente rerank-2.
Fournir au modèle les candidats à comparer
L’entrée est une requête et une liste de documents textuels candidats. Il peut s’agir de passages sélectionnés par une recherche d’embeddings ou une première recherche lexicale. Le modèle de reclassement évalue le texte fourni plutôt que de créer des embeddings de corpus ; son rôle pratique est donc d’affiner les candidats déjà trouvés par la recherche initiale.
Conservez l’ordre original des candidats et les identifiants de sources lors de la préparation de cette liste. Les indices renvoyés font référence à ces positions d’entrée. Pour une tâche RAG, fournissez les passages que l’étape de réponse pourrait réellement utiliser, avec le titre ou les conditions nécessaires à leur interprétation. Un document pertinent absent de l’ensemble de candidats soumis ne peut pas apparaître comme un résultat nouvellement trouvé par le reclassement.
Préciser la notion de pertinence souhaitée
Des consignes peuvent être ajoutées avant ou après la requête. La publication décrit trois rôles utiles : mettre en avant une partie particulière d’un document, privilégier un type de source et lever l’ambiguïté de la requête avec le contexte de l’application. Elles modifient la tâche de pertinence présentée au modèle.
Pour une recherche technique, une consigne illustrative est « Donnez la priorité aux passages qui expliquent le comportement en cas d’échec et de récupération ; les présentations introductives sont secondaires. » Pour une collection de recherche, précisez si le titre, la méthode ou le résultat compte le plus. Pour un terme ambigu, indiquez le domaine de la recherche. Gardez la question et la consigne compatibles, afin que l’une ne demande pas un sujet large tandis que l’autre change implicitement la tâche.
Ces préférences guident l’attribution des scores de pertinence. Si l’application possède des exigences d’éligibilité strictes — comme la version de source, la date ou le périmètre d’accès — préparez séparément l’ensemble des candidats éligibles. La consigne de pertinence du modèle et une restriction déterministe de collection servent des objectifs différents.
Sortie classée et utilisation ultérieure du résultat
Les résultats sont ordonnés par pertinence décroissante et comprennent un score de pertinence à virgule flottante et l’indice d’entrée original du candidat. L’option top-k sélectionne le nombre de premiers résultats à renvoyer ; sans elle, la spécification du fabricant renvoie les résultats pour tous les candidats soumis. Un réglage facultatif return-documents inclut le texte source correspondant ; sinon, la réponse contient des indices et des scores.
Utilisez l’ordre pour sélectionner les passages à afficher ou à transmettre à une étape de réponse ultérieure, en conservant leur identité de source. Examinez le texte réel lors de l’évaluation du classement : le score mesure la pertinence pour la requête soumise, ce n’est ni une réponse générée ni une vérification de l’exactitude des affirmations du document. Cela rend le modèle utile pour affiner des contenus de recherche techniques, juridiques, financiers, médicaux, conversationnels et multilingues sans transformer un classement en conclusion de domaine.
Contexte, budget total de tokens et troncature
La limite documentée de requête est de 8 000 tokens, y compris les consignes placées dans la requête. La requête plus un document candidat quelconque doivent tenir dans 32 000 tokens, et la liste de documents peut contenir au plus 1 000 éléments. Le budget total est de 600 000 tokens, comptés comme les tokens de requête multipliés par le nombre de documents, plus tous les tokens des documents. Une longue consigne est donc comptée plusieurs fois dans les paires de candidats.
Le nombre top-k de sortie ne modifie pas le nombre de candidats dans ce calcul des tokens d’entrée. La troncature par défaut raccourcit les requêtes ou documents trop longs pour respecter la limite de contexte ; la désactiver fait renvoyer une erreur pour une requête ou une paire trop longue. Préparez volontairement des passages contenant la réponse et gardez les conditions pertinentes dans le texte que le modèle verra. Évaluez l’ordre affiné sur des questions et consignes représentatives, puis transmettez les passages originaux sélectionnés à l’étape suivante.
Ailoot Ultra · Reclassement POST /v1/rerank voyageai/rerank-2.5
voyageai/rerank-2.5Premiers pas
rerank-2.5 réordonne un ensemble fourni de candidats textuels selon leur pertinence pour une requête et des consignes facultatives en langage naturel. C’est un modèle de reclassement multilingue axé sur la qualité, avec un contexte requête-document de 32 000 tokens et des scores classés reliés aux indices des candidats originaux.
- Entrées acceptées
- Texte
- Résultats
- Résultats classés
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Reclassement POST /v1/rerank
- Types d’entrée
text- Types de sortie
rerank- Format de sortie
- json
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champdocuments | Typearray | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites voyageai/rerank-2.5 | Par défaut— |
Champprovider | Typeschema | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champquery | Typestring | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champsession_id | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champtop_n | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 1 | Par défaut— |
Champtrace | Typeschema | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champuser | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champdocuments[].text | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champdocuments[].image | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Combinaisons d’éléments d’entrée
text_rerank · Obligatoire : query, documents array with minItems1
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, query, documents |
Paramètrematerial_types | Contrattext |
Paramètreoptional_controls | Contratprovider, session_id, top_n, trace, user |
Paramètremultimodal_input_binding | Contratnull |
Cycle de vie : synchronous
Envoyez l’identifiant exact du modèle et conservez la réponse native complète.
Tarifs
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs Ailoot
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Unité de facturation | Coût |
|---|---|---|---|
| ConfigurationTarifs de base par jeton | Barème tarifaireTarif de base | Unité de facturation— | Coût Entrée · Tokens en entrée — / 1K tokens Sortie · Tokens en sortie — / 1K tokens Entrée · Lecture du cache — / 1K tokens Entrée · Écriture dans le cache — / 1K tokens Entrée · Écriture dans le cache, 1 h — / 1K tokens |
| ConfigurationUltra | Barème tarifaire— | Unité de facturation/ 1K tokens | Coût Entrée $0.0001 / 1K tokens |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
Ailoot Ultra · Reclassement
{
"documents": [
"Paris is the capital of France.",
"Berlin is the capital of Germany."
],
"model": "voyageai/rerank-2.5",
"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-2.5'
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
Recevoir et enregistrer les résultats
Ailoot Ultra · Reclassement
json
Conserver tous les résultats terminés
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Chaque index de résultat réel, chaque relevance_score fini et chaque objet de document d’origine sont conservés. Les index correspondent au tableau de documents d’origine. L’intégralité du JSON d’origine est enregistrée et renvoyée uniquement après le règlement.
Si la réponse d’origine doit être vérifiée
Conservez l’opération d’origine et la réponse complète ou partielle ; ne rejouez pas le POST.
Champs de la réponse
| Champ | Type |
|---|---|
Champmodel | Typestring |
Champid | Typestring |
Champprovider | Typestring |
Champresults[].index | Typeinteger |
Champresults[].relevance_score | Typenumber |
Champresults[].document.text | Typestring |
Champresults[].document.image | Typestring |
Champusage.search_units | Typeinteger |
Champusage.total_tokens | Typeinteger |
Champusage.cost | Typenumber |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamp obligatoire, représentation ou valeur non valide | Étape suivanteCorrigez le champ de requête indiqué. |
Alias
Alias du modèle
Ailoot Ultra voyageai/rerank-2.5
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · VoyageAI by MongoDB: rerank-2.5
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/rerank·voyageai/rerank-2.5:text→rerank- Quels champs la requête utilise-t-elle ?
POST /v1/rerank·voyageai/rerank-2.5:documents,model,provider,query,session_id,top_n,trace,user- Quelles limites s’appliquent ?
POST /v1/rerank·voyageai/rerank-2.5:top_n.minimum:1