Поиск по изображению - Решение KOSMOS

Пользователь загружает фото — модуль ищет похожие товары в каталоге по визуальному сходству (мультимодальные эмбеддинги).

Когда использовать

Функция рассчитана на интернет-магазины с качественными фотографиями товаров. Требует API-ключ RouterAI и модель voyageai/voyage-multimodal-3.5 (размерность 1024).

Настройка

Вкладка «Визуальный поиск»

1. Включите «Поиск по изображению».
2. Укажите ключ RouterAI.
3. При необходимости задайте порог сходства (по умолчанию 0.45) и лимит результатов.
4. Выберите инфоблоки, для которых индексируются эмбеддинги изображений.
5. Задайте источник изображения — детальное или анонс (превью).

Сравнение идёт по векторам эмбеддингов (косинусное сходство).

Как это работает для пользователя

1. В строке поиска (search.title) появляется кнопка загрузки фото (если поиск по изображению включён в модуле и компоненте).
2. Пользователь выбирает файл.
3. Модуль строит эмбеддинг загруженного фото и находит товары с наибольшим косинусным сходством в индексе.

Индексация (вручную)

На вкладке «Поиск по изображению» есть блок «Индексация фото»:

1. Поставить в очередь — добавляет фото товаров выбранных инфоблоков со статусом pending (без вызова RouterAI).
2. Обработать пачку — одна пачка (10 фото) через RouterAI → ready / error.
3. Обработать всю очередь — повторяет пачки, пока есть pending.
4. Очистить индекс — удаляет все записи векторного индекса.

Фонового агента для обработки очереди нет — запускайте обработку вручную кнопками в админке. При изменении товаров в выбранных инфоблоках фото может попасть в очередь автоматически, но до ready дойдёт только после ручной обработки.

Повторный вызов API выполняется только если сменились файл (IMAGE_ID / CONTENT_HASH), модель или размерность.

Полная переиндексация модуля search не нужна для заполнения векторного индекса.

Ограничения

• Нужен действующий API-ключ RouterAI и положительный баланс.
• Качество зависит от фото в каталоге и порога сходства.
• GIF / WebP перед отправкой конвертируются в JPEG; длинная сторона уменьшается примерно до 1024 px.
• Без модуля catalog функция ориентирована на инфоблоки с товарами; торговые предложения сворачиваются к родительскому товару при наличии каталога.
• Если API вернёт аномально много prompt_tokens (>2000), запись помечается error (защита от текстового эмбеддинга data URI). Норма для Voyage по фото — порядка 300–400 токенов.