このページでは、汎用レコメンデーション アプリを作成する方法について説明します。
Console
Google Cloud コンソールを使用して汎用レコメンデーション アプリを作成する手順は次のとおりです。
Google Cloud コンソールで、[Agent Builder] ページに移動します。
[アプリ] ページで、[アプリを作成] をクリックします。
[アプリの作成] ページの [レコメンデーション エンジン] で、[作成] をクリックします。
[アプリ名] フィールドに、アプリの名前を入力します。アプリ名の下にアプリ ID が表示されます。
省略可: [編集] をクリックしてアプリ ID を編集します。
[続行] をクリックします。
データストアに接続するには、[データストア] ページで、前に作成したデータストアを選択するか、新しいデータストアを作成します。次のいずれかを行います。
既存のデータストアがある場合は、それを選択します。データストアは 1 つのアプリにのみアタッチでき、後でアプリから削除することはできません。
新しいデータストアを作成し、そこにデータを取り込みます。これを行うには、[データストアを作成] をクリックし、開いた [新しいデータストアを作成] ペインで手順に沿って操作します。次に、新しいデータストアを選択します。データストアの作成の詳細については、汎用レコメンデーション データストアを作成するをご覧ください。
省略可: 使用できないデータストアのリストを表示するには、[理由を確認] をクリックします。
データストアのリストと、使用できない理由が記載された表が表示されます。データストアが使用できない理由としては、次のようなものがあります。
- データストア タイプで接続できるアプリが 1 つだけで、そのデータストアがすでに接続されています。
- データストアとアプリが異なるリージョンにあります。
- データストアとアプリのタイプが異なります。たとえば、メディア データストアを汎用レコメンデーション アプリに接続することはできません。
- データストアには基本的なウェブサイト検索がありますが、汎用レコメンデーション アプリには高度なウェブサイト インデックス登録を備えたデータストアが必要です。
[作成] をクリックします。
REST
コマンドラインを使用してアプリを作成する前に、既存のデータストアが必要です。データストアがない場合は、汎用レコメンデーション データストアを作成するの手順に沿って作成します。
コマンドラインを使用しておすすめアプリを作成する手順は次のとおりです。
データストア ID を確認します。データストア ID がすでにある場合は、次のステップに進みます。
Google Cloud コンソールで [Agent Builder] ページに移動し、ナビゲーション メニューで [データストア] をクリックします。
データストアの名前をクリックします。
データストアの [データ] ページで、データストア ID を取得します。
アプリを作成してデータストアに接続します。データストアは 1 つのアプリにのみアタッチでき、後でアプリから削除することはできません。
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \ -d '{ "displayName": "APP_DISPLAY_NAME", "dataStoreIds": ["DATA_STORE_ID"], "solutionType": ["SOLUTION_TYPE_RECOMMENDATION"], "similarDocumentsConfig": {} }'
以下を置き換えます。
PROJECT_ID
: Google Cloud プロジェクトの ID。APP_ID
: 作成するおすすめアプリの ID。APP_DISPLAY_NAME
: 作成するおすすめアプリの表示名。DATA_STORE_ID
: おすすめアプリに追加する既存のレコメンデーション データストアの ID。
次のステップ
- 推奨事項が表示される様子をプレビューするには、推奨事項を取得するをご覧ください。