Semantic Search для FreeScout
Semantic Search є окремим модулем FreeScout, який виправляє пошук за кількома словами й, щойно ви додасте власний ключ ШІ, знаходить розмови за їхнім змістом. Його продають творці ReplyRabbit, але він не потребує встановленого ReplyRabbit.
Шукаєте огляд?
Огляд
Вбудований пошук FreeScout шукає весь ваш запит як одну фразу в одному полі. Пошук на кшталт frank invoice не знаходить нічого, бо ім'я клієнта в одному місці, а слово "invoice" в іншому. Semantic Search замінює цю поведінку у два етапи:
- Режим ключових слів (ключ не потрібен): кожне слово у вашому пошуку має з'явитися десь у розмові. Тема, ім'я клієнта, електронна адреса та текст повідомлення враховуються. Це вмикається одразу після активації модуля.
- Пошук за змістом (ваш власний AI-ключ): кожна розмова отримує компактний відбиток того, про що вона, що зберігається у вашій базі даних FreeScout. Пошук зіставляється за змістом і за ключовими словами, а два списки змішуються так, щоб найкраща відповідь була першою. Цей режим також забезпечує роботу Схожі розмови панель на бічній панелі розмови.
Сторінка пошуку показує невеликий Семантичний або Ключове слово мітка поруч із кількістю результатів, щоб агенти знали, який режим відповів.
Синтаксис пошуку
Звичайні скорочення пошукових систем працюють в обох режимах:
| Ви вводите | Що він робить |
|---|---|
frank invoice | Обидва слова мають з'явитися десь у розмові. |
"out of stock" | Точна фраза має з'явитися. |
-refund або -"out of stock" | Розмови, що містять слово або фразу, виключаються. |
cart OR basket | Достатньо будь-якого слова. OR має бути великими літерами. |
admin@example.com або example.com | Адреса електронної пошти або домен збігається точно. |
Пошук за змістом додає лише розмови, які явно стосуються того самого, що й введені вами слова. Цитати в лапках, адреси та -exclusions усе одно застосовуються до цих результатів, тож пошук за електронною адресою ніколи не заповнюється не пов'язаними розмовами.
Рядок пошуку та фільтри
На сторінці результатів пошуку поле пошуку розташоване прямо біля Розмови і Клієнти вкладки, тож ви можете змінити пошук, не прокручуючи назад до початку. Спадне меню сортування розташоване праворуч від Клієнти вкладка.

Натисніть кнопку повзунків поруч із полем пошуку, щоб відкрити Фільтри панель. Вам не потрібно запам'ятовувати скорочення вище: чотири правила зі словами вписують його в поле пошуку за вас.
| Фільтр | Що він пише | Що він робить |
|---|---|---|
| Усі ці слова | frank invoice | Кожне слово має з'явитися. |
| Ця точна фраза | "out of stock" | Слова мають з'являтися разом, у цьому порядку. |
| Будь-яке з цих слів | cart OR basket | Достатньо одного зі слів. |
| Жодне з цих слів | -refund | Розмови зі словом виключаються. |

Стандартні фільтри FreeScout (поштова скринька, статус, призначено, клієнт, дати та інше) розташовані в Розширені розділ у нижній частині панелі. Він згорнутий, щоб панель залишалася короткою, і розгортається сам, коли один із цих фільтрів уже використовується. Маленьке число на кнопці повзунків показує, скільки фільтрів активні. Натисніть Застосувати щоб запустити пошук, або Очистити все щоб почати знову.

