HelpBrain
無料で始める

メニュー

ログイン

トラブルシューティング

症状から探してください。各行に、実際に何が起きているかと、何を変えればよいかを書いています。

ウィジェットが表示されない

まずシークレットウィンドウで公開サイトを確認してください。ログイン中のセッション、広告ブロッカー、開いたままの古いタブが、このケースのかなりの割合を占めます。

症状実際に起きていること対処
どのページにも何も出ないブラウザが受け取ったHTMLにスニペットが含まれていません。多くは、公開サイトで描画されない場所に貼られています。ページのソースを表示（Ctrl-U）して helpbrain を検索してください。見つからなければ貼り付けが効いていません。特定ページの本文ではなく、サイト共通のフッターやレイアウトテンプレートを使ったか確認してください。
表示されない（WebflowまたはFramerを利用）カスタムコードはサイトを公開したときにはじめて反映されます。保存は公開ではなく、エディタのプレビューでは動きません。サイトを公開し、プレビューではなく公開URLで確認してください。
ソースにスニペットはあるのに表示されないContent-Security-Policyヘッダーが、スクリプトの実行前に遮断しています。ブラウザのコンソールに明示的に表示されます。script-src と frame-src に https://helpbrain.net を追加してください。設置ガイドのCSPの節をご覧ください。
1ページにしか表示されないスニペットが共通テンプレートではなく、そのページの本文に入っています。全ページが描画するフッターまたはレイアウトのテンプレートに移してください。
表示されていたが、WordPressの更新後に消えたテーマの更新で footer.php が上書きされ、スニペットも一緒に消えました。WPCodeプラグイン経由で追加し直すか、子テーマを使ってください。プラグインのスニペットはテーマ更新後も残ります。
ボタンは出るが、押しても何も開かないスクリプトは読み込めていますが、会話フレームが遮断されています。チャット本体はiframeで動くため、ほぼ必ずCSPの frame-src が原因です。script-src だけでなく frame-src にも https://helpbrain.net を追加してください。
他の人には見えるが、自分には見えないページキャッシュまたはCDNが、スニペットを貼る前のHTMLをまだ配信しています。キャッシュをパージするか、期限切れを待ってください。通常は1〜2分です。

メモ

ダッシュボードの設置確認は、こちら側からあなたのホームページを取得します。「ページに到達できなかった」と表示された場合は、スニペットが無いのとは別の問題です — ファイアウォールやWAFがこちらを遮断しており、スニペット自体は正しい可能性があります。

ボットが答えない、または回答がよくない

ここに挙げたケースのほとんどは、モデルの問題ではなくコンテンツの問題です。ボットはあなたのページから回答し、どのページにも書かれていないことを作り出すことを拒みます。つまり答えられない質問は、あなたのコンテンツについて本当のことを伝えています。

症状実際に起きていること対処
「確信が持てない」と言って担当者を提案する確信度のゲートです。取得した内容では回答を裏付けられなかったため、推測せずにエスカレーションしました。その質問が、追加済みのページで実際にカバーされているか確認してください。無ければコンテンツを追加するか、受信トレイで一度答えれば以後それが使われます。
サイトに書いてあることなのに「確信が持てない」と言うそのページがそもそも読まれていない可能性が高いです。除外されている、到達できない、robots.txtで遮断されている、ログインの内側にある、などです。ソース一覧でそのURLを探してください。無ければページソースとして直接追加を。失敗として並んでいる場合は、理由がその横に表示されています。
回答が古い前回のクロール以降にサイトが変わりました。毎晩の再クロールは協定世界時05:00に実行されます。今夜を待たず、ソースページから手動で再同期してください。
自信たっぷりに間違える関連しているように見えて実際は違うページを見つけています。公開したままだと忘れていた古いページであることがよくあります。修正を登録してください。その質問に対して記憶されます。ページ自体が問題なら、そのページ1件をソースから除外すれば、内容は使われなくなります。
違う言語で答えるボットは訪問者が書いた言語で返答します。ウィジェットの表示言語は、あなたのページの html lang 属性から決まります。サイトのその属性が正しく設定されているか確認してください。これは回答の言語ではなく、ウィジェット自身のラベルの言語にのみ影響します。

ヒント

ボットが答えられなかった質問は失われません。受信トレイに届き、そこで答えれば、以後の訪問者すべてに対してボットが学習します。

ページが読まれない

失敗したURLには、それぞれ理由が付きます。知っておく価値があるのは次のものです。

症状実際に起きていること対処
ブロックされたホスト側が拒否しました。多いのはCloudflareのAIボット遮断か、データセンターIPに一致するWAFルールです。ユーザーエージェント HelpBrainBot で、こちらのクローラーを許可してください。クローラーのページに正確な文字列と挙動を記載しています。
見つからない / サーバーエラーそのURLが、誰に対してもそうであるように、こちらにも404または500を返しています。シークレットウィンドウでご自身で開いてみてください。自分は開けてこちらが開けないなら、ページではなくアクセス制御の問題です。
空だったページは読み込めましたが、読めるテキストがありませんでした。多くは、こちらで実行できなかったJavaScriptで本文を描画するアプリの外枠です。実ブラウザでの再試行は自動で行います。それでも空のままなら、ファイルまたは貼り付けテキストとして内容を追加してください。
大きすぎるファイルが25MBを超えています。アップロードと同じ上限です。分割するか、実際に質問の答えになる部分だけをアップロードしてください。
リンクされたPDFが飛ばされたスキャンされたPDFはマルチモーダルでの読み取りが必要で、1回の同期で処理する件数には上限があります。重要なものはファイルソースとして直接アップロードしてください。クロール全体と枠を奪い合わずに済みます。
一部のページがまったく読まれなくなったプランのページ上限に達しています。上限はアカウント内の全ボットにまたがってURL数で数えます。不要なソースを削除するか、プランを上げてください。「プランと上限」に、何を1ページと数えるかを詳しく書いています。

それでも解決しないとき

上記の仕組みをさらに詳しく説明しているページです。