GetRouterДокументация
  • Русский

    • Переранжирование

    Используйте переранжирование, чтобы отсортировать документы-кандидаты по релевантности запросу. Обычно этот этап выполняется после поиска по ключевым словам или векторам.

    POST https://getrouter.ai/v1/rerank

    Базовый запрос

    curl https://getrouter.ai/v1/rerank \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "query": "Как аутентифицировать запросы к API?",
    "documents": [
      "Передавайте ключ API как Bearer-токен в заголовке Authorization.",
      "Задачи генерации видео выполняются асинхронно.",
      "Ответ с изображением может содержать URL или данные в формате Base64."
    ],
    "top_n": 2,
    "return_documents": true
  }'

    Ответ содержит ранжированный массив results. Каждый результат указывает индекс исходного документа и содержит оценку релевантности. Если включён параметр return_documents, также может возвращаться содержимое документа.

    Поля запроса

    ПолеОписание
    modelОбязательный идентификатор модели переранжирования
    queryОбязательный текст запроса
    documentsОбязательный массив документов-кандидатов
    top_nМаксимальное количество ранжированных результатов в ответе
    return_documentsВключать содержимое документов в результаты, если это поддерживается

    Схема поиска

    Запрос пользователя
    ↓
Поиск по ключевым словам или векторам
    ↓
Документы-кандидаты
    ↓
POST /v1/rerank
    ↓
Наиболее релевантный контекст
    ↓
Генеративная модель

    Рекомендации

    • Сохраняйте исходный индекс документа, чтобы надёжно сопоставлять результаты.
    • Перед переранжированием ограничивайте набор документов-кандидатов разумным объёмом.
    • Используйте top_n, чтобы ограничить контекст, передаваемый генеративной модели.
    • Оценивайте качество поиска на собственных данных, а не по порогам оценок, скопированным из другой модели.
    • Не сравнивайте необработанные оценки разных моделей переранжирования, если в их документации не указано, что шкалы совместимы.

    Что дальше