Починаючи з 1.1.3, Клієнти вкладка також розглядає кожне слово окремо. Якщо жоден клієнт не збігається з усіма словами, вона показує клієнтів, які збігаються з будь-яким із них, спочатку найближчі збіги, щоб invoice frank усе одно знаходить клієнта на ім'я Frank.
Передумови
Перед початком переконайтеся, що у вас є:
- FreeScout 1.8.101 або новіший на PHP 8.1 або пізнішій версії.
- Робочий воркер черги та планувальник FreeScout (
php artisan queue:workіschedule:runcron). Індексація виконується на них. - Ліцензія Semantic Search від вашого Обліковий запис ReplyRabbit. Лист про покупку містить ліцензійний ключ.
- Необов'язково, для пошуку за змістом: API-ключ від OpenAI або Google Gemini, або базова URL-адреса та назва моделі вбудовувань сумісного сервісу, як-от OpenRouter, Ollama чи LM Studio.
Встановіть модуль
Завантажити ZIP
Увійдіть на app.replyrabbit.app з адресою електронної пошти, яку ви використали під час оформлення замовлення, і відкрийте Semantic Search картку на панелі. Завантажтеsemantic-search.zip.Скопіюйте його до папки Modules
Розпакуватиsemantic-search.zipі скопіюйтеSemanticSearchтеку вModulesкаталог вашої інсталяції FreeScout, через SFTP або файловий менеджер вашого хоста, поруч з іншими модулями. FreeScout не має вбудованого завантаження для сторонніх модулів.Активуйте модуль
Активувати Semantic Search зі списку Modules. Активація запускає міграції бази даних, які створюють дві таблиці індексів.Спробувати пошук
Шукайте ім'я клієнта разом із темою, наприклад ім'я та "рахунок". Результати тепер збігаються з кожним словом, де б воно не з'являлося в розмові, а сторінка пошуку показує Ключове слово мітка.
Режим ключових слів працює на цьому етапі без додаткового налаштування. Кроки нижче відкривають пошук за змістом і панель схожих розмов.
Введіть ліцензійний ключ
Відкрийте сторінку налаштувань
У FreeScout перейдіть до Керувати, потім Налаштування, потім Semantic Search.Вставте ключ ліцензії
У Ліцензія розділ, вставте ключ з вашого листа про покупку та збережіть. Статус показує Ліцензовано з часом останньої перевірки.
Ліцензія прив'язана до URL-адреси сайту встановлення FreeScout. Якщо ви переносите FreeScout на новий домен, зв'яжіться з hey@replyrabbit.app і ми його скинемо.
Налаштуйте пошук за змістом
Вибрати провайдера
У Провайдер вбудовувань розділ, виберіть OpenAI, Google, або Сумісний з OpenAI. Модель за замовчуванням заповнюється для OpenAI і Google. Для сумісного сервісу введіть базовий URL і назву моделі, яку він очікує.Додайте ключ і перевірте його
Вставте API-ключ, якщо ваш постачальник його потребує, потім натисніть Перевірити вбудовування. Тест надсилає одне коротке речення до ендпоінту вбудовування та перевіряє його відповідь. Ключі зберігаються зашифрованими, і після збереження показується лише замаскований попередній перегляд.Виберіть поштові скриньки для індексації
У Індексація розділ, позначте поштові скриньки для включення. Включати внутрішні нотатки увімкнено за замовчуванням, оскільки агенти часто шукають у власних нотатках. Встановіть Дні заповнення наскільки далеко назад індексувати (типово 365 днів).Увімкніть пошук за значенням
Позначити Пошук за змістом і збережіть. Якщо провайдер, модель або базова URL-адреса змінилися, сторінка повідомить, що розмови буде переіндексовано у фоновому режимі.Запустіть першу індексацію
Натисніть Індексувати зараз. Блок стану показує прогрес, як-от "Indexed 1,240 of 8,900 (14%)", час останнього запуску, останню помилку, якщо вона є, і орієнтовну залишкову вартість. Індексація виконується пакетами приблизно по 200 розмов кожні п'ять хвилин, тож велика служба підтримки потребує кількох годин. Пошук працює весь цей час.
Який постачальник?
Використовуйте власний ендпоінт вбудовування
Введіть базову URL-адресу API, наприклад https://embeddings.example.com/v1 або http://10.0.0.25:8001/v1, а потім точний ID моделі вбудовування, що обслуговується там. Semantic Search додає /embeddings до базової URL-адреси. Публічні адреси вимагають HTTPS. Приватна або loopback HTTP-адреса має бути в довіреній мережі, до якої може дістатися FreeScout.
Якщо шлюз обслуговує і чат, і вбудовування, ви можете ввести той самий /v1 базову URL-адресу тут і в Налаштування власного постачальника ReplyRabbit. Налаштуйте модель вбудовування тут, а модель чату в ReplyRabbit. Якщо ваші сервери чату та вбудовування мають окремі URL, введіть кожен URL у власному продукті. Продукти не спільно використовують токени чи налаштування.
The Перевірити вбудовування дія має повертати вектор вбудовування. Чат-модель, яка лише відповідає /chat/completions не може забезпечити пошук за змістом. Зміна кінцевої точки або моделі запускає новий профіль індексу; зміна лише токена зберігає наявні вектори.


