本页面介绍了实体、其使用方式和原因。
对于大多数使用场景，用于零售业的 Vertex AI Search 不需要实体。但是，通过单个商品清单服务多个品牌或区域的零售商如果使用实体，可以获得更好的成效。
概览
如果在项目中设置多个实体，则可以考虑位于不同区域或国家的买家的不同行为和偏好，或者买家在贵公司旗下不同品牌的网站购物。
示例用例：两个国家/地区
示例组织在美国和加拿大都有网络业务。
示例组织希望提供浏览和搜索结果以及自动补全建议，并将两个国家/地区的买家之间的差异考虑在内。因此，示例组织指定了两个实体：org_us 和 org_ca。
系统使用实体值标记用户事件，具体取决于买家访问的网站（.com 或 ca）。当买家发出搜索请求时，该实体值便会包含在请求中。
7 月是这两个国家的重要节日。设置实体后，当买家在 Example Organization 网站上搜索 July 时，美国购物者将首先看到美国国庆节主题商品，而加拿大买家会收到加拿大国庆节主题商品。
同样，针对加拿大买家的推荐更有可能展示加拿大国庆日商品，而不是美国国庆节（7 月 4 日）对应的商品。
应用场景示例：获客
Enterprise Example Organization 最近收购了 Startup Example Organization。 目录已合并，但初创公司品牌和网站由于拥有忠实的粉丝群而得以保留。
该企业创建了一个实体 startup 来标记源自 Startup 网站的用户事件。这样，系统向 Startup 网站提供的搜索、浏览、自动补全和推荐建议就可以考虑到初创公司网站买家的偏好。
多个项目还是多个实体？
为零售业设置 Vertex AI Search 时，您可以在同一项目中使用不同的项目或不同实体，以获取针对不同买家群体的不同建议。
对于某些应用，需要单独的项目。对于其他应用，设置实体是更好的解决方案。
在以下情况下请使用实体：
实体之间完全或部分共享的目录
以下一项或多项：
同一国家/地区或语言区域内的多个品牌 - 例如，您拥有原始品牌和后购的品牌
google_home和nest。同一国家/地区的多个区域，例如
enterprise_east和enterprise_west。一个品牌，但在多个国家/地区使用同一语言，例如
brand_us和brand_ca。
在以下情况下，请使用单独的项目（而非实体）：
无法组合的目录，或者组合后几乎没有重叠的目录。
要求使用不同语言的实体。每个项目只能使用一种语言。
用户事件和实体
如需利用实体功能，请将实体字段添加到您的用户事件。
对于搜索和自动补全功能：在
search类型的用户事件中包含entity字段。在其他用户事件类型中包含实体字段有助于排查问题，但不会影响搜索或自动补全响应的质量。
对于建议：请在尽可能多的用户事件中包含实体字段。
通常，需要 30 到 90 天的用户事件数据，实体特征会返回最佳建议。
如果请求中缺少某个实体，则请求不会假定结果中的该实体。您将获得一个平均结果，该结果基于指定实体和未指定实体的用户事件得出。
搜索和实体
如需获取考虑了该实体的搜索或浏览结果，请执行以下操作：
在搜索用户事件 (
eventType="search") 中包含entity字段。如需查看示例，请参阅搜索用户事件的完整对象示例。将
entity字段添加到您的搜索请求。如需了解如何发出搜索请求，请参阅获取搜索结果。
自动补全和实体
如需获取考虑了该实体的自动补全结果，请执行以下操作：
建议和实体
将 entity 字段添加到您的用户事件后，无需执行进一步操作即可利用实体进行推荐。这是因为实体值是用户事件的一部分，该事件又包含在对 predict 方法的调用中。