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 скоро буде доступна.

Усунення несправностей

Посібник з усунення несправностей скоро буде доступний.