modèles

VoyageAI by MongoDB: rerank-3

Markdown · JSON

VoyageAI by MongoDB: rerank-3

Voyage rerank-3 est l’édition Rerank 3 axée sur la qualité pour évaluer la pertinence requête-document. Il réordonne des candidats textuels récupérés, accepte des consignes de pertinence en langage naturel et traite des paires de 32 000 tokens pour la recherche dans les documents longs, le code et les bases de connaissances.

À 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.

Voyage rerank-3 est un modèle de reclassement textuel conçu pour améliorer la qualité des éléments récupérés. À partir d’une requête et d’une liste de documents candidats, il examine conjointement chaque paire et renvoie les candidats classés par pertinence. Les embeddings et la recherche par mots-clés peuvent d’abord réduire une grande collection à une présélection gérable ; rerank-3 applique ensuite une évaluation plus détaillée de la pertinence à cette présélection. Sa sortie est constituée d’éléments de recherche notés qu’une application affiche ou transmet à une étape distincte de génération de réponse.

Rerank 3 axé sur la qualité Le fabricant positionne rerank-3 comme l’édition axée sur l’exactitude et rerank-3-lite comme l’édition destinée à la recherche sensible à la latence. La troisième génération actualise l’architecture de base et le mélange d’entraînement, avec des améliorations particulières dans la récupération de documents longs et de code source par rapport aux prédécesseurs 2.5 correspondants. Le fournisseur l’évalue sur la documentation technique, le code, les contenus multilingues et d’autres domaines documentaires. Ces résultats soutiennent son rôle de récupération ; sélectionnez l’édition selon les questions et documents candidats importants pour votre propre collection.

Documents longs avec suffisamment de contexte Un long candidat peut contenir du contexte utile bien au-delà de son premier paragraphe. Fournissez une section ou un document cohérent avec son titre et les éléments environnants pertinents, pour que le modèle puisse évaluer le lien entre la question réelle et le contenu. Pour une recherche de politique produit, conservez les titres et les exceptions autour du passage visé. Si plusieurs sections récupérées proviennent de la même source, conservez leurs identifiants de document et de section ; l’application peut alors montrer l’origine des éléments sélectionnés.

La fenêtre de contexte est partagée par la requête et chaque candidat. Le guide actuel du fabricant indique 32 000 tokens pour cette paire, dont une requête d’au plus 8 000 tokens. Une requête de 3 000 tokens laisse donc au maximum 29 000 tokens pour chaque document. Préparez l’entrée pour que son contenu essentiel tienne, notamment lorsqu’un long préambule ou du contenu passe-partout répété consommerait sinon la fenêtre. L’option documentée de troncature est activée par défaut et peut raccourcir le texte trop grand de la requête ou du document avant l’attribution des scores. Examinez ce qui est conservé lorsque l’emplacement des passages compte.

Récupération de code et de contenus techniques Pour l’étape de récupération d’un assistant de programmation, les candidats peuvent contenir des implémentations de fonctions, de la documentation API ou des explications techniques sous forme de texte. Incluez les symboles, les signatures et le contexte nécessaires pour distinguer des candidats similaires. Une requête comme « Trouvez la fonction qui normalise les chemins tout en conservant un séparateur final » donne un comportement concret à rechercher. Ajoutez les contraintes pertinentes de langage, de plateforme ou de version. Après le classement, examinez le code sélectionné et ses dépendances avant de l’utiliser comme contexte ; un score de pertinence ne prouve pas qu’une implémentation satisfait toutes les exigences énoncées.

Les consignes définissent la pertinence Le modèle conserve la capacité de reclassement guidé par consignes introduite dans Rerank 2.5. Ajoutez une consigne concise avant ou après la requête lorsque l’intention de l’utilisateur doit être clarifiée. Pour rechercher des documents de recherche, expliquez si l’accent porte sur le titre, une méthode particulière ou un domaine d’application. Pour un catalogue interne, précisez si la demande concerne l’installation, le dépannage ou la compatibilité. Gardez cette consigne alignée sur la question ; des préférences supplémentaires en conflit avec la demande principale peuvent modifier l’objectif du classement.

Préparer les documents candidats et les budgets L’entrée est une liste de chaînes textuelles. Extrayez du texte exploitable des documents sources, préservez les limites de sections utiles et gardez une correspondance ordonnée des dossiers avec la liste. Le fabricant autorise jusqu’à 1 000 documents par requête. Il indique aussi un plafond agrégé d’entrée de 600 000 tokens : tokens de la requête multipliés par le nombre de documents, plus la somme des tokens de tous les documents. Cela diffère de la limite de contexte par paire. Réduire le texte redondant de la requête peut préserver à la fois la capacité des paires et le budget global de la requête.

Comptez les tokens du modèle concerné plutôt que de supposer qu’un nombre de mots ou de caractères équivaut à un nombre de tokens. Pour les grands candidats, sélectionnez des passages cohérents ou divisez le contenu selon des titres utiles en conservant les informations sur la source parente. Le reclassement est surtout utile après qu’une première recherche a déjà fait apparaître des candidats plausibles : il ne peut pas classer une source manquante qui n’est jamais entrée dans la liste.

Résultats classés et utilisation en aval Le résultat contient les scores de pertinence et les indices renvoyant aux documents d’entrée originaux, triés par pertinence décroissante. L’option top_k limite le nombre de résultats classés renvoyés ; sinon, tous les candidats d’entrée sont renvoyés. L’interface REST du fabricant permet également d’inclure le texte du document. Utilisez chaque indice original pour retrouver le titre, l’identifiant de source et toutes les métadonnées nécessaires à l’application, puis présentez les éléments sélectionnés ou placez le texte pertinent dans le contexte probant d’une réponse.

