开始使用一般性推荐

您可以基于自己的数据快速构建先进的一般性推荐应用，该应用可以推荐与用户当前正在查看的内容类似的内容。

本教程介绍如何创建三个一般性推荐应用，分别用于不同的数据类型：

  • 从 Cloud Storage 存储桶注入的 PDF 格式的非结构化数据
  • 从 Cloud Storage 存储桶注入的 NDJSON 格式的结构化数据
  • 来自您提供的网址的网站数据

在学习本教程之前，确保您已完成准备工作中的步骤。

如需在 Google Cloud 控制台中直接遵循有关此任务的分步指导，请点击操作演示：

操作演示

准备工作

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI Agent Builder, Cloud Storage APIs.

    Enable the APIs

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI Agent Builder, Cloud Storage APIs.

    Enable the APIs

    8.

启用 Vertex AI Agent Builder

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

    Agent Builder

  2. 阅读并同意服务条款，然后点击继续并激活 API。

创建数据存储区

本过程将指导您创建数据存储区并上传提供的示例数据。点击要创建的数据存储区类型对应的标签页。

网站数据

  1. 前往数据存储区页面。

  2. 点击创建数据存储区。

  3. 在选择数据源页面上，选择网站内容。

  4. 在指定数据存储区的网站页面上，输入要包含在推荐应用中的网站网址。请在每行输入一个网址，不加英文逗号分隔符。

  5. 点击继续。

  6. 在配置数据存储区页面上，输入数据存储区的显示名称，然后点击创建。

  7. 在数据存储区页面上，选择新的数据存储区，然后点击创建以创建应用。

  8. 在数据页面上，转到活动标签页以查看数据注入的状态。导入过程完成后，状态列中会显示导入已完成。您可能需要点击刷新才能看到导入已完成。

  9. 点击文档标签页以查看导入的文档。

结构化数据

  1. 前往数据存储区页面。

  2. 点击创建数据存储区。

  3. 在选择数据源页面上，选择 Cloud Storage。

  4. 在从 Cloud Storage 导入数据页面上，选择结构化数据 (JSONL)。

  5. 点击文件。

  6. 在 gs:// 字段中，输入以下值：

    cloud-samples-data/gen-app-builder/search/kaggle_movies/movie_metadata.ndjson

    此 Cloud Storage 存储桶包含由 Kaggle 提供的 NDJSON 格式的电影文件。

  7. 点击继续。

  8. 分配键属性，如下所示：

    字段名称 关键属性
    homepage uri
    original_title title
    overview description

    然后点击继续。

  9. 输入数据存储区的显示名称，然后点击创建。

  10. 点击您的数据存储区的名称。

  11. 在数据页面上，转到活动标签页以查看数据注入的状态。导入过程完成后，状态列中会显示导入已完成。对于此数据集，该过程通常需要两到三分钟。您可能需要点击刷新才能看到导入已完成。

  12. 点击文档标签页以查看导入的文档。

非结构化数据

  1. 前往数据存储区页面。

  2. 点击创建数据存储区。

  3. 在选择数据源页面上，选择 Cloud Storage。

  4. 在从 Cloud Storage 导入数据页面上，确保已选择文件夹。

  5. 在 gs:// 字段中，输入以下值：

    cloud-samples-data/gen-app-builder/search/alphabet-investor-pdfs

    此 Cloud Storage 存储桶包含来自 Alphabet 投资者网站的收入报告 PDF 文件。

  6. 选择非结构化文档，然后点击继续。

  7. 输入数据存储区的名称，然后点击创建。

  8. 选择您刚刚创建的数据存储区，然后点击创建以创建应用。

  9. 在数据存储区的数据页面上，转到活动标签页以查看数据注入的状态。导入过程完成后，状态列中会显示导入已完成。对于此数据集，该过程通常需要两到三分钟。您可能需要点击刷新才能看到导入已完成。

  10. 点击文档标签页以查看导入的文档。

创建应用

接下来，您将创建一个推荐应用并关联之前创建的数据存储区。

  1. 前往应用页面。

  2. 点击创建应用。

  3. 在创建应用页面上，选择推荐。

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

  5. 在内容下方，确保已选择通用。

  6. 点击继续。

  7. 在数据存储区列表中，选择您之前创建的数据存储区。

  8. 点击创建。

预览应用

网站数据

  1. 在导航菜单中，点击预览以测试应用。

  2. 点击 URI 字段。系统会显示来自您网站的网址列表。

  3. 点击您要针对其进行推荐的网页的网址。或者，在网址字段中输入您网站的网址。

  4. 点击获取推荐。系统会显示推荐网页的网址列表。

  5. 点击某个网址即可查看网页。

结构化数据

  1. 在导航菜单中，点击预览以测试应用。

  2. 如果您看到“您将能够在此处预览您的推荐引擎。我们仍在准备您的引擎，请稍后再回来查看”消息，请等待并定期刷新页面。您可能需要等待几个小时或直到第二天才能预览数据。

  3. 点击文档 ID 字段。系统会显示文档 ID 列表。

  4. 点击您要获取推荐的文档的 ID。或者，在文档 ID 字段中输入文档 ID。

  5. 点击获取推荐。系统会显示推荐的文档列表。

  6. 点击所需文档即可获取其详细信息。

非结构化数据

  1. 在导航菜单中，点击预览以测试应用。

  2. 点击文档 ID 字段。系统会显示文档 ID 列表。

  3. 点击您要获取推荐的文档的 ID。或者，在文档 ID 字段中输入文档 ID。

  4. 点击获取推荐。系统会显示推荐的文档列表。

  5. 点击所需文档即可获取其详细信息。

部署应用

没有用于部署应用的推荐 widget。如需在部署之前测试应用，请执行以下操作：

  1. 转到数据页面，然后复制一个文档 ID。

  2. 转到集成页面。此页面包含 REST API 中 servingConfigs.recommend 方法的示例命令。

  3. 将您之前复制的文档 ID 粘贴到文档 ID 字段中。

  4. 将用户伪 ID 字段保留为原样。

  5. 复制示例请求并在 Cloud Shell 中运行它。

    结果是根据您选择的文档推荐的文档的 ID。

如需有关将推荐应用集成到 Web 应用的帮助，请参阅 C#、Go、Java、Node.js、PHP 和 Ruby 语言的代码示例（获取应用的推荐）。

清理

为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用，请按照以下步骤操作。

  1. 为避免产生不必要的 Google Cloud 费用，请使用 Google Cloud 控制台删除您不需要的项目。
  2. 如果您为了解 Vertex AI Agent Builder 创建了一个新项目，但现在不再需要该项目，请删除项目。
  3. 如果您使用的是现有 Google Cloud 项目，请删除您创建的资源，以避免账号产生费用。 如需了解详情，请参阅删除实例。
  4. 按照关闭 Vertex AI Agent Builder 中的步骤操作。

后续步骤