VoyageAI by MongoDB: rerank-3-lite
Voyage rerank-3-lite оценивает и переупорядочивает текстовые документы-кандидаты по запросу с акцентом на быстрый отклик поиска. Модель поддерживает инструкции о релевантности и окно в 32 000 токенов для пары «запрос — документ», что полезно после векторного или ключевого поиска в поисковых и RAG-процессах.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Voyage rerank-3-lite — редакция серии Rerank 3 от Voyage с приоритетом низкой задержки. Она принимает текстовый запрос и документы-кандидаты, совместно оценивает каждую пару «запрос — документ» и возвращает оценки релевантности в ранжированном порядке. Модель работает на втором этапе поиска: поиск по эмбеддингам или ключевым словам находит кандидатов, а Lite уточняет их порядок. Результат — ранжирование для поиска или процесса генерации с дополнением найденными данными.
Что изменилось в Rerank 3 Lite Разработчик подчёркивает улучшение поиска по длинным документам и коду по сравнению с rerank-2.5-lite. Обе редакции Rerank 3 сохраняют следование инструкциям и один класс контекста 32K, а Lite предназначена для приложений, чувствительных к задержке. Поэтому её стоит рассмотреть для интерактивного поиска по базе знаний, документам поддержки и коду, где пользователям нужны релевантные результаты без долгого ожидания. Выбирайте модель по требованиям реальной коллекции к качеству и времени отклика, не предполагая, что меньшая редакция означает меньшее окно контекста.
Управляйте релевантностью через запрос Вместе с запросом можно передать инструкции на естественном языке, объясняющие, что считать релевантным. Формулируйте вопрос и предпочтения кратко и согласованно. Для поиска по поддержке программного обеспечения можно использовать: «Найди процедуру сброса устройства; отдавай приоритет инструкциям для указанной аппаратной ревизии». Для неоднозначного названия продукта укажите категорию, чтобы посторонние значения не преобладали. Предпочтение в запросе направляет семантическую оценку; для выбора нужного продукта, версии документа или области доступа используйте явные метаданные коллекции до формирования списка кандидатов.
Подготовьте короткий список текстовых кандидатов Входные документы — строки. Извлеките читаемый текст из исходных материалов, сохранив полезные названия, заголовки, идентификаторы и окружающий контекст. Поддерживайте стабильное соответствие каждой входной позиции исходной записи. Для статьи об устранении неполадок включите симптом и нужную процедуру, а не только отдельное предложение. Для поиска по исходному коду включите функцию и соседние сведения, необходимые, чтобы отличить её от функций с похожими именами. Удалите повторяющуюся навигацию или шаблонный текст, если они вытесняют полезный фрагмент.
Реранкер может переупорядочить только полученные документы. Если первый поиск не нашёл нужную статью, этот этап не восстановит отсутствующего кандидата. Когда результат выглядит неверным, изучите и исходный список, и итоговый порядок. Если длинный документ охватывает много тем, разделите его на связные разделы и сохраните ссылки на родительский документ, чтобы выбрать нужный раздел, не теряя его источник.
Контекст и ограничения запроса Текущее руководство разработчика указывает максимум 8000 токенов для запроса и суммарно 32 000 токенов для запроса вместе с каждым отдельным документом. Допускается до 1000 документов-кандидатов и общий бюджет запроса в 600 000 токенов, который рассчитывается как число токенов запроса, умноженное на число документов, плюс все токены документов. Поэтому длинный запрос занимает место в каждой паре и многократно учитывается в общем бюджете. Считайте переданный текст подходящим токенизатором модели, не считая символы, слова и токены взаимозаменяемыми.
Например, запрос на 500 токенов и 100 документов по 4000 токенов каждый дают по этой формуле 450 000 входных токенов. Это иллюстрация расчёта бюджета, а не рекомендуемый размер списка или измеренный результат скорости. Документированная опция усечения включена по умолчанию; слишком длинный текст может сокращаться до оценки. Намеренно подготавливайте важные разделы, чтобы усечение не удалило именно тот фрагмент, который нужно сопоставить.
Читайте и используйте результат Результаты отсортированы по убыванию оценки релевантности. Каждый результат указывает исходную входную позицию документа, позволяя приложению добавить собственное название, идентификатор записи и источник. Настройка 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 токенов для пары «запрос — документ», что полезно после векторного или ключевого поиска в поисковых и 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
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Расчётная единица | Плата |
|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Расчётная единица— | Плата Вход · Входные токены — / 1K токенов Выход · Выходные токены — / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
| КонфигурацияUltra | Шкала ставок— | Расчётная единица/ 1K токенов | Плата Вход $0.00004 / 1K токенов |
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