Examinez les premiers résultats par rapport à la question et gardez l’identité des sources visible. Un rang relatif élevé ne vérifie pas l’exactitude factuelle d’un document, et une présélection de mauvais candidats aura toujours un premier élément. Distinguez la sélection par pertinence de la décision de savoir si les éléments sélectionnés suffisent à répondre à l’utilisateur.

Migration d’édition Le fabricant décrit rerank-3 comme un successeur directement substituable à rerank-2.5, avec la même sémantique API et des scores calibrés sur la distribution de son prédécesseur correspondant. Cette compatibilité permet de conserver une étape de récupération et une correspondance de dossiers existantes. Comparez des classements significatifs et tout seuil de score sur le corpus actuel avant de vous fier à la migration. Gardez rerank-3 et rerank-3-lite comme choix distincts : des limites et un suivi des consignes communs ne rendent pas identiques leurs priorités de qualité et de latence.

Ailoot Ultra · Reclassement POST /v1/rerank voyageai/rerank-3

voyageai/rerank-3

VoyageAI by MongoDB /voyageai/rerank-3

Premiers pas

Voyage rerank-3 est l’édition Rerank 3 axée sur la qualité pour évaluer la pertinence requête-document. Il réordonne des candidats textuels récupérés, accepte des consignes de pertinence en langage naturel et traite des paires de 32 000 tokens pour la recherche dans les documents longs, le code et les bases de connaissances.

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
ChampTypeExigenceValeurs et limitesPar défaut
ChampdocumentsTypearrayExigenceObligatoireValeurs et limitesPar défaut—
ChampmodelTypestringExigenceObligatoireValeurs et limites
voyageai/rerank-3
Par défaut—
ChampproviderTypeschemaExigenceFacultatifValeurs et limitesPar défaut—
ChampqueryTypestringExigenceObligatoireValeurs et limitesPar défaut—
Champsession_idTypestringExigenceFacultatifValeurs et limitesPar défaut—
Champtop_nTypeintegerExigenceFacultatifValeurs et limites
Minimum: 1
Par défaut—
ChamptraceTypeschemaExigenceFacultatifValeurs et limitesPar défaut—
ChampuserTypestringExigenceFacultatifValeurs et limitesPar défaut—
Champdocuments[].textTypestringExigenceFacultatifValeurs et limitesPar défaut—
Champdocuments[].imageTypestringExigenceFacultatifValeurs et limitesPar 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ètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratmodel, query, documents
Paramètrematerial_typesContrattext
Paramètreoptional_controlsContratprovider, session_id, top_n, trace, user
Paramètremultimodal_input_bindingContratnull

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.

ConfigurationBarème tarifaireUnité de facturationCoût
ConfigurationTarifs de base par jetonBarème tarifaireTarif de baseUnité 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
ConfigurationUltraBarème tarifaire—Unité de facturation/ 1K tokensCoû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

Structure officielle de requête conservée ; exemple de documentationUtilisez les données réelles de votre requête et conservez le résultat complet
{
  "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

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
ChampType
ChampmodelTypestring
ChampidTypestring
ChampproviderTypestring
Champresults[].indexTypeinteger
Champresults[].relevance_scoreTypenumber
Champresults[].document.textTypestring
Champresults[].document.imageTypestring
Champusage.search_unitsTypeinteger
Champusage.total_tokensTypeinteger
Champusage.costTypenumber
Erreurs et étapes suivantes
RéponseConditionÉtape suivante
Réponse400 · invalid_request_errorConditionChamp obligatoire, représentation ou valeur non valideÉtape suivanteCorrigez le champ de requête indiqué.

Alias

Alias du modèle

Ailoot Ultra voyageai/rerank-3

Alias des chemins de méthode

Utilisez les chemins de méthode indiqués ci-dessus.

ID d’appel associés

voyageai/rerank-3

FAQ · VoyageAI by MongoDB: rerank-3
Quelles entrées et quels résultats sont disponibles ?

POST /v1/rerank · voyageai/rerank-3: text → rerank

Quels champs la requête utilise-t-elle ?

POST /v1/rerank · voyageai/rerank-3: documents, model, provider, query, session_id, top_n, trace, user

Quelles limites s’appliquent ?

POST /v1/rerank · voyageai/rerank-3: top_n.minimum: 1

Plus de détails

Connectez Ailoot à Claude Code, OpenCode, Hermes ou à votre application.

L’entreprise et son portefeuille de projets

L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.

Achetez des tokens à prix réduit.

Une remise d’abonnement pour le travail régulier. Des codes promo jusqu’à 50% sur l’achat de tokens.

Abonnement
Choisissez une offre à tarif réduit pour vos requêtes régulières.
Code promo jusqu’à 50%
Saisissez le code à l’achat. Le prix est recalculé selon la promotion en cours.
Dépenses dans l’historique
Modèle, tokens et montant sont enregistrés pour chaque requête.

Choisir un abonnement · Voir les prix des modèles

Connectez l’API au produit que vous vendez.

SaaS, applications et bots selon l’offre officielle et le contrat de licence Ailoot. Pour la revente, demandez une licence revendeur.

Application commerciale
Intégrez la génération de texte, d’images, de vidéo et de son aux fonctions payantes de votre service.
Licence revendeur
Envoyez la description du projet et le mode d’accès. Demandez des conditions écrites d’utilisation et de revente.
Documents sur le site
L’offre officielle, le contrat de licence et la politique de traitement des données sont accessibles avant connexion.

Demander une licence revendeur · Offre officielle et contrat de licence