Vertex AI Search を初めて使用する場合は、メディア検索を使ってみるのクイックスタート チュートリアルに沿ってサンプルアプリを作成することを検討してください。
Google Cloud プロジェクトを設定し、Vertex AI Agent Builder を有効にして、プロジェクトのアクセス制御を設定します。既存の Google Cloud プロジェクトがすでにある場合は、それを使用できます。
操作
- 始める前にの手順を完了します。
Vertex AI Search へのインポート用にデータを準備します。
メディア検索アプリは、次のデータを使用します。
構造化メディアデータ。必須。メディア コンテンツに関するメタデータ情報（タイトル、説明、URI など）をメディアの場所にアップロードします。Vertex AI Search には、メディアの事前定義スキーマが用意されています。独自のスキーマを使用することもできます。
ユーザー イベント。省略可ですが、強く推奨します。 ユーザー イベントを記録すると、検索結果のランキングが向上します。
操作
メディアデータとデータストアに関する情報を確認し、メディア ドキュメントとデータストアについてで、必要なスキーマとフィールドに従ってデータを準備します。独自のスキーマを使用している場合は、JSON オブジェクトとしてのスキーマの例と構造化データもご覧ください。
ユーザー イベントについてで、メディア ユーザー イベントの要件を確認します。
アプリとデータストアを作成してから、メディアデータをインポートします。
メディアデータのインポート方法は、インポート元によって異なります。たとえば、データが Cloud Storage にある場合は、コンソールまたは API を使用して、データのバケット ロケーションを指定してデータをインポートできます。
メディア検索アプリでは、ユーザー イベントの使用をおすすめしますが、必須ではありません。
操作
メディア データストアを作成します。
メディアアプリを作成します。
過去のユーザー イベントを一括インポートして、アプリでトレーニングを開始できるようにします。
Vertex AI Search には、多くの構成オプションがあります。一部のオプションは、検索ウィジェットをデプロイするかどうかによって異なります。
操作
ユースケースと、すぐに使用できる検索ウィジェットをデプロイするか、検索 API 呼び出しを独自のコードに統合するかに応じて、Vertex AI Search にはいくつかの構成オプションがあります。
検索ウィジェットをウェブサイトに埋め込むと、検索バーと拡張可能な検索インターフェースが自動的に提供されます。検索ウィジェットをデプロイする場合は、以下を構成します。
検索ウィジェットの検索結果。検索ウィジェットの結果を構成するをご覧ください。
検索ウィジェットのファセット。検索ウィジェットのファセットを構成するをご覧ください。
ウィジェットを使用する代わりに、検索 API 呼び出しをサーバーまたはアプリケーションに統合する場合は、次のオプションを使用して検索設定を構成できます。
フィールド設定。構造化データまたはメタデータを含む非構造化データの場合は、フィールド設定を更新して、Vertex AI Search が検索にメタデータを使用する方法を調整します。検索用のフィールドを構成するをご覧ください。
予測入力。データに応じて、ドキュメントのコンテンツ、フィールド、検索履歴、ユーザー イベントに基づいて予測入力の候補を設定します。予測入力を構成するをご覧ください。
サービス提供コントロール（許可リストありのプレビュー）。検索結果のブースト、非表示化、フィルタ、リダイレクトのタイミングや、特定のクエリを他のクエリに関連付けるかどうかを制御します。検索のサービス提供コントロールを構成するをご覧ください。
入力逐次検索。アプリでテレビのリモコンなどの使いづらい入力デバイスを使用している場合は、入力逐次検索機能を有効にできます。メディアアプリの入力逐次検索を取得するをご覧ください。
メディア検索アプリのプレビュー バージョンに問題がなければ、ウェブサイトにデプロイしてユーザーと共有します。
操作
検索アプリは、次のいずれかの方法でデプロイできます。
検索ウィジェットをウェブサイトに埋め込みます。Vertex AI Search には、ウェブサイトまたはウェブ アプリケーションにコピーできるコードが用意されています。これにより、検索ウィジェットがデプロイされます。検索結果はコンソールでプレビューできます。ウェブページに検索ウィジェットを追加するをご覧ください。
検索 API 呼び出しをサーバーまたはアプリケーションに統合します。検索結果の表示方法を完全に制御するには、API 呼び出しをサーバーまたはアプリケーションに統合します。API 呼び出しについて詳しくは、検索結果を取得するをご覧ください。クライアント ライブラリのリソースについては、Vertex AI Agent Builder クライアント ライブラリをご覧ください。