Усунення несправностей ReplyRabbit
Більшість проблем ReplyRabbit зводяться до одного з трьох: відсутній або неправильний ключ API, використання постачальника, який не дозволений вашим рівнем плану, або застарілий кеш FreeScout. Опрацюйте відповідний розділ нижче, де кожна проблема спершу описує симптом, а потім виправлення.
Чернетка не генерується
Симптом: ви відкриваєте розмову, але чернетка AI не з'являється і, здається, нічого не відбувається.
Виправлення: відкрийте налаштування ReplyRabbit поштової скриньки (Поштова скринька > Налаштування > ReplyRabbit) і переконайтеся, що вибрано провайдера та встановлено його API-ключ. На тарифі Free єдиний доступний провайдер це OpenAI, тож якщо ви вибрали інший, перемкніться назад на OpenAI або оновіть тариф. Потім перевірте, що ReplyRabbit увімкнено для поштової скриньки, у якій ви працюєте, оскільки чернетки генеруються лише для ввімкнених скриньок.
Недійсний ключ API або помилка провайдера
Симптом: ви бачите помилку про недійсний ключ, збій автентифікації або недоступність провайдера.
Виправлення: перевірте ключ на одруки та зайві пробіли, переконайтеся, що це ключ для провайдера, якого ви насправді вибрали (ключ OpenAI не працюватиме з Anthropic), і переконайтеся, що ключ досі має кредит і доступ на панелі провайдера. Ключ без залишку балансу або з відкликаним доступом дає ту саму помилку.
Помилки після оновлення PHP
Симптом: після оновлення сервера (наприклад, до Ubuntu 26.04 з PHP 8.5), Перевірити з'єднання не вдається або фонові завдання зупиняються, і журнал FreeScout показує повідомлення, що закінчуються на is deprecated since 8.5.
Виправлення: тримайте ReplyRabbit та інші ваші модулі в актуальному стані з Керувати > Модулі, потім запустіть php artisan freescout:clear-cache і php artisan queue:restart. ReplyRabbit підтримує PHP 8.0 до 8.5. Див. Виправлення помилок "deprecated since 8.5" у FreeScout щоб знайти, з якого модуля надходить повідомлення.
Меню ReplyRabbit відсутнє
Симптом: ReplyRabbit не з'являється в меню або налаштуваннях FreeScout після встановлення.
Виправлення: спочатку переконайтеся, що модуль активовано в Керувати > Модулі. Потім очистіть кеш із кореня вашого FreeScout:
php artisan freescout:clear-cacheЯкщо це все ще відсутнє, перевірте дозволи користувача: користувач без доступу до відповідної поштової скриньки або налаштувань адміністратора не побачить параметрів ReplyRabbit.
Чернетки зупинилися через деякий час
Симптом: чернетки спочатку працювали, а потім перестали генеруватися пізніше в місяці.
Виправлення: рівень Free дозволяє 10 чернеток на місяць. Щойно ви досягнете цієї межі, створення чернеток призупиняється до наступного місяця. У Pro та Team немає обмеження на чернетки. На будь-якому плані створення чернеток також призупиняється, якщо поштова скринька Місячний бюджет токенів вичерпано, тож перевірте й це налаштування (0 означає відсутність бюджету).
Кешування підказок не змінює місячну кількість токенів
Симптом: повторні чернетки виглядають придатними для кешування підказок провайдера, але використання токенів ReplyRabbit усе одно показує повний підсумок вхідних і вихідних даних.
Виправлення: це очікувано. ReplyRabbit підтримує консервативні місячні бюджети та рахує загальну кількість токенів, навіть коли постачальник виставляє рахунок за кешований ввід інакше. Економія кешу постачальника залежить від постачальника, моделі, повторюваних префіксів підказок і звітності постачальника. Керування кешем Anthropic використовується лише для відповідної повторюваної роботи з чернетками та повертається до звичайної генерації, коли не підтримується.
Задачі Linear не створюються
Симптом: наступні дії виявлено, але завдання Linear не створено.
Виправлення: у налаштуваннях ReplyRabbit перевірте ключ API Linear, вибрану команду та чи завдання перебувають у стані очікування підтвердження. Також переконайтеся, що ваш тариф включає Linear: ручне створення завдань Linear є функцією Pro, а автоматичне створення завдань є функцією Team.
Задачі Jira не створюються
Симптом: розмова потребує інженерної роботи, але задача Jira не створюється.
Виправлення: у налаштуваннях ReplyRabbit переконайтеся, що Jira вибрано як трекер завдань поштової скриньки. Перевірте URL сайту Jira Cloud, електронну пошту облікового запису, токен API, проєкт за замовчуванням і тип завдання за замовчуванням. Також переконайтеся, що ваш тариф включає створення завдань: ручне створення завдань Jira є функцією Pro, а автоматичне створення завдань є функцією Team. Для повного шляху налаштування див. Інтеграція з Jira.
Теги робочих процесів не застосовуються
Симптом: ви очікували теги, як-от rr_priority_critical, rr_no_reply_needed, або rr_linear_issue_created, але в розмові немає тегів ReplyRabbit.
Виправлення: відкрийте налаштування ReplyRabbit поштової скриньки та підтвердьте Увімкнути синхронізацію робочих процесів і Застосувати теги FreeScout увімкнено в Теги робочих процесів розділ. Якщо теги сигналів відсутні, переконайтеся, що Сигнали ШІ увімкнено, і розмову проаналізовано. Якщо теги Linear відсутні, переконайтеся, що розмова має завдання Linear, створене ReplyRabbit.
Якщо рецепти FreeScout Workflows не спрацьовують, спершу переконайтеся, що ReplyRabbit додає очікуваний тег FreeScout. Потім перевірте, чи ваш встановлений модуль Workflows реагує на програмні зміни тегів. ReplyRabbit може застосовувати теги, але модуль Workflows визначає, чи запускається рецепт від цієї зміни тегу.
Джерела знань: чернетка не використала мої довідкові сторінки, базу знань, продукти чи попередні відповіді
Симптом: чернетка проігнорувала інформацію, яка, як ви знаєте, є на ваших сторінках довідки, у Knowledge Base, списку продуктів або попередніх відповідях.
Виправлення: почніть із рядка під чернеткою в редакторі відповіді. Він перелічує, що використала чернетка, наприклад "Included: 2 help pages, 1 Knowledge Base article, 3 earlier replies to this customer". Натисніть на нього, щоб побачити посилання, а також примітку для кожного ввімкненого джерела, яке нічого не додало:
- Увімкнено, але ще нічого не проіндексовано: індексація не завершилася. Перевірте обробник черги (див. нижче), потім зачекайте завершення індексації.
- Немає відповідного збігу для цього повідомлення: джерело в порядку, але ніщо в ньому не збігалося з повідомленням цього клієнта достатньо близько. Додайте або покращте вміст, який відповідає на таке запитання.
- Індекс перевищує ліміт пошуку: коли індекс перевищує 6000 індексованих розділів, виконується лише зіставлення за ключовими словами, а не за значенням. Видаліть джерела, які вам не потрібні, щоб повернутися під ліміт.
- Ваш тариф його не включає: це джерело недоступне на вашому поточному плані.
- Модуль бази знань не встановлено або не активовано: встановіть або активуйте його в Керувати > Модулі.
Попередження про стан налаштування
Банер стану налаштування в налаштуваннях поштової скриньки тепер попереджає, коли:
- Схоже, обробник черги не запущено. Індексація та авточернетки ніколи не завершуються без нього. FreeScout запускає чергу через завдання cron
php artisan schedule:runабоqueue:workпроцес, тож переконайтеся, що один із них налаштований. - Жодне джерело знань не увімкнено. Увімкніть принаймні одне в Mailbox settings, Knowledge sources.
- Джерело ввімкнено, але ще не проіндексовано. Дозвольте індексації завершитися.
Джерела вебсайту
- Сканування за замовчуванням зупиняється на 200 сторінках, і джерело тепер повідомляє про це, з кнопкою для підвищення ліміту. Після цього збережіть налаштування, а потім скануйте знову.
- Сторінки, які неможливо прочитати, підраховуються із зазначенням причини, наприклад заблоковано сайтом (403), не знайдено (404), забагато запитів (429), помилка сервера, завеликий розмір або немає читабельного тексту (часто сторінка, створена за допомогою JavaScript). Попросіть вашого хостера пропустити сканер або вкажіть джерело на сторінки, які не потребують JavaScript.
- Дуже довгі сторінки скорочуються приблизно до 24 000 символів. Коли семантичне зіставлення ввімкнено, джерело показує, скільки сторінок було скорочено. Розділіть довгі сторінки, якщо потрібна вам частина ближче до кінця.
Outline і зіставлення за змістом
- Синхронізація Outline зупиняється на 1000 документах. Документи понад цю кількість не синхронізуються.
- Зіставлення за змістом (семантичне) потребує постачальника вбудовувань. Деякі моделі вбудовувань ще не відкалібровані для зіставлення лише за значенням і показують попередження, тож перемкніться на іншу модель вбудовувань, якщо побачите його.
Все ще не працює?