Vertex AI Agent Builder を初めて使用する場合は、Vertex AI Search を使ってみるのチュートリアルに沿ってサンプルアプリを作成することを検討してください。
Google Cloud プロジェクトを設定し、Vertex AI Agent Builder を有効にして、プロジェクトのアクセス制御を設定します。既存の Google Cloud プロジェクトがすでにある場合は、それを使用できます。
操作
- 始める前にを確認し、手順が完了していることを確認します。
検索アプリで利用可能なデータの種類を決定し、Vertex AI Search へのインポート用に準備します。
データストアは、次の種類のデータに基づいて構築できます。
- 非構造化データ。Cloud Storage に保存されているドキュメント（PDF、HTML ファイル、TXT ファイルなど）。必要に応じて、JSON ファイルまたは BigQuery テーブルでメタデータを指定できます。
- 構造化データ。特定のスキーマで提供されるデータ。たとえば、BigQuery テーブル、Cloud Storage の JSON ファイル、Jira などのサードパーティ コネクタからデータを提供できます。
操作
サポートされているデータと、アプリとデータストアの関係については、アプリとデータストアについてをご覧ください。
取り込み用にデータを準備するの要件に従ってデータを準備します。
検索アプリの結果でユーザーが表示できるデータを制限するためにアクセス制御を設定する必要がある場合は、前提条件を確認し、データソースのアクセス制御を使用するで、ご利用の ID プロバイダのタイプとデータソースの手順に沿って操作してください。
データストアを作成してデータをインポートするか、同期されたデータソースとしてサードパーティ コネクタを設定します。
データのインポート方法は、インポート元によって異なります。たとえば、データが Cloud Storage にある場合は、コンソールまたは API を使用して、データのバケット ロケーションを指定してデータをインポートできます。
操作
- 検索データストアを作成するで、データソースの手順に沿って操作します。
Vertex AI Search には、多くの構成オプションがあります。一部のオプションは、検索ウィジェットをデプロイするかどうかによって異なります。
操作
ユースケースと、すぐに使用できる検索ウィジェットをデプロイするか、検索 API 呼び出しを独自のコードに統合するかに応じて、Vertex AI Search にはいくつかの構成オプションがあります。
検索ウィジェットをウェブサイトに埋め込むことができます。ウィジェットには、検索バーと拡張可能な検索インターフェースが自動的に表示されます。検索ウィジェットをデプロイする場合は、以下を構成します。
検索ウィジェットの検索結果。検索ウィジェットの結果を構成するをご覧ください。
検索ウィジェットのファセット（プレビュー）。検索ウィジェットのファセットを構成するをご覧ください。
ウィジェットを使用する代わりに、検索 API 呼び出しをサーバーまたはアプリケーションに統合する場合は、次のオプションを使用して検索設定を構成できます。
フィールド設定。構造化データまたはメタデータを含む非構造化データの場合は、フィールド設定を更新して、Vertex AI Search が検索にメタデータを使用する方法を調整します。検索用のフィールドを構成するをご覧ください。
予測入力。データに応じて、ドキュメントのコンテンツ、フィールド、検索履歴、ユーザー イベントに基づいて予測入力の候補を設定します。予測入力を構成するをご覧ください。
サービス提供コントロール（許可リストを使用したプレビュー版）。検索結果のブースト、非表示化、フィルタ、リダイレクトのタイミングや、特定のクエリを他のクエリに関連付けるかどうかを制御します。サービス提供コントロールを構成するをご覧ください。
検索のチューニング（プレビュー）。独自のトレーニング データを使用して検索モデルをチューニングします。検索チューニングで検索結果を改善するをご覧ください。
カスタム エンベディング（プレビュー）独自のエンベディングを作成した場合は、Vertex AI Search によって生成されたエンベディングではなく、独自のエンベディングを使用して、追加のコンテキストで検索を拡充できます。この機能は、構造化データを含むデータストアまたはメタデータを含む非構造化データストアで使用できます。カスタム エンベディングを使用するをご覧ください。
検索 API 呼び出しを独自のコードに統合してアプリをデプロイする場合は、Vertex AI Search で検索結果の返される方法を構成するための追加オプションが用意されています。
操作
次のオプションを使用して検索結果を構成します。
- 構造化データまたは非構造化データの一般的な検索をフィルタします。
- スニペット、抽出回答、抽出セグメントを取得します。スニペットと抽出されたコンテンツを取得するをご覧ください。
検索アプリのプレビュー バージョンに問題がなければ、ウェブサイトにデプロイしてユーザーと共有します。
操作
検索アプリは、次のいずれかの方法でデプロイできます。
検索ウィジェットをウェブサイトに埋め込みます。Vertex AI Search には、ウェブサイトまたはウェブ アプリケーションにコピーできるコードが用意されています。これにより、検索ウィジェットがデプロイされます。検索結果はコンソールでプレビューできます。ウェブページに検索ウィジェットを追加するをご覧ください。
検索 API 呼び出しをサーバーまたはアプリケーションに統合します。検索結果の表示方法を完全に制御するには、API 呼び出しをサーバーまたはアプリケーションに統合します。API 呼び出しについて詳しくは、検索結果を取得するをご覧ください。クライアント ライブラリのリソースについては、Vertex AI Agent Builder クライアント ライブラリをご覧ください。