VoyageAI by MongoDB: rerank-3

Voyage rerank-3 — сұрау-құжат өзектілігін бағалауға арналған, сапаға бағытталған Rerank 3 шығарылымы. Ол табылған мәтіндік үміткерлерді қайта реттейді, табиғи тілдегі өзектілік нұсқауларын қолдайды және ұзын құжат, код пен білім базасы іздеуі үшін 32,000 токендік жұптарды өңдейді.

Ailoot Ultra · Қайта реттеу POST /v1/rerank voyageai/rerank-3

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

Voyage rerank-3 — табылған дәлелдердің сапасын арттыруға арналған мәтіндік қайта реттеуші. Сұрау мен үміткер құжаттар тізімі берілгенде, ол әр жұпты бірге зерттеп, үміткерлерді өзектілігі бойынша реттеп қайтарады. Эмбеддингтер мен кілтсөз іздеуі алдымен үлкен жинақты басқаруға ыңғайлы қысқа тізімге тарылта алады; содан кейін rerank-3 сол тізімге егжей-тегжейлі өзектілік бағасын қолданады. Оның шығысы — қолданба көрсетуге немесе бөлек жауап генерациялау кезеңіне беруге арналған ұпайланған іздеу дәлелдері.

Сапаға бағытталған Rerank 3 Өндіруші rerank-3 нұсқасын дәлдікке, ал rerank-3-lite нұсқасын кідіріске сезімтал іздеуге бағытталған шығарылым ретінде ұсынады. Үшінші буын негізгі құрылымды және жаттықтыру қоспасын жаңартады; тиісті 2.5 алдыңғы нұсқаларымен салыстырғанда ұзын құжат пен бастапқы код іздеуінде ерекше жақсартулар бар. Өндіруші оны техникалық құжаттама, код, көптілді материал және басқа құжат салалары бойынша бағалайды. Бұл нәтижелер оның іздеудегі рөлін негіздейді; шығарылымды өз жинағыңызға маңызды сұрақтар мен үміткер құжаттар арқылы таңдаңыз.

Жеткілікті контексті бар ұзын құжаттар Ұзын үміткердің алғашқы абзацынан әлдеқайда кейін пайдалы контекст болуы мүмкін. Модель нақты сұрақтың мазмұнға қатысын бағалауы үшін атауы және тиісті айналасындағы материалы бар тұтас бөлімді не құжатты беріңіз. Өнім саясатын іздегенде қажетті үзінді маңындағы тақырыптар мен ерекшеліктерді сақтаңыз. Бірнеше табылған бөлім бір дереккөзден келсе, олардың құжат және бөлім идентификаторларын сақтаңыз; сонда қолданба таңдалған дәлелдің қайдан шыққанын көрсете алады.

Контекст терезесін сұрау мен әр үміткер ортақ пайдаланады. Өндірушінің ағымдағы нұсқаулығы сұрауы ең көбі 8,000 токен болатын сол жұпқа 32,000 токен белгілейді. Сондықтан 3,000 токендік сұрау әр құжатқа ең көбі 29,000 токен қалдырады. Әсіресе ұзақ кіріспе не қайталанатын үлгілік мәтін терезені толтырып кететін жағдайда маңызды мазмұн сыятындай кіріс дайындаңыз. Құжатталған қысқарту параметрі әдепкіде қосылған және артық сұрау не құжат мәтінін бағалауға дейін қысқарта алады. Үзінді орны маңызды болса, ненің сақталғанын тексеріңіз.

Код және техникалық ақпарат іздеу Код көмекшісінің іздеу кезеңінде үміткерлер мәтін түріндегі функция іске асыруларын, API құжаттамасын немесе техникалық түсіндірмелерді қамти алады. Ұқсас үміткерлерді ажыратуға қажет таңбаларды, сигнатураларды және контексті қосыңыз. «Соңғы бөлгішті сақтай отырып жолдарды қалыптандыратын функцияны табыңыз» сияқты сұрау сәйкестендіруге нақты мінез-құлық береді. Тиісті тіл, платформа немесе нұсқа шарттарын қосыңыз. Реттегеннен кейін таңдалған код пен оның тәуелділіктерін контекстке қоспас бұрын тексеріңіз; өзектілік ұпайы іске асырудың әр берілген талапқа сай екенін дәлелдемейді.

