汎用検索を使ってみる
Vertex AI Search は、詳細な情報検索、最先端の自然言語処理、最新の大規模言語処理の機能を組み合わせて、ユーザーの意図を理解し、最も関連性の高い検索結果を返します。
Vertex AI Search を使用すると、検索やおすすめ情報を生成するためのアプリを作成できます。Vertex AI Search には、一部の業界（メディア、医療、小売など）向けの特別な機能も用意されています。
このチュートリアルでは、汎用データの検索アプリの作成に焦点を当てます。データは、特定の業種に特化しないものです。
このチュートリアルでは、さまざまな種類のデータを検索するための検索アプリを作成する方法について説明します。
cloud.google.com/generative-ai-app-builder/のクロールから得られたウェブサイトのデータ- Cloud Storage バケットから取り込まれた NDJSON 形式のデータセット形式の構造化データ
- Cloud Storage バケットから取り込まれた PDF 形式の非構造化データ
このチュートリアルに進む前に、始める前にの手順が完了していることを確認してください。
このタスクを Google Cloud コンソールで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
始める前に
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI Agent Builder (Discovery Engine), BigQuery, Cloud Storage APIs.
Vertex AI Agent Builder を有効にする
Google Cloud コンソールで、[Agent Builder] ページに移動します。
利用規約を読んで同意し、[続行して API を有効にする] をクリックします。
データストアを作成
まず、検索アプリがインデックス登録するデータを含むデータストアを作成します。
データストアに格納するデータのタイプ（ウェブサイト、構造化、非構造化）のタブをクリックします。
ウェブサイトのデータ
[
データストアを作成 ] ページに移動します。[データソースを選択] ペインで、[ウェブサイトのコンテンツ] を選択します。
[データストアのウェブサイトを指定] ペインで、[ウェブサイトの高度なインデックス登録] がオフになっていることを確認します。
[追加するサイト] フィールドに、次のように入力します。
cloud.google.com/generative-ai-app-builder/*
[続行] をクリックします。
[データストアの構成] ペインで、データストアのロケーションとして [global (Global)] を選択します。
データストアの名前を入力します。生成された
ID をメモします。メモしておきます。[作成] をクリックします。
構造化データ
[
データストアを作成 ] ページに移動します。[データソースを選択] ペインで、[Cloud Storage] を選択します。
[Cloud Storage のデータをインポート] ペインで、[構造化データ（JSONL）] を選択します。
[ファイル] が選択されていることを確認します。
gs://フィールドに次の値を入力します。cloud-samples-data/gen-app-builder/search/kaggle_movies/movie_metadata.ndjson
この Cloud Storage バケットには、Kaggle から提供される NDJSON 形式の映画のファイルが格納されています。
[続行] をクリックします。
次のようにキープロパティを割り当てます。
フィールド名 キーのプロパティ homepageurioverviewdescription[次へ]をクリックします
[データストアの構成] ペインで、データストアのロケーションとして [global (Global)] を選択します。
データストアの名前を入力します。生成された
ID をメモします。メモしておきます。[作成] をクリックします。
非構造化データ
[
データストアを作成 ] ページに移動します。[データソースを選択] ペインで、[Cloud Storage] を選択します。
[Cloud Storage のデータをインポート] ペインで、[非構造化ドキュメント（PDF、HTML、TXT など）] を選択します。
[フォルダ] が選択されていることを確認します。
gs://フィールドに次の値を入力します。cloud-samples-data/gen-app-builder/search/alphabet-investor-pdfs
この Cloud Storage バケットには、Alphabet 投資家サイトの収益レポートの PDF が含まれています。
[データストアの構成] ペインで、データストアのロケーションとして [global (Global)] を選択します。
データストアの名前を入力します。生成された
ID をメモします。メモしておきます。[作成] をクリックします。
検索アプリを作成する
次に、検索アプリを作成し、先ほど作成したデータストアをリンクします。
ウェブサイトのデータ
[
アプリを作成 ] ページに移動します。[ウェブサイトを検索] で [作成] をクリックします。
[Enterprise エディションの機能] がオンになっていることを確認します。
[
アプリ名 ] フィールドに、アプリの名前を入力します。アプリ名の下にアプリ ID が表示されます。[会社または組織の表示名] フィールドに、会社または組織の名前を入力します。 このチュートリアルでは、アプリが Google Cloud ウェブサイトを検索するため、
Google Cloudを使用できます。アプリのロケーションとして [global (Global)] を選択し、[続行] をクリックします。
データストアのリストで、前に作成したデータストアを選択し、[作成] をクリックします。
アプリの [データ] ページに移動して、インデックスに登録されているウェブサイトのリストを確認し、必要に応じて変更します。
構造化データ
[
アプリを作成 ] ページに移動します。[ウェブサイトを検索] で [作成] をクリックします。
[Enterprise エディションの機能] がオンになっていることを確認します。
[
アプリ名 ] フィールドに、アプリの名前を入力します。アプリ名の下にアプリ ID が表示されます。[会社または組織の表示名] フィールドに、会社または組織の名前を入力します。 このチュートリアルでは、アプリが映画のデータストアを検索するため、
Cymbal Cinemasを使用できます。アプリのロケーションとして [global (Global)] を選択し、[続行] をクリックします。
データストアのリストで、前に作成したデータストアを選択し、[作成] をクリックします。
アプリの [データ] ページで、[アクティビティ] タブをクリックして、データの取り込みのステータスを確認します。インポート プロセスが完了すると、[ステータス] 列に [インポートが完了しました] と表示されます。このデータセットの場合、インポートの完了までに通常 2～3 分かかります。[インポートが完了しました] と表示されない場合は、[更新] をクリックする必要があります。
[ドキュメント] タブをクリックして、インポートされたドキュメントの数を確認します。
非構造化データ
[
アプリを作成 ] ページに移動します。[ウェブサイトを検索] で [作成] をクリックします。
[Enterprise 機能] がオンになっていることを確認します。
[
アプリ名 ] フィールドに、アプリの名前を入力します。アプリ名の下にアプリ ID が表示されます。[会社または組織の表示名] フィールドに、会社または組織の名前を入力します。 このチュートリアルでは、アプリが Alphabet ドキュメントを検索するため、
Alphabetを使用できます。アプリのロケーションとして [global (Global)] を選択し、[続行] をクリックします。
データストアのリストで、前に作成したデータストアを選択し、[作成] をクリックします。
アプリの [データ] ページで、[アクティビティ] タブをクリックして、データの取り込みのステータスを確認します。インポート プロセスが完了すると、[ステータス] 列に [インポートが完了しました] と表示されます。このデータセットの場合、インポート処理には通常 2～3 分かかります。[インポートが完了しました] と表示されない場合は、[更新] をクリックする必要があります。
[ドキュメント] タブをクリックして、インポートされたドキュメントの数を確認します。
アプリをプレビューする
ウェブサイトのデータ
[アプリ] ページで、新しいアプリの名前をクリックします。
ナビゲーション メニューで [
プレビュー ] をクリックし、検索アプリをテストします。省略可: モバイルビューとデスクトップ ビューを切り替えるには、ビューアイコンをクリックします。
検索バーで
Vertex AI Searchを検索して、プロダクトに関する結果を表示します。
構造化データ
[アプリ] ページで、新しいアプリの名前をクリックします。
ナビゲーション メニューで [
プレビュー ] をクリックし、検索アプリをテストします。省略可: モバイルビューとデスクトップ ビューを切り替えるには、ビューアイコンをクリックします。
検索バーに「
trains」と入力し、Enter キーを押して、電車に関連する映画の結果を取得します。
非構造化データ
[アプリ] ページで、新しいアプリの名前をクリックします。
ナビゲーション メニューで [
プレビュー ] をクリックし、検索アプリをテストします。省略可: モバイルビューとデスクトップ ビューを切り替えるには、ビューアイコンをクリックします。
検索バーに「
Google」と入力し、Enter キーを押して結果を確認します。
検索ウィジェットを構成する
ナビゲーション メニューで [構成] をクリックします。
[UI] タブで、検索アプリの設定を構成します。
データ型に応じて、さまざまな UI 構成を使用できます。詳しくは、検索ウィジェットの結果を構成するをご覧ください。
[UI] タブで設定を変更した場合は、[保存して公開] をクリックします。
[予測入力] タブに移動して、予測入力の特定の設定を構成します。
詳細については、予測入力を構成するをご覧ください。
[詳細設定] タブに移動して、高度な機能を構成します。
詳しくは、上級者向け機能についてをご覧ください。
検索アプリをデプロイする
[アプリ] ページで、デプロイするアプリの名前をクリックします。
ナビゲーション メニューで [統合] をクリックします。
[Widget] タブが選択されていることを確認します。
ウィジェットの認証タイプとして [JWT または OAuth ベース] を選択します。
[ドメイン] フィールドに、ウィジェットを配置するウェブページのドメイン名を入力します。たとえば、ウィジェットをウェブページ
example.com/ai.htmlにコピーする場合は、ドメインとして「example.com」と入力します。[Add] をクリックしてから、[Save] をクリックします。
「次のコードをウェブ アプリケーションにコピーする」セクションにあるコード スニペットをコピーします。
コードベースで認証トークンを生成します。
認証トークンをウィジェットに渡すには、[次のコードをウェブ アプリケーションにコピーする] セクションにある「認証トークンを設定する」コード スニペットを使用し、テキスト
<JWT or OAuth token provided by your backend>を認証トークンに置き換えます。デプロイしたアプリをテストします。構成をさらに調整するには、「検索ウィジェットを構成する」の手順に沿って操作します。デプロイされたウィジェットに変更を反映するには、[保存して公開] をクリックしてください。
クリーンアップ
このページで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の手順を行います。
- 不要な Google Cloud 料金が発生しないようにするには、Google Cloud コンソールを使用して、不要なプロジェクトを削除します。
- Vertex AI Agent Builder の学習用に新しいプロジェクトを作成し、そのプロジェクトが不要になった場合は、そのプロジェクトを削除します。
- 既存の Google Cloud プロジェクトを使用した場合は、作成したリソースを削除して、アカウントに課金されないようにします。詳細については、アプリを削除するをご覧ください。
- Vertex AI Agent Builder を無効にするの手順を実行します。