获取个性化的浏览结果

浏览功能使用导航方法来显示与最终用户所选类别或过滤条件相符的搜索结果。浏览会返回可个性化的结果。 本页介绍了如何获取通用搜索数据存储区的浏览结果。

关于浏览

在 AI 应用搜索应用中，浏览是指不使用查询或使用空查询进行搜索。如果您有包含结构化数据、带有元数据的非结构化数据或网站数据的宽泛搜索数据存储区，则可以发送空搜索查询来接收浏览结果。

当您发送浏览请求时，数据存储区中与过滤条件匹配的文档会根据基于事件的信号返回。您可以通过以下方式提供增强的浏览体验：

  • 在搜索请求中使用过滤条件来缩小搜索结果范围。如果您使用高级网站索引，请参阅使用结构化数据进行高级网站索引，了解如何在架构中添加元数据并使用它来丰富过滤条件和提升字段。
  • 添加提升规范，通过提升或隐藏特定结果来影响返回结果的顺序。
  • 了解用户事件并记录它们。Google 会使用您的用户事件来优化结果排名，以提高点击率。

下表列出了搜索和浏览之间的区别。

功能 搜索 浏览
用途 查找特定信息 探索和发现内容
示例 在 Google 搜索中搜索“温哥华最好的韩国餐厅” 根据餐厅可能所属的类别（例如“餐厅 > 韩式 > 温哥华 > 4 星级及以上”）浏览餐厅
用户意图 通常以目标为导向 探索性
起点 通常位于搜索栏中的查询或关键字 通常使用菜单、面包屑、链接或其他导航方法（例如分面）的特定网站或平台
方法 输入关键字或短语，并应用搜索和投放配置 使用空查询进行搜索，应用搜索和服务配置
结果 相关结果列表 数据存储区中与过滤条件匹配的所有文档

获取包含网站数据的应用的浏览结果

如需使用 API 获取包含网站数据的应用的浏览结果，

  1. 查找应用 ID。如果您已拥有应用 ID，请跳到下一步。

    1. 在 Google Cloud 控制台中，前往 AI Applications 页面。

      前往“应用”

    2. 在应用页面上，找到应用的名称，并从 ID 列获取应用的 ID。

  2. 使用空查询或不使用查询来调用 engines.servingConfigs.search 方法，如下所示：

    REST

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"orderBy": "ORDER_BY",
"params": {
     "searchType": "0"
 },
"filter": "FILTER",
"boostSpec": "BOOST_SPEC",
}'

    替换以下内容：

    • PROJECT_ID：您的 Google Cloud 项目的 ID。
    • APP_ID：要查询的 Vertex AI Search 应用的 ID。
    • ORDER_BY：可选。结果的排列顺序。要排序的属性必须具有数值解释，例如 date。如需了解详情，请参阅对网页搜索结果进行排序。
    • FILTER：可选，但建议填写。一个文本字段，用于使用过滤表达式过滤搜索结果。默认值为空字符串。如需详细了解如何使用 filter 字段，请参阅过滤结构化或非结构化数据的通用搜索和过滤网站搜索。
    • BOOST_SPEC：可选。用于提升或隐藏文档的规范。值：
      • BOOST：[-1,1] 范围内的浮点数。如果该值为负值，则结果会被降级（显示在结果中更靠下的位置）。如果值为正，则结果会获得提升（显示在结果中更靠上的位置）。
      • CONDITION：用于选择应用加权的文档的文本过滤表达式。过滤条件的计算结果必须为布尔值。 如需了解如何提升结构化搜索的搜索结果，请参阅提升搜索结果。

    您应该会收到类似以下截断的 JSON 响应。 响应包含按搜索请求中设置的字段确定的顺序列出的分项搜索结果。