你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 Azure AI 搜索中创建语义查询

项目
02/20/2024

在本文中，了解如何对结果集调用语义排名，从而将语义上最相关的结果提升到堆栈顶部。还可以获取语义标题，其中突出显示了最相关的术语和短语，以及语义答案。

先决条件

一项搜索服务，位于基本层或更高层级，且已启用语义排序。
具有语义配置的现有搜索索引和富文本内容。
如果需要该功能的简介，请查看语义排名。

注意

标题和答案会从搜索文档的文本中逐字提取。语义子系统使用计算机阅读理解来识别具有标题或答案特征的内容，但不会撰写新句子或短语。出于此原因，包含解释或定义的内容最适用于语义排名。如果希望与生成的响应进行聊天式交互，请参阅检索增强生成 (RAG)。

选择客户端

选择一个支持语义排名的搜索客户端。提供以下选择：

避免绕过相关性评分的功能

Azure AI 搜索中的多个查询功能绕过了相关性评分，否则就会与语义排名不兼容。如果你的查询逻辑包含以下功能，则无法对结果进行语义排名：

包含 search=* 或空搜索字符串的查询（例如纯筛选器查询）将不起作用，因为没有任何内容可供度量语义相关性。查询必须提供可在处理过程中评估的词语或短语。
使用完整 Lucene 语法 (queryType=full) 编写的查询与语义排名 (queryType=semantic) 不兼容。语义模型不支持完整的 Lucene 语法。
对特定字段进行排序（orderBy 子句）会覆盖搜索分数和语义分数。鉴于语义分数应该用于提供排名，如果你对有序结果应用语义排名，添加 orderby 子句会导致 HTTP 400 错误。

设置查询

在此步骤中，将参数添加到查询请求。若要成功，查询应是全文搜索（使用 search 参数传入字符串），并且索引应包含具有丰富语义内容的文本字段和一个语义配置。

搜索资源管理器包括语义排序的选项。

登录 Azure 门户。
打开搜索索引并选择“搜索资源管理器”。
选择“查询选项”。如果已定义语义配置，则默认选择该配置。如果未定义，请为索引创建语义配置。
输入查询，如“拥有美食的历史酒店”，然后选择“搜索”。

或者，选择 JSON 视图并将定义粘贴到查询编辑器中：

下面是可以粘贴到视图中的一些 JSON 文本：

 {
     "queryType": "semantic",
     "search": "historic hotel with good food",
     "semanticConfiguration": "my-semantic-config",
     "answers": "extractive|count-3",
     "captions": "extractive|highlight-true",
     "highlightPreTag": "<strong>",
     "highlightPostTag": "</strong>",
     "select": "HotelId,HotelName,Description,Category",
     "count": true
 }

使用搜索文档表述请求。

响应自动包括 @search.rerankerScore。如果希望响应中提供标题或答案，请向请求添加标题和答案。

本部分中的以下示例使用 hotels-sample-index 演示带有语义答案和标题的语义排名。

将以下请求作为模板粘贴到 Web 客户端中。将服务名称和索引名称替换为有效值。

POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/search?api-version=2023-11-01      
{
    "queryType": "semantic",
    "search": "newer hotel near the water with a great restaurant",
    "semanticConfiguration": "my-semantic-config",
    "answers": "extractive|count-3",
    "captions": "extractive|highlight-true",
    "highlightPreTag": "<strong>",
    "highlightPostTag": "</strong>",
    "select": "HotelId,HotelName,Description,Category",
    "count": true
}

将“queryType”设置为“semantic”。

在其他查询中，“queryType”用于指定查询分析程序。在语义排名中，它设置为“semantic”。对于“search”字段，可以指定符合简单语法的查询。
根据简单语法将“search”设置为全文搜索查询。语义排名是全文搜索的扩展，因此，尽管此参数不是必需的，但如果此参数为 null，则不会获得预期结果。
将“semanticConfiguration”设置为嵌入索引中的预定义语义配置。
设置“answers”以指定结果中是否包含语义答案。目前，此参数唯一的有效值为 extractive。可以将答案配置为最多返回 10 个。默认值为 1。此示例显示了三个答案的计数：extractive|count-3。

不能保证每个请求都能得到答案。要获取答案，查询必须类似于问题，并且内容必须包含类似于答案的文本。
设置“captions”以指定结果中是否包含语义标题。目前，此参数唯一的有效值为 extractive。标题可配置为在带或不带突出显示效果的情况下返回结果。默认设置是返回突出显示效果。此示例返回不带突出显示效果的标题：extractive|highlight-false。

