Vertex AI Agent Builder を初めて使用する場合は、汎用検索を使ってみるのチュートリアルに沿って、ウェブサイト データ アプリのサンプルを作成することを検討してください。
基本的なウェブサイト検索とウェブサイトの高度なインデックス登録のどちらかを選択する
Vertex AI Agent Builder には、基本的なウェブサイト検索と高度なウェブサイト インデックス登録の 2 種類のウェブサイト データストアがあります。
ウェブサイトの高度なインデックス登録を有効にして、検索データストア内のウェブページをインデックスに登録できます。高度なウェブサイト インデックス登録では、ドメインの所有権の証明が必要であり、基本的なウェブサイト検索よりも多くの機能を利用できます。 詳しくは、ウェブサイトの高度なインデックス登録をご覧ください。
ビジネスニーズに必要なウェブサイト データストアのタイプに応じて、次のいずれかのチェックリストを選択します。
Google Cloud プロジェクトを設定し、Vertex AI Agent Builder を有効にして、プロジェクトのアクセス制御を設定します。既存のプロジェクトがすでにある場合は、そのプロジェクトを使用できます。 Google Cloud
操作
- 始める前にを確認し、手順が完了していることを確認します。
ウェブサイト検索アプリ（汎用検索アプリの一種）の動作と、ウェブサイトをウェブサイト データストアに含める前提条件について理解します。
アクション
汎用アプリとデータストアの関係については、アプリとデータストアについてとウェブサイト データの構成要素をご覧ください。 データストアでウェブサイトの高度なインデックス登録が有効になっている場合は、そのデータストアを統合検索に使用できます。統合検索では、複数のデータストアがアプリに接続されます。
ウェブサイト データの要件に従ってウェブサイト データを準備します。
含めるウェブサイトの URL パターンと除外する URL パターンを指定して、データストアを作成します。データストアの作成プロセスでは、ウェブサイトの高度なインデックス登録を有効にする手順が含まれます。この手順では、ドメインの所有権の証明が必要です。
操作
ウェブサイトの URL を使用してデータストアを作成するの手順に沿って操作します。
データストアの作成とドメインの所有権の証明が成功すると、Vertex AI Agent Builder は初期インデックスを生成します。このインデックスはベスト エフォートに基づいて自動的に更新されます。
最初のインデックス登録プロセスには数時間かかることがあります。
省略可: サイトマップのみのインデックス登録と更新を実行できるデータストアを作成します。これを行うには、データストアでサイトマップのみ更新を有効にするの手順に沿って操作します。
サイトマップベースのインデックス登録と更新について詳しくは、サイトマップを使用してウェブページをインデックス登録、更新するをご覧ください。
Vertex AI Search には、多くの構成オプションがあります。一部のオプションは、検索ウィジェットをデプロイするかどうかによって異なります。
アクション
ユースケースと、すぐに使える検索ウィジェットをデプロイするか、検索 API 呼び出しを独自のコードに統合するかに応じて、Vertex AI Search にはいくつかの構成オプションが用意されています。
検索ウィジェットをウェブサイトに埋め込むと、検索バーと拡張可能な検索インターフェースが自動的に提供されます。検索ウィジェットをデプロイする場合は、以下を構成します。
検索ウィジェットの検索結果。検索ウィジェットの結果を構成するをご覧ください。
検索ウィジェットのファセット（プレビュー）。検索ウィジェットのファセットを構成するをご覧ください。
予測入力。予測入力の設定を更新するをご覧ください。
検索のチューニング（プレビュー）。検索チューニングで検索結果を改善するをご覧ください。
ウィジェットを使用する代わりに、検索 API 呼び出しをサーバーまたはアプリケーションに統合する場合は、次のオプションを使用して検索設定を構成できます。
予測入力。データに応じて、ドキュメントのコンテンツ、フィールド、検索履歴、ユーザー イベントに基づいて予測入力の候補を設定します。予測入力を構成するをご覧ください。
サービス提供コントロール。検索結果のブースト、非表示化、フィルタ、リダイレクトのタイミングや、特定のクエリが他のクエリの類義語かどうかを制御します。検索のサービス提供コントロールを構成するをご覧ください。
検索のチューニング（プレビュー）。独自のトレーニング データを使用して検索モデルをチューニングします。検索チューニングで検索結果を改善するをご覧ください。
検索 API 呼び出しを独自のコードに統合してアプリをデプロイする場合は、Vertex AI Search で検索結果の返される方法を構成するための追加オプションが用意されています。
アクション
次のオプションを使用して検索結果を構成します。
ウェブサイト検索をフィルタします。
検索結果をブーストします。
ウェブ検索結果を並べ替えします。
スニペットを取得します。
ウェブページに追加された構造化データを活用して、データストアのインデックスを拡充します。
アクション
ウェブページに構造化データを追加するプロセスは反復的です。
- ウェブページの構造化データを変更します。詳しくは、ウェブサイトの高度なインデックス登録に構造化データを使用するをご覧ください。
- 必要に応じて、構造化データ属性を使用してデータストア スキーマを更新します。
- 検索結果を再構成します。このチェックリストのステップ 6 をご覧ください。
- 検索結果をプレビューします。このチェックリストのステップ 7 をご覧ください。
- 検索アプリをデプロイする前に、必要な検索動作を実現するために、必要に応じてこのプロセスを繰り返します。
検索アプリのプレビュー バージョンに問題がなければ、ウェブサイトにデプロイしてユーザーと共有します。
アクション
検索アプリは、次のいずれかの方法でデプロイできます。
検索ウィジェットをウェブサイトに埋め込みます。Vertex AI Search には、ウェブサイトまたはウェブ アプリケーションにコピーできるコードが用意されています。これにより、検索ウィジェットがデプロイされます。検索結果はコンソールでプレビューできます。ウェブページに検索ウィジェットを追加するをご覧ください。
検索 API 呼び出しをサーバーまたはアプリケーションに統合します。検索結果の表示方法を完全に制御するには、API 呼び出しをサーバーまたはアプリケーションに統合します。API 呼び出しについて詳しくは、検索結果を取得するをご覧ください。クライアント ライブラリのリソースについては、Vertex AI Agent Builder クライアント ライブラリをご覧ください。
アプリをメンテナンスすることで、データストアで最新の必要なデータを利用できるようにできます。
アクション
- データを更新します。
- 省略可: データストアにサイトマップベースのインデックス登録と更新がある場合は、サイトマップまたはサイトマップ インデックスを送信して最新の状態に保ちます。データストア インデックスは自動的に更新され、含まれる URL は毎日更新されます。サイトマップベースのインデックス登録と更新について詳しくは、サイトマップを使用してウェブページをインデックス登録、更新するをご覧ください。