Azure AI 搜索中的预览版功能

2025-09-15

本文介绍公共预览版中的所有数据平面和控制平面功能。参考此列表有助于检查功能状态。它还解释如何调用预览版 REST API。

预览 API 版本是累积的，会汇总到下一预览版。建议始终使用最新的预览 API 来完全访问所有预览功能。

如果预览版功能已停用或转变为正式发布版，它们会从此列表中移除。有关正式发布和停用的公告，请查看服务更新或新增功能。

数据平面预览功能

Feature	类别	说明	可用性
语义配置中的 flightingOptIn 参数	查询	如果搜索服务区域中提供了预发布语义排名模型，则可以选择使用预发布语义排名模型。	创建或更新索引（预览版）。
使用全精度矢量对二进制嵌入进行重新评分矢量查询	相关性（评分）	对于包含量化二进制嵌入的矢量索引，可以使用全精度查询向量重新评分查询结果。查询引擎使用点积进行重新评分，从而提高搜索结果的质量。设置 `enableRescoring` 和 `discardOriginals` 以使用此功能。	创建或更新索引（预览版）。
分面层次结构、聚合和分面筛选器	查询	新的分面查询参数支持嵌套分面。对于数值可分面字段，可以对每个字段的值求和。还可以在维度指定筛选器以添加包含或排除条件。	搜索文档（预览版）。
语义重新排序器中的查询重写	相关性（评分）	可以在语义查询上设置选项，将查询输入重写为经过修订或扩展的查询，以便从 L2 排序器生成更相关的结果。	搜索文档（预览版）。
文档布局技能	应用 AI（技能）	用于分析文档结构并提供结构感知分块的新技能。	创建或更新技能组（预览版）。
Azure AI 技能处理过程的无密钥计费。	应用 AI（技能）	现在可以使用托管身份和角色来实现与 Azure AI 服务的无密钥连接，以处理内置技能。此功能消除了在同一区域中同时提供搜索和 AI 服务的限制。	创建或更新技能组（预览版）。
Markdown 分析模式	索引器数据源	使用此分析模式，索引器可以从 Azure 存储中的 Markdown 文件生成一对一或一对多的搜索文档。	创建或更新索引器（预览版）。
压缩矢量的重新计分选项	相关性（评分）	可以设置选项，以使用原始矢量（而不是压缩矢量）重新评分。适用于使用二进制和标量压缩的 HNSW 和详尽 KNN 矢量算法。	创建或更新索引（预览版）。
解压缩 `@search.score` 以查看混合搜索结果中的子分数	相关性（评分）	可以通过查看最终的合并和评分结果中的各个查询子分数来调查倒数排名融合 (RRF) 排名结果。新的 `debug` 属性会解压缩搜索分数。 `QueryResultDocumentSubscores`、`QueryResultDocumentRerankerInput` 和 `QueryResultDocumentSemanticField` 提供额外的详细信息。	搜索文档（预览版）。
将混合搜索中的目标筛选器限定为矢量查询	查询	混合查询的筛选器涉及请求的所有子查询，无论类型如何。可以替代全局筛选器，以将筛选器范围限定为特定的子查询。新的 `filterOverride` 参数提供行为。	搜索文档（预览版）。
文本拆分技能（标记分块）	应用 AI（技能）	此技能具有新的参数，可改善嵌入模型的数据分块。新的 `unit` 参数可让你指定标记分块。现在可以按标记长度分块，将长度设置为对嵌入模型有意义的值。还可以指定 tokenizer 以及在数据分块期间不应拆分的任何标记。	创建或更新技能组（预览版）。
Azure AI 视觉多模式嵌入技能	应用 AI（技能）	一种新的技能类型，它调用 Azure AI 视觉多模式 API 在编制索引期间为文本或图像生成嵌入。	创建或更新技能组（预览版）。
增量扩充缓存	应用 AI（技能）	将缓存添加到扩充管道。如果有针对性的修改（例如更新技能组或另一对象）不会更改内容，则此功能可让你重复使用现有的输出。缓存仅适用于技能组生成的扩充文档。	创建或更新索引器（预览版）。
Azure 文件存储索引器	索引器数据源	用于 Azure 文件存储的基于索引器索引的新数据源	创建或更新数据源（预览版）。
SharePoint Online 索引器	索引器数据源	用于 SharePoint 内容的基于索引器索引的新数据源。	注册以启用该功能。创建或更新数据源（预览版）或 Azure 门户。
MySQL 索引器	索引器数据源	用于 Azure MySQL 数据源的基于索引器索引的新数据源。	注册以启用该功能。创建或更新数据源（预览版）、.NET SDK 11.2.1 和 Azure 门户。
Azure Cosmos DB for MongoDB 索引器	索引器数据源	通过 Azure Cosmos DB 中的 MongoDB API 的基于索引器索引的新数据源。	注册以启用该功能。创建或更新数据源（预览版）或 Azure 门户。
Azure Cosmos DB for Apache Gremlin 索引器	索引器数据源	通过 Azure Cosmos DB 中的 Apache Gremlin API 的基于索引器索引的新数据源。	注册以启用该功能。创建或更新数据源（预览版）。
本机 blob 软删除	索引器数据源	适用于 Azure Blob 存储索引器。识别处于软删除状态的 blob，并在编制索引过程中删除相应的搜索文档。	创建或更新数据源（预览版）。
重置文档	索引	重新处理了索引器工作负荷中单独选择的搜索文档。	重置文档（预览）。
拼写检查器	查询	对于简单、完整和语义查询的查询字词输入的可选拼写更正。	搜索文档（预览版）。
标准化工具	查询	规范化器提供简单的文本预处理：一致的大小写、删除重音和 ASCII 折叠，无需调用全文分析链。	搜索文档（预览版）。
featuresMode 参数	相关性（评分）	扩展 BM25 相关性分数以包括详细信息：每个字段的相似度分数、每个字段的术语频率，以及每个字段匹配的唯一词元数量。你可以在自定义评分解决方案中使用这些数据点。	搜索文档（预览版）。
vectorQueries.threshold 参数	相关性（评分）	根据最低分数排除低分搜索结果。	搜索文档（预览版）。
hybridSearch.maxTextRecallSize 和 countAndFacetMode 参数	相关性（评分）	通过控制流向混合排名模型的 BM25 排名结果的数量来调整混合查询的输入。	搜索文档（预览版）。
moreLikeThis	查询	查找与特定文档相关的文档。早期预览版中已有此功能。	搜索文档（预览版）。

