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

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

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。

次のステップ