实体

本页介绍了实体，以及实体的使用方式和原因。

对于大多数用例，Vertex AI Search for Retail 不需要实体。不过，如果零售商通过单个商品目录销售多个品牌或面向多个区域销售商品，则可以使用实体来获得更好的结果。

概览

在项目中设置多个实体是一种方法，可考虑位于不同区域或国家/地区的买家或在您企业旗下不同品牌网站上购物的买家的不同行为和偏好。

零售商 Example Organization 在美国和加拿大都有网站。

示例组织希望根据这两个国家/地区购物者之间的差异，提供浏览和搜索结果以及自动补全建议。因此，“示例组织”指定了两个实体：org_us 和 org_ca。

用户事件会带有实体值标记，具体取决于买家访问的网站（.com 或 ca）。当买家发出搜索请求时，请求中会包含实体值。

这两个国家/地区在 7 月份都有重要的节日，但节日不同。设置实体后，当购物者在“示例组织”网站上搜索 July 时，系统会先向美国购物者展示以美国国庆日为主题的商品，然后再向加拿大购物者展示以加拿大国庆日为主题的商品。

同样，面向加拿大买家的推荐商品更有可能是加拿大国庆日商品，而不是美国独立日商品。

Enterprise Example Organization 最近收购了 Startup Example Organization。目录已合并，但由于新兴品牌和网站拥有忠实的粉丝，因此会保留。

企业创建实体 startup 来为来自 Startup 网站的用户事件添加标记。这样，面向新手网站提供的搜索、浏览、自动补全和推荐建议便可考虑新手网站买家的偏好。

设置 Retail Search 时，您可以使用不同的项目或同一项目中的不同实体，为不同的购物者群体获取不同的建议。

对于某些应用，需要单独的项目。对于其他应用，设置实体是更好的解决方案。

在以下情况下，请使用实体：

实体之间完全或部分共享的清单
以下一项或多项：
- 在同一国家/地区或语言区域内拥有多个品牌，例如，您有原始品牌 google_home 和收购的品牌 nest。
- 同一国家/地区的多个区域，例如 enterprise_east 和 enterprise_west。
- 一个品牌，但在多个国家/地区销售，且使用相同的语言，例如 brand_us 和 brand_ca。

在以下情况下，请使用单独的项目，而不是实体：

如需使用实体功能，请将实体字段添加到用户事件中。

搜索和自动补全：在类型为 search 的用户事件中添加 entity 字段。

在其他用户事件类型中添加实体字段有助于排查问题，但不会影响搜索或自动补全响应的质量。
对于推荐：请在尽可能多的用户事件类型中添加实体字段。

通常，实体功能需要 30 到 90 天的用户事件数据才能返回最佳建议。

如果请求中缺少实体，则该请求不会对结果中的实体做出任何假设。您将获得一个平均结果，该结果基于包含和不包含指定实体的用户事件。

如需获取会考虑实体的搜索或浏览结果，请执行以下操作：

如需获取会考虑实体的自动补全结果，请执行以下操作：

将 entity 字段添加到用户事件后，您无需执行进一步操作，即可利用实体生成推荐。这是因为实体值是用户事件的一部分，而用户事件又包含在对 predict 方法的调用中。