AI
AI Search

Документация

Полное руководство по установке и настройке AI Search

Обзор модуля

AI Search для OpenCart — это расширение, которое заменяет стандартный поиск магазина семантическим AI-поиском. Модуль использует векторные embeddings для понимания контекста запроса и поиска релевантных товаров.

Ключевые возможности

  • Семантический поиск (понимает контекст, а не только ключевые слова)
  • Автоматическое исправление опечаток и нечёткий поиск
  • Поддержка синонимов без дополнительных словарей
  • Поиск по атрибутам товаров, фильтрам и опциям
  • Автодополнение запросов (тарифы Business+)
  • Смешанные результаты: товары, категории, страницы
  • Резервный переход на стандартный поиск при сбоях
  • Автоматическая переиндексация при изменениях товаров

Системные требования

Версия SaaS (рекомендуется)

  • OpenCart 3.0.x или 4.0.x (один ZIP, dual-build)
  • PHP 8.0 или выше, расширения cURL и JSON
  • MySQL 5.7+ или MariaDB 10.3+
  • ~20 МБ под файлы модуля + индекс эмбеддингов на стороне магазина
  • HTTPS-соединение с api.ai-search.cc (порт 443)

Self-hosted (только Enterprise)

Доступно на тарифе Enterprise. Все требования SaaS, плюс:

  • Выделенный сервер с NVIDIA GPU — обязательно (≥8 ГБ VRAM: RTX 3060 / T4 / A10 или мощнее)
  • CUDA 12+, 16 ГБ RAM, Linux (Ubuntu 22.04 или Debian 12)
  • ~10 ГБ под модель multilingual-e5-large-instruct и индекс эмбеддингов
  • Установку и сопровождение выполняет наша команда — свяжитесь с продажами

Архитектура

Векторный индекс

Таблица oc_ai_embeddings хранит векторные представления товаров, категорий и страниц.

  • › Модель: multilingual-e5-large-instruct (1024d)
  • › Поиск: Косинусное сходство в PHP
  • › Кеш: файловый (OpenCart Cache)

Триграммный индекс

Таблица oc_ai_trigrams для нечёткого автодополнения.

  • › Метод: 3-символьные токены
  • › Переранжирование: через levenshtein()
  • › Скорость: <20мс

Установка

  1. 1
    Скачать — перейдите в Dashboard → Downloads и скачайте aisearch.ocmod.zip.
  2. 2
    Загрузить в OpenCart — в админке OpenCart перейдите в Extensions → Installer, нажмите Upload и выберите ZIP-файл.
  3. 3
    Активировать — перейдите в Extensions → Extensions → Modules, найдите AI Search и нажмите Install, затем Edit.
  4. 4
    Введите лицензионный ключ — вставьте ваш ключ из dashboard в поле License Key и сохраните.
  5. 5
    Проиндексируйте товары — откройте вкладку Indexer и нажмите Start Indexing. Готово.

Настройка

Вкладка General управляет основным поведением: режимом, соединением с API, моделью embedding и параметрами поиска.

AI Search — General settings tab

Режим

SaaS — использует наш cloud API (сервер не нужен, требуется лицензионный ключ). Self-hosted — запускает Ollama на вашем VPS.

Модель Embedding

Выберите из таблицы: multilingual-e5-large-instruct (лучшее качество, 100+ языков), nomic-embed-text-v1.5 (самая быстрая, только английский) и другие. Смена модели требует переиндексации.

Минимальная длина запроса

Минимальное количество символов перед активацией AI-поиска. Рекомендуется: 3.

Резервный LIKE-поиск

Если AI-поиск недоступен, автоматически переходит к стандартному LIKE-поиску OpenCart. Держите включённым.

Индексация

Вкладка Indexer позволяет контролировать, какой контент индексируется и как. Выбирайте поля внимательно — больше данных улучшает точность, но ненужные технические поля добавляют шум.

AI Search — Indexer settings: What to Index

Используйте Field Order (перетащите для изменения порядка), чтобы определить приоритет включения — если общий текст превышает токен-лимит модели, поля с более низким приоритетом отбрасываются. Используйте Re-index (Farm Queue) для больших каталогов, чтобы перенести генерацию embeddings на GPU-ферму.

AI Search — Field Order and Farm Queue

После индексации переключитесь на вкладку Index, чтобы проверить, все ли товары проиндексированы. Вы можете фильтровать по обрезанным элементам, чтобы проверить, не были ли обрезаны описания.

AI Search — Index tab showing indexed products list

Настройка фасетных фильтров

Новое в v1.0.5

AI Search v1.0.5 добавляет AJAX-фасетные фильтры, работающие непосредственно на странице результатов поиска (/search), а не только на страницах категорий. Опции ранжируются по AI-релевантности к запросу, а не алфавитно. Панель фильтров автоматически рендерится без правок темы через события OpenCart.

Вкладка AI Search Filters — General settings (orientation, AJAX mode)

Настройки разделены на 5 под-вкладок в Расширения → AI Search → Filters:

General

Включить/выключить модуль, задать заголовок (для каждого языка), выбрать ориентацию (Vertical sidebar в column_left или Horizontal chip-bar в content_top), и включить AJAX-режим для изменения фильтров без перезагрузки страницы (fallback к обычным ссылкам когда JS выключен).

Filters to show

Выберите, какие группы фильтров показывать: Цена (range slider с min/max), Наличие (в наличии / нет), Категории, Бренды (со встроенным поиском для длинных списков), Атрибуты, Опции. Каждая группа включается независимо.

Behavior

Настройки exclude-self для групп (выбор одного бренда показывает счётчики других брендов), счётчики товаров рядом с каждой опцией, AI-ранжирование опций (по семантической близости к запросу — эксклюзивно в v1.0.5), и сворачиваемые группы.

Design

Кастомизация мобильной floating-кнопки (FAB): позиция (слева/справа снизу), боковой и вертикальный отступ, форма (rectangle/pill/circle), радиус углов, цвет фона и текста. Live-preview iPhone обновляется при настройке. Цвета панели — для desktop sidebar.

Advanced

Debug-режим (логирование filter-запросов в storage/logs), TTL кэша для агрегатов фильтров (по умолчанию 600с), формат URL (CSV: ai_f[category]=1,2,3).

Вкладка AI Search Filters — Design с live-preview iPhone мобильной FAB

Позиция управляется настройкой Orientation во вкладке General — выбирайте Vertical (sidebar в column_left) или Horizontal (chip-bar в content_top). Модуль автоматически инжектится через события OpenCart, ручные правки layouts не нужны.

API

Документация API скоро будет доступна.

Устранение неполадок

Руководство по устранению неполадок скоро будет доступно.