ウェブサイト検索のチェックリスト

このページでは、汎用検索アプリの一種であるウェブサイト検索アプリの作成に必要な手順のチェックリストを示します。他の種類の汎用検索アプリを作成するチェックリストについては、一般的な検索のチェックリストをご覧ください。

Vertex AI Agent Builder を初めて使用する場合は、汎用検索を使ってみるのチュートリアルに沿って、ウェブサイト データ アプリのサンプルを作成することを検討してください。

基本的なウェブサイト検索とウェブサイトの高度なインデックス登録のどちらかを選択する

Vertex AI Agent Builder には、基本的なウェブサイト検索と高度なウェブサイト インデックス登録の 2 種類のウェブサイト データストアがあります。

高度なウェブサイト インデックス登録を有効にして、検索データストア内のウェブページをインデックスに登録できます。高度なウェブサイト インデックス登録では、ドメインの所有権の証明が必要であり、基本的なウェブサイト検索よりも多くの機能を利用できます。 詳しくは、ウェブサイトの高度なインデックス登録をご覧ください。

ビジネスニーズに必要なウェブサイト データストアのタイプに応じて、次のいずれかのチェックリストを選択します。

基本的なウェブサイト検索 ウェブサイトの高度なインデックス登録

ヒント: ウェブサイトの高度なインデックス登録を使用して Vertex AI Search ドキュメントをインデックスに登録する Vertex AI Search ウィジェットを試すことができます。Vertex AI Search をお試しください。

Google Cloud プロジェクトを設定する

Google Cloud プロジェクトを設定し、Vertex AI Agent Builder を有効にして、プロジェクトのアクセス制御を設定します。既存の Google Cloud プロジェクトがすでにある場合は、それを使用できます。

操作

1. 始める前にのページを確認し、手順が完了していることを確認します。

データを準備する

ウェブサイト検索アプリ（汎用検索アプリの一種）の動作と、ウェブサイトをウェブサイト データストアに含める前提条件について理解します。

操作

1. 汎用アプリとデータストアの関係については、アプリとデータストアについてとウェブサイト データの構成要素をご覧ください。 データストアでウェブサイトの高度なインデックス登録が有効になっている場合は、そのデータストアを統合検索に使用できます。統合検索では、複数のデータストアがアプリに接続されます。

2. ウェブサイト データの要件に従ってウェブサイト データを準備します。

データストアを作成

含めるウェブサイトの URL パターンと除外する URL パターンを指定して、データストアを作成します。データストアの作成プロセスでは、高度なウェブサイト インデックス登録を有効にする手順が含まれます。この手順では、ドメインの所有権の証明が必要になります。

操作

1. ウェブサイトの URL を使用してデータストアを作成するの手順に沿って操作します。

   データストアの作成とドメインの所有権の証明が成功すると、Vertex AI Agent Builder は初期インデックスを生成します。このインデックスはベスト エフォートに基づいて自動的に更新されます。

   最初のインデックス登録プロセスには数時間かかることがあります。

2. 省略可: サイトマップのみのインデックス作成と更新を実行できるデータストアを作成します。これを行うには、データストアでサイトマップのみ更新を有効にするの手順に沿って操作します。

   サイトマップベースのインデックス登録と更新について詳しくは、サイトマップを使用してウェブページをインデックス登録、更新するをご覧ください。

アプリを作成する

ウェブサイト検索アプリを作成し、新しいデータストアに接続します。

操作

1. 検索アプリを作成します。Enterprise エディションをオンにしてください。

データストア レベルで検索設定を構成する

Vertex AI Search には、多くの構成オプションがあります。一部のオプションは、検索ウィジェットをデプロイするかどうかによって異なります。

操作

ユースケースと、すぐに使用できる検索ウィジェットをデプロイするか、検索 API 呼び出しを独自のコードに統合するかに応じて、Vertex AI Search にはいくつかの構成オプションがあります。

• 検索ウィジェットをウェブサイトに埋め込むと、検索バーと拡張可能な検索インターフェースが自動的に提供されます。検索ウィジェットをデプロイする場合は、以下を構成します。

  • 検索ウィジェットの検索結果。検索ウィジェットの結果を構成するをご覧ください。

  • 検索ウィジェットのファセット（プレビュー）。検索ウィジェットのファセットを構成するをご覧ください。

  • 予測入力。自動入力の設定を更新するをご覧ください。

  • 検索のチューニング（プレビュー）。検索チューニングで検索結果を改善するをご覧ください。

