本页面列出了一组适用于 Vertex AI Search for Retail 的互动式教程。这些教程包含可在 Google Cloud Shell 编辑器中运行的操作。借助此工具，您可以直接在浏览器中编写、构建、测试、运行和调试云原生应用。
概览
根据您想要学习的内容尝试不同的教程：
如果您要开始一个项目，请尝试查看导入目录信息教程。在这里，您将学习如何将商品导入清单 例如，尝试不同的搜索功能。接下来，请参阅导入历史用户事件教程。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 中按照此任务的分步指南来执行操作，请点击操作演示：