カスタム レコメンデーション アプリを作成する

このページでは、カスタム レコメンデーション アプリを作成する方法について説明します。

コンソール

Google Cloud コンソールを使用してカスタム レコメンデーション アプリを作成する手順は次のとおりです。

  1. Google Cloud コンソールで、[AI Applications] ページに移動します。

    AI Applications

  2. [アプリ] ページで、[アプリを作成] をクリックします。

  3. [アプリの作成] ページの [レコメンデーション エンジン] で [作成] をクリックします。

  4. [アプリ名] フィールドに、アプリの名前を入力します。アプリ名の下にアプリ ID が表示されます。

  5. 省略可: [編集] をクリックしてアプリ ID を編集します。

  6. [続行] をクリックします。

  7. データストアに接続するには、[データストア] ページで、構造化データを含むデータストアを選択するか、データストアを作成します。次のいずれかを行います。

    • 既存のデータストアがある場合は、それを選択します。データストアは 1 つのアプリにのみアタッチでき、後でアプリから削除することはできません。

    • 新しい構造化データストアを作成し、データを取り込みます。これを行うには、[データストアを作成] をクリックし、開いた [新しいデータストアを作成] ペインで手順に沿って操作します。次に、新しいデータストアを選択します。データストアの作成の詳細については、カスタム レコメンデーション データストアを作成するをご覧ください。

  8. 省略可: 利用できないデータストアのリストを表示するには、[理由を確認] をクリックします。

    データストアのリストと、データストアが使用できない理由を示す表が表示されます。データストアが使用できない理由としては、次のものがあります。

    • データストア タイプで接続できるアプリが 1 つだけで、そのデータストアがすでに接続されています。
    • データストアとアプリが異なるリージョンにあります。
    • データストアとアプリのタイプが異なる。たとえば、メディア データストアをカスタム レコメンデーション アプリに接続することはできません。
    • データストアには基本的なウェブサイト検索が含まれていますが、カスタム レコメンデーション アプリにはウェブサイトの高度なインデックス登録を備えたデータストアが必要です。

  9. [作成] をクリックします。

REST

コマンドラインを使用してアプリを作成する前に、既存のデータストアが必要です。データストアがない場合は、カスタム レコメンデーション データストアを作成するの手順に沿って作成します。

コマンドラインを使用してレコメンデーション アプリを作成する手順は次のとおりです。

  1. データストア ID を確認します。データストア ID がすでにある場合は、次のステップに進みます。

    1. Google Cloud コンソールで、[AI アプリケーション] ページに移動し、ナビゲーション メニューで [データストア] をクリックします。

      [データストア] ページに移動

    2. データストアの名前をクリックします。

    3. データストアの [データ] ページで、データストア ID を取得します。

  2. アプリを作成し、構造化データストアに接続します。データストアは 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。

次のステップ