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