言い方が違っても探せる検索を、AI Searchで検討する

通常の検索との目的の違い、Cloudflareへの接続、検索対象と結果URLの確認を整理します。

目次

言い方の違いでページが見つからない場合は、Cloudflare AI Searchと連携するEmDashの公式プラグインを改善候補として検討できます。たとえば、読者は「引っ越し」と探しているのに、ページには「移行」と書かれているような場合です。

効果はサイトの内容や検索する言葉によって変わるため、導入前に試す必要があります。読者が使う言い方で必要なページへたどり着けるか、今の検索と比較して選びます。

検索対象を決める担当者と、サイトの設定ファイルを編集する制作担当者で進めます。このガイドでは、導入の判断と、組み込んだあとの確認点を整理します。コードを変更する段階では、後に示す公式の導入手順も開いて進めます。

先に、試す言葉を用意する

今の検索で困っている例を、5〜10個ほど集めます。たとえば「写真を変える」「昔の文章へ戻す」「引っ越し」です。各言葉で見つけたいページも決めます。

検索ボックスのデザイン変更と、検索対象を調べる仕組みの変更は別です。AI Searchを検討する前に、通常のサイト内検索でも目的を満たせないか確かめます。

必要なのは、プラグイン・接続・表示の3つ

用意するもの役割
@emdash-cms/plugin-ai-searchEmDashの公開内容を検索へ連携する
Cloudflare AI Searchへの接続検索用のデータを作り、検索を実行する
AiSearchという表示部品読者が検索する入口をページへ置く

プラグインは、サーバーで動かすNode.js構成と、Cloudflare上で動かすWorkers構成に対応しますが、検索先のCloudflare側の準備は必要です。利用条件、利用量、費用を先に確認します。

接続方法は、公開先に合わせる

Cloudflare Workersでは、同じCloudflare上の検索機能とつなぐ**binding(接続設定)**を使えます。Node.jsなどからは、CloudflareのアカウントID(利用するアカウントの識別番号)とAPIトークンで接続します。制作担当者が、サイトの公開先に合う方を選びます。

APIトークンは、そのサービスを操作するための認証情報です。必要な権限はAI Search EditとAI Search Runです。記事を読む人のブラウザーへ、トークンを渡さないようにします。

管理画面でトークンを保存する場合は、保存内容を読めない形にするための暗号化キーも必要です。秘密の設定と鍵の交換で役割を確認し、公式のAI Searchガイド(別タブで開く)で選んだ接続方法を照合します。

環境変数は、プログラムが動く場所から渡す設定値です。管理画面で修正した値より、公開先の環境変数が優先されることがあります。また、bindingが使える場合は、プラグインはそちらで接続します。接続できないときは、実際にどの設定を使っているかも調べます。

制作担当者が組み込み、管理画面で対象を選ぶ

  1. 制作担当者が、公式のInstallation(別タブで開く)に沿って、サイトのプロジェクトへプラグインを追加する。astro.config.mjs内のEmDashのplugins設定にも登録する。
  2. 公開先に合わせて、bindingまたはアカウントID・トークンを設定する。
  3. 複数のページで使う共通レイアウトの.astroファイルへ、AiSearchという検索用の表示部品を置く。1ページに重複して出ないようにする。
  4. 確認用サイトへ変更を反映し、ブラウザーでEmDash管理画面のAI Searchを開く。
  5. 検索する内容と、結果のURL例を確認する。
  6. **Build index(検索用データを作る)**を選ぶ。

ここまでの1〜3は制作担当者のファイル・接続設定の作業、4〜6は管理画面での操作です。表示部品を置くと、検索ボタンから検索欄を開けるようになります。

インデックスは、検索しやすい形へ整理したデータです。登録が進むにつれて結果が増えるので、開始直後に全ページが見つかるとは限りません。以後の公開内容の変更は、自動で更新される仕組みです。

検索結果の住所を必ず開く

検索結果のリンクを実際に開き、見つかった記事のページへ進めるか確かめます。記事を/blog/に表示しているなら、その構成に合う結果になっているか確認します。

日本語と英語、画像の多いページ、新しく公開したページも試します。下書きが結果に混じらないこと、公開を取り消した内容がいつ結果から外れるかも、確認用環境で確かめます。

検索ボタンが見当たらなければ表示部品の配置、ボタンはあるのに通信エラーが出るなら接続設定、検索できても目的のページが出ないなら検索対象と登録の進み具合を調べます。問題が起きた段階を分けると、同じ設定を何度も直さずに済みます。

既存のAI検索から切り替える場合

以前の@emdash-cms/cloudflare/pluginsにあるaiSearchとは、同じ登録名を使います。新旧を同時に登録せず、公式の切り替え案内に沿って、古いプラグイン・独自検索ルート・表示部品を整理します。新しい検索データを作る時間も見込みます。

通常の検索と結果を比較し、用意した質問で目的のページへ進めるかを記録します。見つからない場合は、検索設定だけでなく、検索対象のページの見出しや説明が読者の言葉に合っているかも見直しましょう。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。