База знань і центр допомоги

ШІ-асистент і Smart Answer відповідають лише з бази знань проєкту. Що краще її підтримувати, то рідше асистент передаватиме команді.

База знань усіх проєктів є вгорі облікового запису в розділі База знань (/app/kb). Вона для власників і адміністраторів. Сторінка має вкладки Знання й Центр допомоги та показує вгорі кількість сторінок у ШІ, час останнього обходу й наявність помилок.

Що належить до бази знань

• Сторінки сайту — прочитані обходом і доповнені сторінками, які відвідувачі справді відкривають («Побачено наживо»).
• Товари — із шару даних сайту й товарного фіду (вкладка ШІ та знання, «Товари, які знає бот»).
• Файли — PDF, Word, текст, Markdown, CSV та HTML.
• Google Drive — документи, таблиці й презентації.
• Статті центру допомоги — опубліковані статті довідки.
• Поліпшені відповіді — запитання зі збереженою правильною відповіддю.
• Через Інтеграції також вміст Notion або Confluence.

Усе в базі знань асистент може повторити будь-якому відвідувачу. Не додавайте внутрішніх документів, цін для окремих клієнтів або персональних даних.

Читання сайту

На вкладці Знання кожен проєкт має рядок зі станом, останнім обходом, кількістю сторінок і розкладом. Обійти зараз запускає обхід; те саме доступне на сторінці проєкту в ШІ та знання, розділ Обхід, через Запустити зараз. Обхід починається протягом хвилини й триває кілька хвилин. Якщо вже працює один, другий не створюється.

Розклад автоматично повторює обхід: вимкнено (лише на запит, стандартно), щодня або щотижня, від певної години.

Що враховує обхід:

• Читає лише домени, введені в проєкті.
• Дотримується robots.txt сайту та вказаних там карт сайту.
• Читає текст сторінок, шар даних і каталог товарів. Незмінені сторінки не обробляються знову.
• Стандартно читає до 5000 сторінок. Максимальну кількість і дозвіл читати захищене паролем тестове середовище ви задаєте через інтеграцію «KB-Crawler».

Порада: запускайте обхід після значних опублікованих змін сайту. Інакше асистент деякий час відповідає за старими даними.

Закриття розділів

Деякі сторінки чат не має читати ніколи, наприклад клієнтський розділ або внутрішні сторінки. Додайте їх на сторінці проєкту в ШІ та знання, Закриті розділи, один шлях у рядку:

• /account закриває цю сторінку й усе під нею, зокрема з мовним префіксом, як-от /en/account.
• * — шаблонний символ, наприклад /shop/*/reviews.
• За наявності ? порівнюється й рядок запиту адреси.

У закритих розділах чат видимий, але не читає тексту, обхід їх пропускає, асистент ніколи не називає джерелом. Під час збереження вже зібраний вміст цих розділів видаляється. До 60 записів; лише /, тобто весь сайт, не дозволено.

Завантаження файлів

У /app/projects/…/kb/files (Файли та Google Drive) ви завантажуєте PDF, Word (DOCX), текст, Markdown, CSV та HTML. Перевіряється вміст, не лише розширення. Як джерело асистент указує назву файлу.

Кожен файл показує стан: очікує, читається, у базі знань, помилка або видаляється. «Знаходиться лише за словами» означає, що файл уже можна знайти, але точніший пошук ще наздоганяє.

Через Замінити ви завантажуєте нову версію; до її прочитання діє стара. Паролі й ключі в тексті приховуються.

Дозволений розмір файлу, кількість сторінок PDF та файлів проєкту залежать від тарифу. Сама сторінка показує чинні значення й поточне використання.

Підключення Google Drive

Від тарифу Professional можна включати Google Drive. На тій самій сторінці натисніть Підключити через Google (потрібне право керувати інтеграціями), потім додайте вміст через Посилання на папку чи файл та Додати, до 50 записів.

• reactive.chat отримує лише доступ для читання.
• Читає Google Docs, Sheets (лише перший аркуш), Slides, а також PDF, DOCX, текст, Markdown, CSV та HTML.
• Змінені файли читаються регулярно (сторінка показує частоту), видалені зникають із бази знань. Синхронізувати зараз негайно читає знову.
• Відключити видаляє весь вміст Drive із баз знань усіх проєктів робочого простору.

Центр допомоги

На вкладці Центр допомоги (або в /app/help) ви пишете публічні статті довідки. Вони корисні тричі: відвідувачі знаходять їх на вкладці Допомога віджета, вони мають власну публічну сторінку, а асистент відповідає з них.

Стаття має:

• Назву й Адресу (порожня виводиться з назви),
• Мову — німецька, англійська або польська,
• Розділ — групує огляд, достатньо одного слова, як-от «Доставка»; без розділу стаття в «Загальному»,
• Порядок,
• Підсумок — одне-два речення для огляду й результатів пошуку,
• Текст — Markdown: заголовки, жирний, списки, посилання,
• Стан — чернетка або опубліковано.

Лише опубліковані статті потрапляють до бази знань («Так — бот може відповідати з неї.»); чернетки асистент не використовує. Видалення статті прибирає її й з бази знань.

Для публічного доступу до центру допомоги задайте в Публічній адресі назву з малих літер, цифр і дефісів. Статті тоді розташовані в /help/… (німецькою /hilfe/…), читаються без входу й JavaScript, мають пошук. За відсутності мови читача показується інша мовна версія. Вкладка Допомога віджета з’являється, щойно задано адресу й опубліковано хоча б одну статтю.

Статті іншого чату можна перенести через перенесення (див. Інтеграції).

Поліпшені відповіді й прогалини знань

Якщо асистент відповів неправильно або зовсім не відповів, правильна відповідь зберігається в Поліпшених відповідях. Сторінка Прогалини знань збирає відкриті запитання. Обидва описано в розділі ШІ-асистент.

Схвалення обов’язкових правил

Для відомостей, які мають бути правильними, як-от строк повернення, є Перевірка й схвалення знань (/app/projects/…/knowledge-review, у базі знань — «Перевірити схвалення знань»). Для документа ви задаєте:

• Відповідальну особу — хто перевіряє вміст,
• Тему правила та Визначальне значення, наприклад «строк повернення» і «30 днів»,
• Дійсне з та Дійсне до (порожнє — негайно або без обмеження відповідно),
• Схвалення — «На перевірці — виключити з ШІ» або «Схвалити цей вміст».

Асистент використовує такий документ лише зі схваленням та в межах строку дії. За зміни вмісту потрібне нове схвалення. Якщо для тієї самої теми й мови схвалено різні значення на періоди, що перетинаються, сторінка повідомляє конфлікт правил. Розпізнаються лише ці поля, а не будь-які суперечності в суцільному тексті.

Як перевірити надходження знань

• Показники бази знань і Звітів, вкладка «ШІ та знання», показують прочитані документи, очікування, невдалі й застарілі.
• Тестові прогони перевіряють правильність відповідей на типові запитання.
• Журнал ШІ показує джерела кожної відповіді.

Усі три описано в розділі ШІ-асистент.