ReplyRabbitのトラブルシューティング
ReplyRabbitの問題のほとんどは3つのいずれかに帰着します:APIキーの欠落または誤り、プランティアで許可されていないプロバイダーの使用、または古いFreeScoutキャッシュ。以下の該当セクションを確認してください。各問題はまず症状をリストし、次に修正を示します。
下書きは生成されません
症状: 会話を開いても AI の下書きが表示されず、何も起こらないように見える場合。
修正: メールボックスのReplyRabbit設定を開き(メールボックス > 設定 > ReplyRabbit)を確認し、プロバイダーが選択され、そのAPIキーが設定されていることを確かめてください。Freeプランでは利用可能なプロバイダーはOpenAIのみなので、別のものを選んだ場合はOpenAIに戻すかアップグレードしてください。次に、作業中のメールボックスでReplyRabbitが有効になっていることを確認してください。下書きは有効なメールボックスでのみ生成されます。
無効なAPIキーまたはプロバイダーエラー
症状: 無効なキー、認証失敗、またはプロバイダーに接続できないというエラーが表示される場合。
修正: キーのタイプミスや余分なスペースがないか再確認し、実際に選択したプロバイダーのキーであることを確認し (OpenAI のキーは Anthropic では機能しません)、プロバイダーのダッシュボードでキーにまだクレジットとアクセス権があることを確認してください。残高がない、またはアクセスが取り消されたキーでも同じエラーが発生します。
PHPアップグレード後のエラー
症状: サーバーアップグレード後(たとえば、PHP 8.5を備えたUbuntu 26.04へ)、 接続をテスト 失敗するかバックグラウンドジョブが停止し、FreeScoutログに以下で終わるメッセージが表示されます is deprecated since 8.5.
修正: ReplyRabbitと他のモジュールを最新の状態に保つ 管理 > モジュール)、次に実行します php artisan freescout:clear-cache および php artisan queue:restart)。ReplyRabbitはPHP 8.0から8.5をサポートします。参照: FreeScoutの「deprecated since 8.5」エラーを修正 メッセージがどのモジュールから来たかを見つけるため。
ReplyRabbit メニューがありません
症状: インストール後、ReplyRabbitがFreeScoutのメニューや設定に表示されません。
修正: まず、以下でモジュールが有効化されていることを確認してください 管理 > モジュール)。次にFreeScoutルートからキャッシュをクリアします:
php artisan freescout:clear-cacheそれでも表示されない場合は、ユーザーの権限を確認してください。関連するメールボックスまたは管理者設定へのアクセス権がないユーザーには、ReplyRabbitのオプションが表示されません。
下書きがある程度で停止した
症状: 下書きは最初は機能していたが、月の後半に生成されなくなった。
修正: Free ティアでは月 10 件の下書きが可能です。この制限に達すると、翌月まで下書きが一時停止します。Pro と Team には下書きの制限がありません。どのプランでも、メールボックスの 月間トークン予算 が使い果たされているため、その設定も確認してください(0は予算なしを意味します)。
プロンプトキャッシュは月間トークン数を変更しません
症状: 繰り返される下書きはプロバイダーのプロンプトキャッシュの対象になる可能性がありますが、ReplyRabbit のトークン使用量には引き続き入力と出力の合計全体が表示されます。
修正: これは想定内です。ReplyRabbit は月間予算を保守的に保ち、プロバイダーがキャッシュされた入力を異なる方法で請求する場合でも総トークンをカウントします。プロバイダーのキャッシュ節約は、プロバイダー、モデル、繰り返されるプロンプトプレフィックス、プロバイダーのレポートに依存します。Anthropic のキャッシュ制御は、対象となる繰り返しの下書き作業にのみ使用され、サポートされていない場合は通常の生成にフォールバックします。
Linearチケットが作成されない
症状: 次のアクションが検出されますが、Linearチケットは作成されません。
修正: ReplyRabbit設定で、Linear APIキー、選択したチーム、およびチケットが確認待ちの保留状態にあるかどうかを確認します。また、プランにLinearが含まれていることを確認してください:手動Linearチケット作成はPro機能で、自動チケット作成はTeam機能です。
Jira課題が作成されない
症状: 会話にエンジニアリング作業が必要ですが、Jira課題は作成されません。
修正: ReplyRabbit設定で、Jiraがメールボックスのイシュートラッカーとして選択されていることを確認します。Jira CloudサイトURL、アカウントメール、APIトークン、デフォルトプロジェクト、デフォルトイシュータイプを確認します。また、プランにイシュー作成が含まれていることを確認してください:手動Jiraイシュー作成はPro機能で、自動イシュー作成はTeam機能です。完全なセットアップパスについては、参照: Jira統合.
Workflowタグが適用されていません
症状: 次のようなタグを期待していた場合 rr_priority_critical, rr_no_reply_needed)、または rr_linear_issue_created)、ただし会話にReplyRabbitタグがありません。
修正: メールボックスのReplyRabbit設定を開き、確認します ワークフロー同期を有効化 および FreeScout タグを適用 はオンになっています Workflowタグ セクション。シグナルタグが欠落している場合は、確認してください AIシグナル がオンで、会話が分析されている。Linearタグが欠落している場合、会話にReplyRabbitが作成したLinearイシューがあることを確認してください。
FreeScout Workflowsのレシピが発火しない場合は、まずReplyRabbitが期待どおりのFreeScoutタグを追加していることを確認してください。次に、インストール済みのWorkflowsモジュールがプログラムによるタグ変更に反応するかテストしてください。ReplyRabbitはタグを適用できますが、そのタグ変更からレシピを実行するかどうかはWorkflowsモジュールが制御します。
ナレッジソース:下書きがヘルプページ、ナレッジベース、製品、過去の返信を使用しなかった
症状: 下書きが、ヘルプページ、Knowledge Base、製品リスト、または以前の返信にあると分かっている情報を無視しました。
修正: 返信エディタの下書きの下の行から始めます。下書きが何を使用したかが一覧表示されます。例えば「含まれるもの: ヘルプページ 2 件、ナレッジベース記事 1 件、この顧客への以前の返信 3 件」。クリックするとリンクが表示され、何も追加しなかった有効なソースごとにメモが表示されます:
- 有効になっているがまだインデックスされていません: インデックス作成が完了していません。キューワーカー(下記参照)を確認し、インデックス作成の完了を待ちます。
- このメッセージに一致するものがありません: ソースは問題ありませんが、その中の何もこの顧客のメッセージに十分近く一致しませんでした。この種の質問に答えるコンテンツを追加または改善してください。
- 検索制限を超えるインデックス: インデックスが6,000のインデックス済みセクションを超えると、キーワードマッチングのみが実行され、意味ベースのマッチングは実行されません。不要なソースを削除して制限以下に戻してください。
- あなたのプランには含まれていません: そのソースは現在のプランでは利用できません。
- ナレッジベースモジュールがインストールされていないか、アクティブではありません: 以下でインストールまたは有効化します 管理 > モジュール.
セットアップ状態の警告
メールボックス設定のセットアップステータスバナーが次の場合に警告するようになりました:
- キューワーカーが実行されていないようです。 これがないとインデックス作成と自動下書きは決して完了しません。FreeScoutはcronジョブを通じてキューを実行します
php artisan schedule:runまたはqueue:workプロセスです。そのため、いずれかが設定されていることを確認してください。 - ナレッジソースが有効になっていません。 メールボックス設定、ナレッジソースで少なくとも1つをオンにします。
- ソースはオンになっていますが、まだインデックス作成されていません。 インデックス作成を完了させます。
ウェブサイトソース
- クロールはデフォルトで200ページで停止し、ソースにその旨が表示され、制限を引き上げるボタンがあります。その後設定を保存し、再度クロールしてください。
- 読み取れないページは理由とともにカウントされます。例えば、サイトによるブロック(403)、見つからない(404)、リクエストが多すぎる(429)、サーバーエラー、大きすぎる、または読み取り可能なテキストがない(多くの場合JavaScriptで構築されたページ)。ホストにクローラーを通すよう依頼するか、JavaScriptを必要としないページにソースを向けてください。
- 非常に長いページは約24,000文字に短縮されます。セマンティックマッチングが有効な場合、ソースには短縮されたページ数が表示されます。必要な部分が末尾近くにある場合は、長いページを分割してください。
アウトラインと意味ベースのマッチング
- Outlineの同期は1,000ドキュメントで停止します。それ以降のドキュメントは同期されません。
- 意味ベース(セマンティック)マッチングには埋め込みプロバイダーが必要です。一部の埋め込みモデルはまだ意味のみのマッチングに調整されておらず警告を表示するため、表示された場合は別の埋め込みモデルに切り替えてください。
まだお困りですか?