Voyage rerank-3 est un modèle de reclassement textuel conçu pour améliorer la qualité des éléments récupérés. Avec une requête et une liste de documents candidats, il examine conjointement chaque paire et retourne les candidats classés par pertinence. Les plongements et la recherche par mots-clés peuvent d’abord réduire une grande collection à une liste restreinte gérable; rerank-3 applique ensuite une évaluation plus détaillée de la pertinence à cette liste. Sa sortie est un ensemble d’éléments de recherche notés qu’une application peut afficher ou transmettre à 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 celle destinée à la recherche sensible à la latence. La troisième génération met à jour l’architecture de base et le mélange d’entraînement, avec des améliorations particulières de récupération des longs documents et du code source par rapport aux prédécesseurs 2.5 correspondants. Le fournisseur l’évalue sur la documentation technique, le code, le contenu multilingue et d’autres domaines documentaires. Ces résultats appuient son rôle de récupération; choisissez l’édition à partir des questions et des documents candidats qui comptent pour votre collection.
De longs documents avec assez 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 le contenu environnant pertinent, pour que le modèle puisse évaluer le lien entre la question réelle et le contenu. Pour une recherche de politique de produit, conservez les titres et les exceptions autour du passage d’intérêt. Si plusieurs sections récupérées proviennent de la même source, conservez leurs identifiants de document et de section; l’application pourra alors montrer d’où viennent les é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 précise 32 000 jetons pour cette paire, y compris une requête d’au plus 8 000 jetons. Une requête de 3 000 jetons laisse donc au plus 29 000 jetons pour chaque document. Préparez l’entrée pour que son contenu essentiel tienne, surtout lorsqu’un long préambule ou du texte passe-partout répété consommerait autrement la fenêtre. L’option de troncature documentée est activée par défaut et peut raccourcir le texte trop long d’une requête ou d’un document avant la notation. Examinez ce qui est conservé lorsque l’emplacement d’un passage compte.
Récupération de code et de contenu technique Pour l’étape de récupération d’un assistant de code, les candidats peuvent contenir des implémentations de fonctions, de la documentation d’API ou des explications techniques sous forme de texte. Incluez les symboles, les signatures et le contexte nécessaires pour distinguer les candidats semblables. Une requête comme « Trouver la fonction qui normalise les chemins tout en conservant un séparateur de fin » donne un comportement concret à faire correspondre. Joignez toute contrainte pertinente de langue de programmation, 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 courte consigne avant ou après la requête lorsque l’intention de l’utilisateur doit être clarifiée. Pour une recherche documentaire, 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 cohérente avec la question; des préférences supplémentaires qui contredisent la demande principale peuvent changer ce que le classement cherche à optimiser.
Préparer les documents candidats et les budgets L’entrée est une liste de chaînes textuelles. Extrayez du texte utilisable des documents sources, conservez les limites de sections significatives et gardez une table ordonnée de correspondance des enregistrements avec la liste. Le fabricant permet jusqu’à 1 000 documents dans une requête. Il précise aussi un plafond global d’entrée de 600 000 jetons : les jetons de la requête multipliés par le nombre de documents, plus la somme de tous les jetons des documents. Cela diffère de la limite de contexte par paire. Réduire le texte redondant de la requête peut préserver la capacité des paires et le budget total de requête.
Comptez les jetons pour le modèle pertinent, plutôt que de supposer qu’un nombre de mots ou de caractères équivaut à un nombre de jetons. Pour les grands candidats, sélectionnez des passages cohérents ou divisez le contenu selon des titres utiles en conservant l’information de source parente. Le reclassement est surtout utile une fois que la première recherche a déjà fait ressortir 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 des scores de pertinence et des 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 retournés; sinon, tous les candidats d’entrée sont retournés. L’interface REST du fabricant permet aussi d’inclure le texte des documents. Utilisez chaque indice d’origine pour retrouver le titre, l’identifiant de source et les métadonnées nécessaires à votre application, puis présentez les éléments sélectionnés ou regroupez le texte pertinent dans le contexte de preuves d’une réponse.
Examinez les premiers résultats par rapport à la question et gardez l’identité de la source visible. Un rang relatif élevé ne vérifie pas l’exactitude factuelle d’un document, et une liste restreinte composée seulement de mauvais candidats aura toujours un premier élément. Séparez la sélection par pertinence de la décision à savoir si les éléments sélectionnés suffisent pour répondre à l’utilisateur.
Migration d’édition Le fabricant décrit rerank-3 comme un successeur de rerank-2.5 compatible sans adaptation, avec la même sémantique d’API et des scores calibrés selon la distribution de son prédécesseur correspondant. Cette compatibilité permet de conserver une étape de récupération et une correspondance d’enregistrements existantes. Comparez des ordres de résultats 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 leurs priorités de qualité et de latence identiques.
", "aboutText": "Voyage rerank-3 est un modèle de reclassement textuel conçu pour améliorer la qualité des éléments récupérés. Avec une requête et une liste de documents candidats, il examine conjointement chaque paire et retourne les candidats classés par pertinence. Les plongements et la recherche par mots-clés peuvent d’abord réduire une grande collection à une liste restreinte gérable; rerank-3 applique ensuite une évaluation plus détaillée de la pertinence à cette liste. Sa sortie est un ensemble d’éléments de recherche notés qu’une application peut afficher ou transmettre à une étape distincte de génération de réponse.\n\nRerank 3 axé sur la qualité\nLe fabricant positionne rerank-3 comme l’édition axée sur l’exactitude et rerank-3-lite comme celle destinée à la recherche sensible à la latence. La troisième génération met à jour l’architecture de base et le mélange d’entraînement, avec des améliorations particulières de récupération des longs documents et du code source par rapport aux prédécesseurs 2.5 correspondants. Le fournisseur l’évalue sur la documentation technique, le code, le contenu multilingue et d’autres domaines documentaires. Ces résultats appuient son rôle de récupération; choisissez l’édition à partir des questions et des documents candidats qui comptent pour votre collection.\n\nDe longs documents avec assez de contexte\nUn 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 le contenu environnant pertinent, pour que le modèle puisse évaluer le lien entre la question réelle et le contenu. Pour une recherche de politique de produit, conservez les titres et les exceptions autour du passage d’intérêt. Si plusieurs sections récupérées proviennent de la même source, conservez leurs identifiants de document et de section; l’application pourra alors montrer d’où viennent les éléments sélectionnés.\n\nLa fenêtre de contexte est partagée par la requête et chaque candidat. Le guide actuel du fabricant précise 32 000 jetons pour cette paire, y compris une requête d’au plus 8 000 jetons. Une requête de 3 000 jetons laisse donc au plus 29 000 jetons pour chaque document. Préparez l’entrée pour que son contenu essentiel tienne, surtout lorsqu’un long préambule ou du texte passe-partout répété consommerait autrement la fenêtre. L’option de troncature documentée est activée par défaut et peut raccourcir le texte trop long d’une requête ou d’un document avant la notation. Examinez ce qui est conservé lorsque l’emplacement d’un passage compte.\n\nRécupération de code et de contenu technique\nPour l’étape de récupération d’un assistant de code, les candidats peuvent contenir des implémentations de fonctions, de la documentation d’API ou des explications techniques sous forme de texte. Incluez les symboles, les signatures et le contexte nécessaires pour distinguer les candidats semblables. Une requête comme « Trouver la fonction qui normalise les chemins tout en conservant un séparateur de fin » donne un comportement concret à faire correspondre. Joignez toute contrainte pertinente de langue de programmation, 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.\n\nLes consignes définissent la pertinence\nLe modèle conserve la capacité de reclassement guidé par consignes introduite dans Rerank 2.5. Ajoutez une courte consigne avant ou après la requête lorsque l’intention de l’utilisateur doit être clarifiée. Pour une recherche documentaire, 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 cohérente avec la question; des préférences supplémentaires qui contredisent la demande principale peuvent changer ce que le classement cherche à optimiser.\n\nPréparer les documents candidats et les budgets\nL’entrée est une liste de chaînes textuelles. Extrayez du texte utilisable des documents sources, conservez les limites de sections significatives et gardez une table ordonnée de correspondance des enregistrements avec la liste. Le fabricant permet jusqu’à 1 000 documents dans une requête. Il précise aussi un plafond global d’entrée de 600 000 jetons : les jetons de la requête multipliés par le nombre de documents, plus la somme de tous les jetons des documents. Cela diffère de la limite de contexte par paire. Réduire le texte redondant de la requête peut préserver la capacité des paires et le budget total de requête.\n\nComptez les jetons pour le modèle pertinent, plutôt que de supposer qu’un nombre de mots ou de caractères équivaut à un nombre de jetons. Pour les grands candidats, sélectionnez des passages cohérents ou divisez le contenu selon des titres utiles en conservant l’information de source parente. Le reclassement est surtout utile une fois que la première recherche a déjà fait ressortir des candidats plausibles : il ne peut pas classer une source manquante qui n’est jamais entrée dans la liste.\n\nRésultats classés et utilisation en aval\nLe résultat contient des scores de pertinence et des 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 retournés; sinon, tous les candidats d’entrée sont retournés. L’interface REST du fabricant permet aussi d’inclure le texte des documents. Utilisez chaque indice d’origine pour retrouver le titre, l’identifiant de source et les métadonnées nécessaires à votre application, puis présentez les éléments sélectionnés ou regroupez le texte pertinent dans le contexte de preuves d’une réponse.\n\nExaminez les premiers résultats par rapport à la question et gardez l’identité de la source visible. Un rang relatif élevé ne vérifie pas l’exactitude factuelle d’un document, et une liste restreinte composée seulement de mauvais candidats aura toujours un premier élément. Séparez la sélection par pertinence de la décision à savoir si les éléments sélectionnés suffisent pour répondre à l’utilisateur.\n\nMigration d’édition\nLe fabricant décrit rerank-3 comme un successeur de rerank-2.5 compatible sans adaptation, avec la même sémantique d’API et des scores calibrés selon la distribution de son prédécesseur correspondant. Cette compatibilité permet de conserver une étape de récupération et une correspondance d’enregistrements existantes. Comparez des ordres de résultats 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 leurs priorités de qualité et de latence identiques.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "f3ccaf9151a547562f15f3f6a705f3d83425f733cf6e684ba22e4841e37d43d2", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-ca", "methods": [ { "html": "voyageai/rerank-3Voyage rerank-3 est l’édition Rerank 3 axée sur la qualité pour noter la pertinence des paires requête-document. Il reclasse les candidats textuels récupérés, accepte les consignes de pertinence en langage naturel et traite des paires de 32 000 jetons pour la recherche de longs documents, de code et de bases de connaissances.
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. Avec une requête et une liste de documents candidats, il examine conjointement chaque paire et retourne les candidats classés par pertinence. Les plongements et la recherche par mots-clés peuvent d’abord réduire une grande collection à une liste restreinte gérable; rerank-3 applique ensuite une évaluation plus détaillée de la pertinence à cette liste. Sa sortie est un ensemble d’éléments de recherche notés qu’une application peut afficher ou transmettre à 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 celle destinée à la recherche sensible à la latence. La troisième génération met à jour l’architecture de base et le mélange d’entraînement, avec des améliorations particulières de récupération des longs documents et du code source par rapport aux prédécesseurs 2.5 correspondants. Le fournisseur l’évalue sur la documentation technique, le code, le contenu multilingue et d’autres domaines documentaires. Ces résultats appuient son rôle de récupération; choisissez l’édition à partir des questions et des documents candidats qui comptent pour votre collection.
De longs documents avec assez 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 le contenu environnant pertinent, pour que le modèle puisse évaluer le lien entre la question réelle et le contenu. Pour une recherche de politique de produit, conservez les titres et les exceptions autour du passage d’intérêt. Si plusieurs sections récupérées proviennent de la même source, conservez leurs identifiants de document et de section; l’application pourra alors montrer d’où viennent les é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 précise 32 000 jetons pour cette paire, y compris une requête d’au plus 8 000 jetons. Une requête de 3 000 jetons laisse donc au plus 29 000 jetons pour chaque document. Préparez l’entrée pour que son contenu essentiel tienne, surtout lorsqu’un long préambule ou du texte passe-partout répété consommerait autrement la fenêtre. L’option de troncature documentée est activée par défaut et peut raccourcir le texte trop long d’une requête ou d’un document avant la notation. Examinez ce qui est conservé lorsque l’emplacement d’un passage compte.
Récupération de code et de contenu technique Pour l’étape de récupération d’un assistant de code, les candidats peuvent contenir des implémentations de fonctions, de la documentation d’API ou des explications techniques sous forme de texte. Incluez les symboles, les signatures et le contexte nécessaires pour distinguer les candidats semblables. Une requête comme « Trouver la fonction qui normalise les chemins tout en conservant un séparateur de fin » donne un comportement concret à faire correspondre. Joignez toute contrainte pertinente de langue de programmation, 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 courte consigne avant ou après la requête lorsque l’intention de l’utilisateur doit être clarifiée. Pour une recherche documentaire, 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 cohérente avec la question; des préférences supplémentaires qui contredisent la demande principale peuvent changer ce que le classement cherche à optimiser.
Préparer les documents candidats et les budgets L’entrée est une liste de chaînes textuelles. Extrayez du texte utilisable des documents sources, conservez les limites de sections significatives et gardez une table ordonnée de correspondance des enregistrements avec la liste. Le fabricant permet jusqu’à 1 000 documents dans une requête. Il précise aussi un plafond global d’entrée de 600 000 jetons : les jetons de la requête multipliés par le nombre de documents, plus la somme de tous les jetons des documents. Cela diffère de la limite de contexte par paire. Réduire le texte redondant de la requête peut préserver la capacité des paires et le budget total de requête.
Comptez les jetons pour le modèle pertinent, plutôt que de supposer qu’un nombre de mots ou de caractères équivaut à un nombre de jetons. Pour les grands candidats, sélectionnez des passages cohérents ou divisez le contenu selon des titres utiles en conservant l’information de source parente. Le reclassement est surtout utile une fois que la première recherche a déjà fait ressortir 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 des scores de pertinence et des 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 retournés; sinon, tous les candidats d’entrée sont retournés. L’interface REST du fabricant permet aussi d’inclure le texte des documents. Utilisez chaque indice d’origine pour retrouver le titre, l’identifiant de source et les métadonnées nécessaires à votre application, puis présentez les éléments sélectionnés ou regroupez le texte pertinent dans le contexte de preuves d’une réponse.
Examinez les premiers résultats par rapport à la question et gardez l’identité de la source visible. Un rang relatif élevé ne vérifie pas l’exactitude factuelle d’un document, et une liste restreinte composée seulement de mauvais candidats aura toujours un premier élément. Séparez la sélection par pertinence de la décision à savoir si les éléments sélectionnés suffisent pour répondre à l’utilisateur.
Migration d’édition Le fabricant décrit rerank-3 comme un successeur de rerank-2.5 compatible sans adaptation, avec la même sémantique d’API et des scores calibrés selon la distribution de son prédécesseur correspondant. Cette compatibilité permet de conserver une étape de récupération et une correspondance d’enregistrements existantes. Comparez des ordres de résultats 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 leurs priorités de qualité et de latence identiques.
POST /v1/reranktextrerank| 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-3 | 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— |
text_rerank · Obligatoire : query, documents array with minItems1
| 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.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
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 des jetons | Barème tarifaireTarif de base | Unité de facturation— | Coût Entrée · Jetons en entrée — / 1K jetons Sortie · Jetons en sortie — / 1K jetons Entrée · Lecture du cache — / 1K jetons Entrée · Écriture dans le cache — / 1K jetons Entrée · Écriture dans le cache, 1 h — / 1K jetons |
| ConfigurationUltra | Barème tarifaire— | Unité de facturation/ 1K jetons | Coût Entrée $0.0001 / 1K jetons |
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 →
{\n "documents": [\n "Paris is the capital of France.",\n "Berlin is the capital of Germany."\n ],\n "model": "voyageai/rerank-3",\n "query": "What is the capital of France?",\n "top_n": 3\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"\nexport AILOOT_REQUEST_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))\nif not isinstance(p,dict): raise SystemExit('Request must be a JSON object')\np['model']='voyageai/rerank-3'\nPath('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nprint(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))\nPY_RESULT\njson
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Chaque indice de résultat réel, chaque relevance_score fini et l’objet de document d’origine sont conservés. Les indices correspondent au tableau des documents d’origine. Le JSON d’origine complet est stocké et retourné uniquement après le règlement.
Conservez l’opération d’origine et la réponse complète ou partielle; ne rejouez pas la demande POST.
| 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 |
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamp requis, représentation ou valeur invalide | Étape suivanteCorrigez le champ de demande indiqué. |
Ailoot Ultra voyageai/rerank-3
Utilisez les chemins de méthode indiqués ci-dessus.