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), а не лише на сторінках категорій. Опції ранжуються за ШІ-релевантністю до запиту, а не алфавітно. Панель фільтрів автоматично рендериться без правок теми через події 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 для груп (вибір одного бренду показує лічильники інших брендів), лічильники товарів біля кожної опції, ШІ-ранжування опцій (за семантичною близькістю до запиту — ексклюзивно у 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 скоро буде доступна.

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

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