标题和答案的基础是“semanticConfiguration”中引用的字段。这些字段处于一个组合限制之下：不得超出 2000 个标记或大约 20000 个字符。如果预计标记计数超过此限制，请考虑执行一个使用文本拆分技能的数据分块步骤。此方法引入了对 AI 扩充管道和索引器的依赖关系。
如果要覆盖应用于标题的默认突出显示格式，请设置“highlightPreTag”和“highlightPostTag”。

标题对文档中汇总响应的关键段落应用突出显示格式。默认为 <em>。若要指定格式类型（例如，黄色背景），可以设置 highlightPreTag 和 highlightPostTag。
设置“select”以指定响应中返回的字段，并设置“count”以返回索引中的匹配项数。这些参数会提高请求的质量和响应的可读性。
发送请求以执行查询并返回结果。

使用 QueryType 或 SemanticQuery 对语义查询调用语义排序。以下示例来自 Azure SDK 团队。

SearchResults<Hotel> response = await searchClient.SearchAsync<Hotel>(
    "Is there any hotel located on the main commercial artery of the city in the heart of New York?",
    new SearchOptions
    {
        SemanticSearch = new()
        {
            SemanticConfigurationName = "my-semantic-config",
            QueryCaption = new(QueryCaptionType.Extractive),
            QueryAnswer = new(QueryAnswerType.Extractive)
        },
        QueryLanguage = QueryLanguage.EnUs,
        QueryType = SearchQueryType.Semantic
    });

int count = 0;
Console.WriteLine($"Semantic Search Results:");

Console.WriteLine($"\nQuery Answer:");
foreach (QueryAnswerResult result in response.SemanticSearch.Answers)
{
    Console.WriteLine($"Answer Highlights: {result.Highlights}");
    Console.WriteLine($"Answer Text: {result.Text}");
}

await foreach (SearchResult<Hotel> result in response.GetResultsAsync())
{
    count++;
    Hotel doc = result.Document;
    Console.WriteLine($"{doc.HotelId}: {doc.HotelName}");

    if (result.SemanticSearch.Captions != null)
    {
        var caption = result.SemanticSearch.Captions.FirstOrDefault();
        if (caption.Highlights != null && caption.Highlights != "")
        {
            Console.WriteLine($"Caption Highlights: {caption.Highlights}");
        }
        else
        {
            Console.WriteLine($"Caption Text: {caption.Text}");
        }
    }
}
Console.WriteLine($"Total number of search results:{count}");

评估响应

只有最初结果中的前 50 个匹配项可以进行语义排序。与所有查询一样，响应由标记为可检索的所有字段组成，或仅仅由 select 参数中列出的那些字段组成。响应包括原始相关性分数，还可能包括计数或批处理结果，具体取决于你的请求的表述方式。

在语义排名中，响应包含更多元素：一个在语义上排名的新相关性分数、一个可选标题（纯文本或带有突出显示效果），以及一个可选答案。如果结果不包含这些额外元素，则表示查询可能配置错误。作为解决问题的第一步，请检查语义配置，以确保在索引定义和查询中都指定了它。

在客户端应用中，可以将搜索页面构建为包含一个标题作为匹配项的说明，而不是包含特定字段的全部内容。此方法在“搜索结果”页的各个字段过于密集时很有用。

上述示例查询的响应将返回以下匹配项作为首选项。返回标题是因为设置了“captions”属性，具有纯文本和突出显示的版本。示例中省略了答案，因为无法为此特定查询和语料库确定答案。

"@odata.count": 35,
"@search.answers": [],
"value": [
    {
        "@search.score": 1.8810667,
        "@search.rerankerScore": 1.1446577133610845,
        "@search.captions": [
            {
                "text": "Oceanside Resort. Luxury. New Luxury Hotel. Be the first to stay. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.",
                "highlights": "<strong>Oceanside Resort.</strong> Luxury. New Luxury Hotel. Be the first to stay.<strong> Bay</strong> views from every room, location near the pier, rooftop pool, waterfront dining & more."
            }
        ],
        "HotelName": "Oceanside Resort",
        "Description": "New Luxury Hotel. Be the first to stay. Bay views from every room, location near the pier, rooftop pool, waterfront dining & more.",
        "Category": "Luxury"
    },
  ...
]

后续步骤

语义排序可用于将关键字搜索和矢量搜索合并到单个请求和统一响应的混合查询。

使用语义排序的混合查询