控制平面预览功能

目前，预览版中没有控制平面功能。

Azure SDK 中的预览功能

每个 Azure SDK 团队根据自己的时间线发布 beta 版本的包。有关 beta 包中的新功能的说明，请查看更改日志：

使用预览功能

实验性功能可先通过预览 REST API 获得，然后通过 Azure 门户和 Azure SDK 获得。

以下声明适用于预览功能：

预览功能根据补充使用条款提供，不附带服务级别协议。
如果需要重新设计，预览功能可能会发生中断性变更。
有时，预览功能并不纳入正式发布版本。

如果针对预览 API 编写代码，则应准备在推出代码时将代码升级到较新的 API 版本。我们会维护升级 REST API文档，以便可更轻松地执行此步骤。

如何调用预览版 REST API

预览 REST API 可以通过 URI 上的 api-version 参数访问。早期预览版仍然可用，但随着时间的推移会过时，不会随新功能或 bug 补丁一起更新。

对于内容上的数据平面操作，2025-08-01-preview 是最新的预览版本。以下示例显示了索引 GET（预览版）的语法：

GET {endpoint}/indexes('{indexName}')?api-version=2024-05-01-Preview

对于搜索服务的管理操作，2025-05-01-preview 是最新的预览版。以下示例显示了 Update Service 2025-05-01-preview 版本的语法。

PATCH https://management.chinacloudapi.cn/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice?api-version=2025-05-01-preview

{
  "tags": {
    "app-name": "My e-commerce app",
    "new-tag": "Adding a new tag"
  },
  "properties": {
    "replicaCount": 2
  }
}

共用方式為