Підтримка в актуальному стані
Коли випускається нова версія, FreeScout показує її на Керувати, потім Модулі, і Оновити зараз встановлює його на місці: без SFTP, без повторного завантаження. ZIP, який ви завантажили зі своєї панелі, містить посилання для завантаження вашої власної ліцензії, тож оновлення отримується за тією самою перевіркою ліцензії, що й перше завантаження.
Дві речі, які варто знати:
- Оновлення працює лише для копії, завантаженої з вашої панелі керування, і вам не слід передавати свою копію: її посилання на оновлення містить ключ завантаження вашої власної ліцензії, тож будь-хто з ZIP-файлом міг би отримувати оновлення за вашою ліцензією. Копія від когось іншого прив'язана до його ліцензії й оновлюється за його ключем.
- Якщо FreeScout повідомляє про помилку завантаження, завантажте новий ZIP зі своєї панелі керування та замініть папку вручну, як у кроках встановлення вище. Ваш index і налаштування зберігаються: вони живуть у базі даних, а не в папці модуля.
Вартість
Індексація надсилає текст кожної розмови вашому провайдеру один раз, а також знову, якщо розмова отримує нову відповідь. Пошук надсилає лише пошукові слова.
| Постачальник | Модель | Ціна | Близько 100 розмов |
|---|---|---|---|
| OpenAI | text-embedding-3-small | 0.02 USD за мільйон токенів | приблизно 0.01 USD |
| Google Gemini | gemini-embedding-001 | безкоштовний рівень, потім ціноутворення за токен | зазвичай безкоштовно |
| Ollama або LM Studio | будь-яка модель вбудовувань | немає | немає |
Сторінка налаштувань показує оцінку для розмов, які ще очікують індексації, тож ви можете перевірити число перед натисканням Індексувати зараз. Повторна індексація відбувається лише тоді, коли ви змінюєте провайдера чи модель або натискаєте Переіндексувати все.
Панель схожих розмов
Коли пошук за змістом увімкнено, Схожі розмови панель з'являється на бічній панелі розмови. Вона перелічує інші розмови в тій самій поштовій скриньці, які стосуються того самого, із темою, ім'ям клієнта та датою. Агенти бачать лише ті розмови, до яких вони вже мають доступ.
Вимкніть панель для всіх за допомогою Схожі розмови перемикач на сторінці налаштувань. Нова розмова показує "Nothing similar yet", доки її не буде проіндексовано, що займає кілька хвилин.

