按文档级相关性过滤搜索结果（旧版）

重要提示：Gemini Enterprise 使用 StreamAssist 从助理检索索结果。我们建议您使用 StreamAssist，而不是“搜索和回答”。 如需了解详情，请参阅 使用 StreamAssist 获取搜索结果。

注意：此功能为预览版，受 GCP 服务专用条款中的“非正式版产品使用条款”约束。我们对正式发布前产品和功能的支持可能比较有限，并且对正式发布前产品和功能的更改可能与其他正式发布前版本不兼容。如需了解详情，请参阅 发布阶段说明。 此外，使用此功能，即表示您同意 生成式 AI 预览版条款及条件 （“预览版条款”）。对于此功能，您可以按照 云端数据处理附录中的说明处理个人数据， 但受到协议中的适用限制和义务（如“预览版条款”中所定义）的约束。

在 Gemini Enterprise 应用中搜索时，您可以应用相关性阈值，以便仅返回符合此阈值的文档作为结果。本页面介绍了如何指定相关性阈值，以减少查询返回的文档数量。

关于按文档级相关性过滤

搜索查询返回的每个文档都有一个相关性级别，该级别表示返回的文档与查询的相关性。通过 API 调用发出查询时，您可以设置相关性阈值。设置较高的相关性阈值可以减少查询返回的文档数量。

例如，如果您发现搜索返回的文档太多，但与用户的相关性不足，请将相关性阈值设置为“高”，以便将结果范围缩小到最相关的少数文档。如果“高”设置过于严格，请尝试“中”设置。

**注意**： 此文档级相关性过滤功能不同于可为搜索结果返回的文档相关性得分，并且比后者不精确。

支持文档级相关性过滤的数据类型和应用

文档级相关性过滤条件可以应用于具有以下类型的数据的数据存储区：

• 具有高级网站索引编制功能的网站数据
• 自定义非结构化数据
• 自定义结构化数据

文档级相关性过滤条件不适用于具有基本网站索引编制功能的数据存储区、媒体数据或医疗保健数据。

此外，文档级相关性过滤条件不能与混合搜索应用搭配使用。混合搜索应用是指连接到多个数据存储区的应用。

其他类型的过滤条件

文档级相关性过滤条件并不是过滤查询返回的数据的唯一方法。您还可以使用过滤表达式根据元数据（在具有元数据的数据存储区中的非结构化数据中）和字段值（在结构化数据存储区中）过滤结果。

如需了解相关信息，请参阅使用元数据过滤搜索结果。

如果您同时使用过滤表达式和文档级相关性过滤条件，系统会先将过滤表达式应用于结果，然后再应用文档级相关性过滤条件。

准备工作

确保您已创建应用和数据存储区，并且已将数据提取到数据存储区中。如需了解详情，请参阅创建第一方 应用。另请参阅支持 文档级相关性过滤的数据类型和应用。

按文档级相关性搜索和过滤结果

如需按相关性过滤，请按以下步骤操作：

注意：您可以使用 engines.servingConfigs.search 方法搜索应用，也可以使用 dataStores.servingConfigs.search 方法搜索数据存储区。对于以下步骤，Google 建议使用 engines.servingConfigs.search 方法进行搜索。

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

   1. 在 Google Cloud 控制台中，前往 Gemini Enterprise 页面。

      前往应用

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

2. 如需按文档级相关性过滤搜索结果，请将 relevanceThreshold 字段与 engines.servingConfigs.search 方法搭配使用。

   关键术语：在 Gemini Enterprise 中，“应用”一词在 API 上下文中可以与“引擎”一词 互换使用。Gemini Enterprise 引擎是一种通用搜索引擎，其中 app_type 字段设置为 APP_TYPE_INTRANET。

   curl -X POST -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1alpha/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",
   "query": "QUERY",
   "relevanceThreshold": "RELEVANCE_THRESHOLD"
   }'
   

   替换以下内容：

   • PROJECT_ID：您的项目的 ID。
   • APP_ID：您要查询的应用的 ID。
   • QUERY：要搜索的查询文本。
   • RELEVANCE_THRESHOLD：以下项之一：HIGH、MEDIUM、LOW、LOWEST。

   命令和结果示例

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global/collections/default_collection/engines/my-search-app/servingConfigs/default_search:search" \
   -d '{
   "servingConfig": "projects/my-project-123/locations/global/collections/default_collection/engines/my-search-app/servingConfigs/default_search",
   "query": "What is the check grounding API",
   "relevanceThreshold": "HIGH"
   }'
   
   {
   "results": [
   {
     "id": "a082e70352c073a4443502477255bd2a",
     "document": {
       "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/a082e70352c073a4443502477255bd2a",
       "id": "a082e70352c073a4443502477255bd2a",
       "derivedStructData": {
         "displayLink": "cloud.google.com",
         "link": "https://cloud.google.com/example/docs/check-grounding",
         "htmlTitle": "Check grounding | Example | Google Cloud",
         "title": "Check grounding | Example | Google Cloud"
       }
     }
   }
   ],
   "totalSize": 1,
   "attributionToken": "f_B-CgwIidzwswYQyue15gESJDY2N2M1NmJkLTAwMDAtMjk3Ni1iMGI4LTg4M2QyNGZmNTZhOCIHR0VORVJJQypAjr6dFavEii3b7Ygt3o-aIoCymiLC8J4Vo4CXIra3jC3Usp0V24-aIt7tiC3n7YgtrsSKLeTtiC2DspoixsvzFw",
   "guidedSearchResult": {},
   "summary": {}
   }
   

   此处，相关性阈值设置为“高”，因此仅返回最相关的结果。在此示例中，仅一个文档被确定为高度相关。

3. 使用不同的阈值测试多个查询，以确定最适合您的数据和应用的最佳阈值设置。