ツールが表示されないときに確認する

表示されない原因を、スタジオのツール設定と埋め込みの設置設定に分けて確認します。上から順に切り分けてください。

更新日: 2026年8月10日

1. 公開状態とインストールコードを確認する

  • 埋め込み画面が公開中になっている
  • 変更後に下書きの保存だけでなく公開まで行っている
  • 対象サイトのHTMLに、そのKotael Siteのインストールコードが含まれている
  • サイト側の変更が本番へ公開され、最新のHTMLが読み込まれている

埋め込み設定が非公開の場合、インストールコードがあってもツールは表示されません。

2. URL条件と優先順位を確認する

表示テストへ実ページのURLを入力し、表示条件に一致するか確認します。httpとhttps、サブドメイン、末尾のパス、除外条件の重複に注意してください。

チャットボットとAIエージェントの両方が一致している場合、優先順位が下のツールはPopupとして表示されません。意図したツールが上にあるか確認します。

3. セレクターとWorkflowを確認する

検索では、設定したCSSセレクターに一致する要素が実ページに必要です。IDやクラス名の誤り、同じIDの重複、ページ描画後に要素がなくなる処理がないか確認してください。

AIエージェントにWorkflowが未公開ですと表示される場合は、スタジオでフローを保存・検証して公開します。そのあと埋め込みの下書きを保存し、設定を公開してください。

4. 表示テストと実ページで切り分ける

埋め込み表示テストで回答できる場合は、埋め込みの公開状態、URL条件、設置位置を優先して確認します。表示テストでも動かない場合は、使用するナレッジ、必須設定、AIエージェントのフローを確認します。

公開後はブラウザを再読み込みし、必要に応じてサイト側のキャッシュを更新してください。問題が続く場合は、対象ツール名、確認URL、表示テスト結果を記録して管理者へ共有します。