Потеряна ссылка на источник
Храните исходный ID и URL отдельно от позиции в отсортированном массиве.
Планируется
Rerank: повторная оценка найденных документов
Как подготовить список кандидатов, сохранить их ID и оценить качество ранжирования до открытия публичного Rerank API.
API Токенмоста работает
Базовый адрес — https://tokenmost.ru/v1. Создайте ключ в личном кабинете, выберите модель в каталоге и отправьте первый запрос. Методы, которые ещё не доступны, отмечены отдельно.
Как это устроено
Публичный Rerank API пока не открыт. Ранжирование должно получать вопрос и ограниченный список уже найденных документов, возвращая порядок с привязкой к исходным ID. Оно не заменяет первичный поиск и не подтверждает истинность источника.
Что потребуется
- Первичный поиск, который выдаёт кандидатов с устойчивыми ID.
- Контрольные вопросы с отмеченными релевантными документами.
- Предел числа и размера кандидатов и проверка прав доступа.
Порядок работы
- Найдите ограниченный набор кандидатов в собственном индексе.
- Отфильтруйте недоступные пользователю документы до ранжирования.
- Сохраните исходный ID, заголовок и короткий фрагмент каждого кандидата.
- После открытия API передавайте вопрос и кандидатов по подтверждённому контракту.
- Сравните новую сортировку с контрольной разметкой и верните пользователю исходные ссылки.
Готовая конфигурация
Список кандидатов — структура вашего приложения
{
"query": "Как пополнить баланс?",
"candidates": [
{
"id": "billing-1",
"excerpt": "Инструкция по оплате",
"sourceUrl": "/docs/billing"
}
]
}Что учесть
До открытия Rerank API используйте свой поиск и ручное сравнение кандидатов. Не представляйте техническую форму в песочнице как действующий публичный маршрут.
Ожидаемый результат
Лучшие кандидаты сохраняют исходные ID и ссылки; приложение может объяснить, почему фрагмент показан пользователю.
Ограничение сейчас
Не вызывайте закрытый /v1/rerank с публичным ключом. Структура примера — локальный список, а не опубликованный контракт метода.
Расходы
Будущая цена rerank не опубликована. Ограничьте число кандидатов, чтобы не создавать неожиданный объём обработки.
Ошибки и диагностика
Качество ниже первичного поиска
Проверьте тексты кандидатов и контрольные вопросы, а не только балл модели.
Чужой фрагмент в выдаче
Фильтруйте права доступа до ранжирования и после него.
Публичный метод не отвечает
Этот маршрут ещё не открыт для внешних ключей. Не повторяйте платные запросы вслепую; проверьте /docs/api-reference.
Стоимость неизвестна
Не считайте технический маршрут готовым тарифом. Дождитесь опубликованной цены и проверьте баланс до первого запроса.