建立自訂推薦應用程式

本頁說明如何建立自訂推薦應用程式。

控制台

如要使用 Google Cloud 控制台建立自訂推薦應用程式，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「AI Applications」頁面。

    AI 應用程式

  2. 在「應用程式」頁面，按一下「建立應用程式」。

  3. 在「Create App」(建立應用程式) 頁面，點選「Recommendations engine」(推薦引擎) 下方的「Create」(建立)。

  4. 在「Your app name」(您的應用程式名稱) 欄位輸入應用程式的名稱。應用程式 ID 會顯示在引擎名稱下方。

  5. 選用：按一下「編輯」，編輯應用程式 ID。

  6. 按一下「繼續」。

  7. 如要連結至資料儲存庫，請前往「資料儲存庫」頁面，選取含有結構化資料的資料儲存庫，或選擇建立資料儲存庫。執行下列其中一個步驟：

    • 選取現有的資料儲存庫 (如有)。資料儲存庫只能附加至一個應用程式，且之後無法從應用程式中移除。

    • 建立新的結構化資料儲存庫，並將資料擷取至該儲存庫。如要建立資料儲存庫，請點選「建立資料儲存庫」，然後按照開啟的「建立新的資料儲存庫」窗格中的步驟操作。然後選取新的資料儲存庫，如要進一步瞭解如何建立資料儲存庫，請參閱「建立自訂建議資料儲存庫」。

  8. 選用：如要查看無法使用的資料儲存空間清單，請按一下「瞭解原因」。

    系統會顯示表格，列出資料儲存庫和無法使用的原因。以下是資料儲存空間可能無法使用的幾個原因：

    • 您的資料儲存庫類型只能連結至一個應用程式，且資料儲存庫已連結。
    • 資料儲存庫和應用程式位於不同區域。
    • 資料儲存庫和應用程式的類型不同。舉例來說，您無法將媒體資料儲存庫連結至自訂推薦應用程式。
    • 您的資料儲存庫具備基本的網站搜尋功能，但自訂建議應用程式需要具備進階網站索引建立功能的資料儲存庫。

  9. 點選「建立」。

REST

使用指令列建立應用程式前，您必須先有現有的資料存放區。如果沒有資料儲存庫，請按照「建立自訂建議資料儲存庫」一文中的步驟建立。

如要使用指令列建立建議應用程式，請按照下列步驟操作：

  1. 找出資料儲存庫 ID。如果已有資料商店 ID，請跳到下一個步驟。

    1. 前往 Google Cloud 控制台的「AI Applications」頁面，然後在導覽選單中點選「Data Stores」。

      前往「資料儲存庫」頁面

    2. 點按資料儲存庫的名稱。

    3. 在資料儲存庫的「資料」頁面中，取得資料儲存庫 ID。

  2. 建立應用程式，並連結至結構化資料儲存庫。資料儲存庫只能附加至一個應用程式，且之後無法從應用程式中移除。

    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。

後續步驟

  • 如要預覽建議的顯示方式，請參閱「取得建議」。