创建通用推荐应用

本页介绍了如何创建通用推荐应用。

控制台

如需使用 Google Cloud 控制台创建通用推荐应用，请按以下步骤操作：

  1. 在 Google Cloud 控制台中，前往 Agent Builder 页面。

    Agent Builder

  2. 在应用页面上，点击创建应用。

  3. 在创建应用页面上，点击“推荐引擎”下方的创建。

  4. 在您的应用名称字段中，输入应用的名称。应用 ID 显示在引擎名称下方。

  5. 可选：点击修改以修改应用 ID。

  6. 点击继续。

  7. 如需连接到数据存储区，请在数据存储区页面上选择您之前创建的数据存储区，或创建新的数据存储区。执行下列其中一项操作：

    • 选择一个现有的数据存储区（如果有）。一个数据存储区只能附加到一个应用，并且日后无法从该应用中移除。

    • 创建新的数据存储区并将数据注入到其中。为此，请点击创建数据存储区，然后按照打开的创建新的数据存储区窗格中的步骤操作。然后，选择新的数据存储区。如需详细了解如何创建数据存储区，请参阅创建通用推荐数据存储。

  8. 可选：如需查看不可用的存储空间列表，请点击了解原因。

    系统会显示一个表格，其中列出了数据存储区及其不可用的原因。以下是数据存储区可能不可用的一些原因：

    • 您的数据存储区类型仅允许与一个应用关联，并且该数据存储区已关联。
    • 您的数据存储区和应用位于不同的区域。
    • 您的数据存储区和应用的类型不同。例如，您无法将媒体数据存储区连接到通用推荐应用。
    • 您的数据存储区支持基本网站搜索，而通用推荐应用需要具有高级网站索引编制功能的数据存储区。

  9. 点击创建。

REST

在使用命令行创建应用之前，您必须已有现有的数据存储区。如果您没有数据存储区，请按照创建通用推荐数据存储区中的步骤创建一个。

如需使用命令行创建推荐应用，请按以下步骤操作：

  1. 找到您的数据存储区 ID。如果您已拥有数据存储区 ID，请跳至下一步。

    1. 在 Google Cloud 控制台中，前往 Agent Builder 页面，然后在导航菜单中点击数据存储区。

      前往“数据存储区”页面

    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。

后续步骤

  • 如需预览推荐内容的显示方式，请参阅获取推荐。