汎用レコメンデーション アプリを作成する

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

Console

Google Cloud コンソールを使用して汎用レコメンデーション アプリを作成するには、次の操作を行います。

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

    Agent Builder

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

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

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

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

  6. [コンテンツ] で [汎用] が選択されていることを確認します。

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

  8. データストアに接続するには、[データストア] ページで、以前に作成したデータストアを選択するか、新しいデータストアを作成します。次のいずれかを行います。

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

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

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

    データストアのリストと、使用できない理由が記載された表が表示されます。データストアが使用できない理由としては、次のことが考えられます。

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

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

REST

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

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

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

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

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

    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。

次のステップ