本页面列出了一组适用于零售业的 Vertex AI Search 的交互式教程。这些教程包括可在 Google Cloud Shell Editor 中运行的操作。借助此工具，您可以直接从浏览器编写、构建、测试、运行和调试云原生应用。
概览
根据您想学习的内容，尝试使用不同的教程：
如果您要启动项目，请尝试学习导入目录信息教程。在这里，您将学习如何将商品导入清单中以便试用，例如试用不同的搜索功能。接下来，请参阅导入历史用户事件教程。Vertex AI Search for Retail 使用用户事件生成初始推荐和搜索结果。然后，尝试学习记录实时用户事件教程。实时用户事件可提供优质且相关的结果。
如果您希望了解搜索的一般工作原理，请参阅搜索教程。
如果您想了解如何使用服务配置和控件来配置搜索，请尝试学习以下教程：
如果您需要更新目录信息，请参阅管理目录信息教程。
如果您想要了解如何更新目录，请参阅更新搜索目录教程。
如果您想要了解如何记录、查看或移除实时用户事件，请参阅记录实时用户事件教程。
如果您打算使用推荐功能，请参阅关于导入和管理目录和用户事件的教程。
导入清单信息
这些教程介绍了如何导入目录信息并及时更新目录。
从 BigQuery 导入目录数据
本教程介绍了如何使用 BigQuery 表不受限制地导入大量清单数据。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
从 Cloud Storage 导入清单数据
本教程介绍了如何将大量商品导入清单。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
以内嵌方式导入清单数据
本教程介绍了如何以内嵌方式将商品导入清单中。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
管理目录信息
这些教程介绍了如何在导入清单后管理商品信息。您可以读取、写入和删除目录中的商品。
了解如何使用您选择的语言调用 API。
教程：创建/获取/更新/删除商品
本教程介绍了如何使用用于执行以下操作的 API 方法：
- 创建商品
- 获取商品
- 更新商品
- 删除商品
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：创建商品
本教程介绍了如何创建单件商品。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：获取商品
本教程介绍了如何检索商品。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：更新商品
本教程介绍了如何更新清单中的商品。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：删除商品
本教程介绍了如何从清单中删除商品。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
导入历史用户事件
这些教程介绍了如何从过往事件批量导入用户事件数据。模型需要用户事件数据才能进行训练。
教程：从 Cloud Storage 导入事件
本教程介绍如何从 Cloud Storage 导入用户事件。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：从 BigQuery 导入事件
本教程介绍如何从 BigQuery 导入用户事件。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
导入事件内嵌教程
本教程介绍了如何以内嵌方式导入用户事件数据。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
记录实时用户事件
这些教程介绍了如何记录、查看或移除实时用户事件。适用于零售业的 Vertex AI Search 使用实时用户事件生成商品推荐和搜索结果。记录尽可能多的类型的用户事件和有效的商品信息可以提高结果质量。
教程：写入用户事件
本教程介绍如何使用 userEvents.write 方法记录用户事件。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：重新联接用户事件
本教程介绍如何通过向 userEvents:rejoin 端点发出 POST 请求来重新联接用户事件。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：移除用户事件
本教程介绍了如何完全清除用户事件。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
搜索教程
search() 方法用于根据搜索查询和其他参数（例如过滤条件、商品详情或 order_by）来搜索目录。
默认情况下，搜索响应包含按相关性排序的合理数量的结果。
教程：查询
本教程介绍了如何发送简单的搜索查询并分析响应。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：分页
本教程介绍了如何在搜索请求中控制分页。买家在商店中搜索商品时，可以改进在搜索结果中的导航方式。例如，他们可以使用页面大小功能限制搜索响应中的项目数量，或使用偏移功能跳转到他们首选的页面。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：查询扩展
本教程介绍了如何启用查询扩展功能。买家使用含糊不清或包含多个字词的搜索词组时，可能会收到空响应。启用查询扩展后，系统会对请求进行分析，并返回根据解析的搜索查询展开的商品列表。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：过滤
本教程演示了过滤功能。它可让您根据自己或客户的需求微调搜索请求。您可以按单个或多个字段进行过滤，也可以按文本字段和/或数字字段进行过滤。您可以使用表达式语言为每个字段构造谓词，也可以使用逻辑运算符来组合不同的表达式。例如，正在寻找鞋子的买家可以使用过滤条件将搜索范围缩小到他们喜欢的品牌和颜色。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：排序
本教程介绍了如何对搜索响应中的商品进行排序。当买家在您的网站上搜索商品时，您可以显示按多个字段排序的结果。例如，购物者正在搜索价格和折扣最优惠的连衣裙。此处为价格和折扣为多个字段。买家看到的是按价格排序的连衣裙，以及价格相同的连衣裙（按折扣排序）。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：升位
本教程展示了在搜索结果中提升商品的一些示例。借助提升功能，您可以对商品应用提升优先级，以便提升该商品在搜索结果中的优先级。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：重定向控件
本教程介绍了如何使用重定向控件。通过重定向控件，您可以指定在用户使用特定搜索查询时将他们重定向到的网址。例如，如果用户请求使用“可持续制造的商品”，您可以将他们重定向到包含您所合作的环保品牌的网页。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
更新搜索广告资源
虽然使用 Product 创建、读取、更新和删除 (CRUD) 方法可广泛修改 Product 的属性，但有一组 Product 方法可用于用于更新具有不同粒度级别的商品目录特定字段。以下 Product 字段被视为商品目录字段：
Product.price_infoProduct.availabilityProduct.available_quantityProduct.fulfillment_info
教程：添加履单信息
本教程介绍了如何使用 AddFulfillmentPlaces 方法更新商品履单信息。这样一来，搜索结果可以显示有货商品和履单的最新动态。例如，某位购物者在商店里寻找蓝色牛仔裤，但目前缺货。在该商店或任何其他商店有牛仔裤有货的那一刻，买家会看到相应动态，可以继续下单。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：移除履单
本教程介绍了如何使用 RemoveFulfillmentPlaces 方法更新商品履单信息。这样，在商品无货和无法履行订单的情况下，搜索结果就可以显示最新动态。例如，一位买家正在一家商店寻找蓝色牛仔裤。如果这家店的牛仔裤缺货，买家会看到此情况，无法继续下单。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：
教程：设置商品目录
本教程介绍如何使用 SetInventory 方法推送商品目录更新，而不是更新整个商品。
如需直接在 Cloud Shell Editor 中按照此任务的分步指南操作，请点击操作演示：