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

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

Как устроен жизненный цикл

фото товара
→ запись в очередь pending
→ обработка через RouterAI
→ ready или error
→ посетитель загружает фото
→ RouterAI строит эмбеддинг запроса
→ сравнение с ready-записями
→ страница похожих товаров

Настройка

Откройте Intec → Умный поиск → Настройки → Поиск по изображению.

1. Включите поиск по изображению.
2. Укажите ключ RouterAI.
3. Выберите инфоблоки.
4. Выберите источник изображения: детальное или превью.
5. Проверьте порог сходства и лимит.
6. Сохраните.
7. Поставьте изображения в очередь и обработайте её.

Значения по умолчанию:

• порог сходства — 0,4;
• лимит результатов — 20;
• модель — voyageai/voyage-multimodal-3.5;
• размерность эмбеддинга — 1024.

Что означает порог сходства

Порог — минимальное косинусное сходство от 0 до 1.

• выше порог → строже отбор, меньше результатов, выше риск пустой выдачи;
• ниже порог → больше результатов, но возможны слабо похожие результаты.

Не меняйте порог по ощущениям одного фото. Возьмите 10–20 реальных пользовательских примеров и сравните качество.

Очередь изображений

В очереди используются состояния:

• pending — фото ждёт обработки;
• ready — эмбеддинг успешно создан, фото участвует в поиске;
• error — обработка завершилась ошибкой; причина сохраняется отдельно.

Кнопка «Поставить в очередь» сама по себе не делает платный вызов RouterAI. Внешний запрос начинается при обработке пачки/очереди.

Пачка содержит до 10 изображений. Обработку очереди запускайте из административного интерфейса.

Какие данные уходят наружу

Для построения эмбеддинга изображение подготавливается сервером: читается, при необходимости ресайзится/конвертируется и отправляется в RouterAI как изображение/data URI.

Во внешний сервис могут отправляться:

• изображения товаров при построении индекса изображений;
• изображение, которое загрузил посетитель для поиска.

Учитывайте правила обработки данных провайдера и собственную политику сайта. API-ключ не должен попадать в документацию, логи публичной страницы или скриншоты.

Ограничения и расходы

• Нужен действующий ключ RouterAI и достаточный баланс.
• Вызовы внешнего API могут тарифицироваться и иметь лимиты.
• Для подготовки изображений требуется GD.
• Посетительская загрузка валидируется по типу JPEG/PNG/GIF/WebP и ограничена реализацией до 10 МБ.
• Для подготовки каталожного изображения технический обработчик использует собственное ограничение размера и уменьшает длинную сторону примерно до 1024 px.
• GIF/WebP могут конвертироваться перед отправкой.
• При prompt_tokens > 2000 запись защищённо переводится в error.

Что делать после изменения фото

Если изменилось изображение товара, модель/хэш записи должен привести к повторной подготовке соответствующего эмбеддинга. Для массовой смены источника изображения или набора инфоблоков проще заново поставить нужные элементы в очередь и обработать её.

Не запускайте полную текстовую переиндексацию только ради обработки очереди изображений.