• ウィジェットを使用する代わりに、検索 API 呼び出しをサーバーまたはアプリケーションに統合する場合は、次のオプションを使用して検索設定を構成できます。

  • 予測入力。データに応じて、ドキュメントのコンテンツ、フィールド、検索履歴、ユーザー イベントに基づいて予測入力の候補を設定します。予測入力を構成するをご覧ください。

  • サービス提供コントロール（許可リストありのプレビュー）。検索結果のブースト、非表示化、フィルタ、リダイレクトのタイミングや、特定のクエリが他のクエリの類義語かどうかを制御します。検索のサービス提供コントロールを構成するをご覧ください。

  • 検索のチューニング（プレビュー）。独自のトレーニング データを使用して検索モデルをチューニングします。検索チューニングで検索結果を改善するをご覧ください。

リクエスト単位で検索結果を構成する

検索 API 呼び出しを独自のコードに統合してアプリをデプロイする場合は、Vertex AI Search で検索結果の返される方法を構成するための追加オプションが用意されています。

操作

1. 次のオプションを使用して検索結果を構成します。

   • ウェブサイト検索をフィルタします。

   • 検索結果をブーストします。

   • ウェブ検索結果を並べ替えします。

   • スニペットを取得します。

検索結果をプレビューする

検索結果をプレビューして、アプリの構成が想定どおりに機能しているかどうかを確認できます。

操作

1. 検索結果をプレビューするには、コンソールまたは API を使用します。

   • コンソール。Vertex AI Agent Builder コンソールの [プレビュー] ページを使用して、検索ウィジェットの構成が結果に与える影響をプレビューします。検索結果を取得するのコンソールの手順をご覧ください。

   • API。API 呼び出しをアプリケーションに統合する場合は、curl 呼び出しを実行して検索構成をプレビューできます。検索結果を取得するの REST の手順をご覧ください。

検索結果を絞り込む

ウェブページに追加された構造化データを活用して、データストアのインデックスを拡充します。

操作

ウェブページに構造化データを追加するプロセスは反復的です。

1. ウェブページの構造化データを変更します。詳しくは、ウェブサイトの高度なインデックス登録に構造化データを使用するをご覧ください。
2. 必要に応じて、構造化データ属性を使用してデータストア スキーマを更新します。
3. 検索結果を再構成します。このチェックリストのステップ 6 をご覧ください。
4. 検索結果をプレビューします。このチェックリストのステップ 7 をご覧ください。
5. 検索アプリをデプロイする前に、必要な検索動作を実現するために、必要に応じてこのプロセスを繰り返します。

検索アプリをデプロイする

検索アプリのプレビュー バージョンに問題がなければ、ウェブサイトにデプロイしてユーザーと共有します。

操作

1. 検索アプリは、次のいずれかの方法でデプロイできます。

   • 検索ウィジェットをウェブサイトに埋め込みます。Vertex AI Search には、ウェブサイトまたはウェブ アプリケーションにコピーできるコードが用意されています。これにより、検索ウィジェットがデプロイされます。検索結果はコンソールでプレビューできます。ウェブページに検索ウィジェットを追加するをご覧ください。

   • 検索 API 呼び出しをサーバーまたはアプリケーションに統合します。検索結果の表示方法を完全に制御するには、API 呼び出しをサーバーまたはアプリケーションに統合します。API 呼び出しについて詳しくは、検索結果を取得するをご覧ください。クライアント ライブラリのリソースについては、Vertex AI Agent Builder クライアント ライブラリをご覧ください。

アプリのメンテナンス

アプリをメンテナンスすることで、データストアで最新の必要なデータを利用できるようにできます。

操作

1. データを更新します。
2. 省略可: データストアにサイトマップベースのインデックス登録と更新がある場合は、サイトマップまたはサイトマップ インデックスを送信して最新の状態に保ちます。データストア インデックスは自動的に更新され、含まれる URL は毎日更新されます。サイトマップベースのインデックス登録と更新について詳しくは、サイトマップを使用してウェブページをインデックス登録、更新するをご覧ください。