Нұсқаулар өзектілікті анықтайды Модель Rerank 2.5-те енгізілген нұсқау орындайтын қайта реттеу мүмкіндігін сақтайды. Пайдаланушы ниетін нақтылау қажет болса, сұраудың алдына не соңына ықшам нұсқау қосыңыз. Зерттеу құжаттарын іздегенде негізгі назар атауға, белгілі бір әдіске немесе қолдану саласына бағытталғанын түсіндіріңіз. Ішкі каталог үшін сұраудың орнатуға, ақау жоюға немесе үйлесімділікке қатысты екенін айтыңыз. Нұсқауды сұрақпен сәйкестендіріңіз; негізгі сұрауға қайшы қосымша қалаулар рейтинг нені оңтайландыруға тырысатынын өзгерте алады.

Үміткер құжаттар мен бюджеттерді дайындаңыз Кіріс — мәтіндік жолдар тізімі. Бастапқы құжаттардан жарамды мәтін шығарып, мағыналы бөлім шекараларын сақтаңыз және тізіммен бірге реттелген жазба сәйкестігін ұстаңыз. Өндіруші бір сұрауға 1,000-ға дейін құжатқа рұқсат береді. Сондай-ақ ол жиынтық кіріс шегін 600,000 токен деп белгілейді: сұрау токендері × құжаттар саны + барлық құжат токендерінің қосындысы. Бұл әр жұптың контекст шегінен өзгеше. Артық сұрау мәтінін азайту жұп сыйымдылығын да, жалпы сұрау бюджетін де сақтай алады.

Сөз не таңба санын токен саны деп жорамалдамай, тиісті модель үшін токендерді санаңыз. Үлкен үміткерлер үшін тұтас үзінділерді таңдаңыз немесе негізгі дереккөз ақпаратын сақтап, материалды пайдалы тақырыптар бойынша бөліңіз. Қайта реттеу алғашқы іздеу нанымды үміткерлерді тапқаннан кейін барынша пайдалы: тізімге мүлде кірмеген дереккөзді ол реттей алмайды.

Реттелген нәтижелер және кейінгі пайдалану Нәтижеде бастапқы кіріс құжаттарға сілтейтін индекстер мен өзектілік ұпайлары болады; олар өзектілік бойынша кему ретімен сұрыпталады. top_k параметрі қайтарылатын реттелген нәтижелер санын шектейді; әйтпесе барлық кіріс үміткерлер қайтарылады. Өндірушінің REST интерфейсі құжат мәтінін де қоса алады. Әр бастапқы индекспен атауды, дереккөз идентификаторын және қолданбаға қажет метадеректерді тауып, таңдалған элементтерді көрсетіңіз немесе тиісті мәтінді жауап дәлелдерінің контекстіне жинаңыз.

Жоғарғы нәтижелерді сұрақпен салыстырып, дереккөз сәйкестігін көрінетін күйде сақтаңыз. Салыстырмалы жоғары орын құжаттың фактологиялық дұрыстығын тексермейді; тек нашар үміткерлерден тұратын қысқа тізімде де бірінші элемент болады. Өзектілікті таңдауды таңдалған дәлелдің пайдаланушыға жауап беруге жеткілікті екенін шешуден ажыратыңыз.

Шығарылымдар арасында көшу Өндіруші rerank-3 нұсқасын API семантикасы бірдей және ұпайлары тиісті алдыңғы нұсқасының таралуына калибрленген, rerank-2.5 орнына тікелей қолданылатын ізбасар ретінде сипаттайды. Бұл үйлесімділік бар іздеу кезеңі мен жазба сәйкестігін сақтауды қолдайды. Көшуге сенбес бұрын ағымдағы корпуста мағыналы нәтиже реттерін және кез келген ұпай шегін салыстырыңыз. rerank-3 пен rerank-3-lite нұсқаларын бөлек таңдаулар ретінде сақтаңыз: ортақ шектер мен нұсқау орындау олардың сапа және кідіріс басымдықтарын бірдей етпейді.

Ailoot Ultra · Қайта реттеу POST /v1/rerank voyageai/rerank-3

voyageai/rerank-3

VoyageAI by MongoDB /voyageai/rerank-3

Бастау

Қабылданатын кіріс деректері: Мәтін
Нәтижелер: Реттелген нәтижелер

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 режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Ailoot мөлшерлемелері

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Есептеу бірлігі	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Есептеу бірлігі—	Төлем Кіріс · Кіріс токендері — / 1K токен Шығыс · Шығыс токендері — / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен
БаптауUltra	Мөлшерлемелер кестесі—	Есептеу бірлігі/ 1K токен	Төлем Кіріс $0.0001 / 1K токен

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

voyageai/rerank-3

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

VoyageAI by MongoDB: rerank-3