Устранение неполадок ReplyRabbit
Большинство проблем ReplyRabbit сводится к одному из трёх: отсутствующий или неверный API-ключ, использование провайдера, не разрешённого вашим уровнем плана, или устаревший кэш FreeScout. Проработайте соответствующий раздел ниже, где для каждой проблемы сначала указан симптом, а затем решение.
Черновик не создаётся
Симптом: вы открываете беседу, но черновик ИИ не появляется и, кажется, ничего не происходит.
Исправление: откройте настройки 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, email аккаунта, токен API, проект по умолчанию и тип задачи по умолчанию. Также убедитесь, что ваш тариф включает создание задач: ручное создание задач Jira это функция Pro, а автоматическое создание задач это функция Team. Для полного пути настройки смотрите Интеграция с Jira.
Теги Workflow не применяются
Симптом: вы ожидали теги, такие как rr_priority_critical, rr_no_reply_needed, или rr_linear_issue_created, но в беседе нет тегов ReplyRabbit.
Исправление: откройте настройки ReplyRabbit почтового ящика и убедитесь, что Включить синхронизацию workflow и Применить теги FreeScout включены в Теги Workflow раздел. Если сигнальные теги отсутствуют, подтвердите AI Signals включена и диалог проанализирован. Если теги 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 останавливается на 1000 документов. Документы сверх этого не синхронизируются.
- Семантическое сопоставление по смыслу требует провайдера эмбеддингов. Некоторые модели эмбеддингов ещё не откалиброваны для сопоставления только по смыслу и показывают предупреждение, поэтому переключитесь на другую модель эмбеддингов, если увидите его.
Всё ещё застряли?