获取个性化的浏览结果

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

浏览简介

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

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

  • 在搜索请求中使用过滤条件可缩小搜索结果范围。如果您使用的是高级网站索引,请参阅使用结构化数据进行高级网站索引,了解如何在架构中添加元数据,以及如何使用元数据丰富过滤条件和提升字段。
  • 添加提升规范,通过提升或隐藏特定结果来影响返回结果的顺序。
  • 了解用户事件并进行记录。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 响应的 JSON 响应。 响应包含按搜索请求中设置的字段确定的顺序列出的明细搜索结果。