Командний рядок
Дві команди допомагають, коли ви керуєте FreeScout через SSH:
php artisan semanticsearch:status
php artisan semanticsearch:reindex --limit=2000status виводить ті самі числа покриття, що й сторінка налаштувань. reindex запускає пакет одразу, не чекаючи планувальника, що корисно для першого індексу на великому столі.
Усунення несправностей
| Симптом | Що перевірити |
|---|---|
| Сторінка пошуку показує Ключове слово замість Семантичний | Підтвердити Пошук за змістом позначено, статус ліцензії Ліцензовано, і блок стану не показує нещодавньої помилки. Якщо ключ не спрацював, пошук переходить у режим ключових слів, доки його не виправлять. |
| На сторінці пошуку не відображається жодна мітка | Пошук було передано власному пошуку FreeScout. Це відбувається для запитів, що складаються лише з числа (номери тікетів або замовлень), з якими ядро вже добре справляється. |
| Перевірити вбудовування не вдається | Переконайтеся, що ключ не має пробілів на початку чи в кінці й належить правильному провайдеру. Для сумісного сервісу підтвердьте, що базова URL-адреса доступна із сервера FreeScout, а назва моделі вбудовувань точно відповідає очікуванням сервісу. |
| Статус показує "Ще нічого не проіндексовано" | Переконайтеся, що воркер черги та cron планувальника запущені. Натисніть Індексувати зараз і оновіть через хвилину. На спільному хостингу перша партія може запускатися кілька хвилин. |
| Індексація зупиняється на півдорозі | Прочитайте останню помилку в блоці статусу. Зазвичай причиною є обмеження швидкості та помилки квоти від постачальника; індексація відновиться під час наступного запланованого запуску. |
| Результати пошуку повільні на дуже великій службі підтримки | Режим ключових слів перевіряє кожне пошукове слово щодо тексту повідомлення, що важче, ніж зіставлення однієї фрази в ядрі. Обмежуйте пошук кількома словами або зменшуйте кількість поштових скриньок, включених до індексації. |
| Панель схожих розмов порожня | Розмову ще не проіндексовано, або панель вимкнена в налаштуваннях. Нові розмови індексуються протягом кількох хвилин. |
Конфіденційність і обробка даних
Пошук за ключовими словами повністю виконується у вашій базі даних FreeScout і нічого нікуди не надсилає. Коли ввімкнено пошук за змістом, текст кожної проіндексованої розмови (тема, повідомлення клієнта, відповіді агента та внутрішні нотатки, якщо включено) надсилається налаштованому вами провайдеру. Публічна кінцева точка використовує HTTPS; приватна HTTP-кінцева точка залишається в мережі, яку ви налаштували. Ключ необов'язковий для сумісної кінцевої точки. Зберігається лише повернутий відбиток.
Єдиний контакт із replyrabbit.app це перевірка ліцензії, яка надсилає ліцензійний ключ, URL-адресу сайту FreeScout і версію модуля. Жоден текст розмови, пошукові слова чи дані клієнтів нам не надсилаються.
Якщо текст розмови має залишатися на ваших власних серверах, використовуйте локального провайдера або сумісну кінцеву точку у вашій довіреній приватній мережі, або залишайтеся в режимі ключових слів. Із сумісною публічною кінцевою точкою текст передається через HTTPS. Приватні HTTP-кінцеві точки дозволені лише в довіреній мережі.
Часті запитання
Чи потрібен мені ReplyRabbit для використання Semantic Search?
Ні. Semantic Search це окремий модуль FreeScout від тих самих розробників. Він встановлюється та працює самостійно. ReplyRabbit це лише місце, де ви його купуєте, завантажуєте та керуєте ліцензійним ключем.
Чи працює Semantic Search без ключа ШІ?
Так. Режим ключових слів працює з моменту активації модуля, без ключа й без налаштувань. Кожне слово з вашого запиту має десь з'явитися в розмові: у темі, імені клієнта, адресі електронної пошти або тексті повідомлення. Ключ AI лише додає пошук за змістом і панель схожих розмов.
Яких постачальників ШІ я можу використовувати?
OpenAI (text-embedding-3-small за замовчуванням), Google Gemini (gemini-embedding-001 за замовчуванням) або будь-який сумісний з OpenAI сервіс, як-от OpenRouter, Ollama чи LM Studio, де ви самі вводите базову URL-адресу та модель. Z.AI не підтримується, оскільки не має сервісу вбудовувань.
Скільки коштує ключ ШІ?
З OpenAI text-embedding-3-small за 0.02 USD за мільйон токенів індексація близько 100 розмов коштує приблизно 0.01 USD. Служба підтримки з 10 000 розмов платить близько 1 USD, щоб проіндексувати все один раз, а потім кілька центів на місяць за нову пошту. Сторінка налаштувань показує оцінку перед запуском першої індексації.
Де зберігаються дані пошуку?
У двох таблицях у вашій наявній базі даних FreeScout. Кожна проіндексована розмова додає близько пів кілобайта. Окремий сервер пошуку не потрібен, і нічого не зберігається на replyrabbit.app.
Чи працює він на PostgreSQL?
Так. Пошук за ключовими словами й пошук за змістом обидва працюють на MySQL, MariaDB і PostgreSQL.
Що станеться, якщо мій ключ перестане працювати або ліцензія закінчиться?
Пошук самостійно повертається до режиму ключових слів, щоб агенти продовжували отримувати результати. Сторінка налаштувань показує причину. Пошук за ключовими словами ніколи не залежить від ліцензії чи ключа.