AI
AI Search

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

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

Обзор модуля

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

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

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

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

Версия SaaS

  • OpenCart 4.0 или выше
  • PHP 8.0 или выше
  • MySQL 5.7+ или MariaDB 10.3+
  • 50МБ свободного места
  • Интернет-соединение (для API-запросов)

Self-hosted версия

Все требования версии SaaS, плюс:

  • VPS/выделенный сервер (минимум 2 CPU, 4ГБ RAM)
  • Docker и Docker Compose
  • 10ГБ свободного места (для моделей Ollama)
  • Рекомендуется GPU (CUDA или ROCm)

Архитектура

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

Таблица 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

API

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

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

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