Azure AI 搜索中的预览版功能

项目
09/01/2024

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

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

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

数据平面预览功能

Feature	类别	说明	可用性
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，并在编制索引过程中删除相应的搜索文档。	创建或更新数据源（预览版）。
重置文档	索引	重新处理了索引器工作负载中单独选择的搜索文档。	重置文档（预览）。
拼写检查器	查询	对于简单、完整和语义查询的查询字词输入的可选拼写更正。	搜索文档（预览版）。
Normalizers	查询	规范化器提供简单的文本预处理：一致的大小写、删除重音和 ASCII 折叠，无需调用全文分析链。	搜索文档（预览版）。
featuresMode 参数	相关性（评分）	展开相关性分数以显示详细信息：单字段相似度得分、单字段术语频率，以及单字段匹配的唯一标记数。你可以在自定义评分解决方案中使用这些数据点。	搜索文档（预览版）。
vectorQueries.threshold 参数	相关性（评分）	根据最低分数排除低分搜索结果。	搜索文档（预览版）。
hybridSearch.maxTextRecallSize 和 countAndFacetMode 参数	相关性（评分）	通过控制流向混合排名模型的 BM25 排名结果的数量来调整混合查询的输入。	搜索文档（预览版）。
moreLikeThis	查询	查找与特定文档相关的文档。早期预览版中已有此功能。	搜索文档（预览版）。

控制平面预览功能

Feature	类别	说明	可用性
在用户分配的托管标识下搜索服务	服务	配置搜索服务以使用之前创建的用户分配的托管标识。	服务 - 更新、2021-04-01-preview 或最新预览版本。建议使用最新的预览版版本。

Azure SDK 中的预览功能

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

使用预览功能

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

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

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

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

如何调用预览版 REST API

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

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

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

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

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

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

通过