建立自訂推薦應用程式

控制台

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

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

   AI 應用程式

2. 在「Apps」頁面中，按一下「Create app」。

3. 在「Create App」頁面，點選「Recommendations engine」下方的「Create」。

4. 在「應用程式名稱」欄位中輸入應用程式名稱。應用程式 ID 會顯示在引擎名稱下方。

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

6. 按一下「繼續」。

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

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

   • 建立新的結構化資料儲存庫，並將資料匯入其中。方法是點選「Create data store」(建立資料儲存庫)，然後按照「Create a new data store」(建立新的資料儲存庫) 窗格中的步驟操作。接著選取新的資料儲存庫。如要進一步瞭解如何建立資料儲存庫，請參閱「建立自訂推薦資料儲存庫」。

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

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

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

9. 按一下 [建立]。

REST

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

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

1. 找出資料儲存庫 ID。如果您已取得資料儲存庫 ID，請略過至下一個步驟。

   1. 前往 Google Cloud 控制台的「AI Applications」頁面，然後在導覽選單中按一下「資料儲存庫」。

      前往「資料儲存庫」頁面

   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。