通过

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

Azure AI 搜索中的预览版功能

  • 项目

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

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

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

数据平面预览功能

Feature 类别 说明 可用性
Azure AI 视觉多模式嵌入技能 应用 AI（技能） 一种新的技能类型，它调用 Azure AI 视觉多模式 API 在编制索引期间为文本或图像生成嵌入。 创建或更新技能组（预览版）。
Azure 机器学习 (AML) 技能 应用 AI（技能） AML 技能集成了 Azure 机器学习中的推理终结点。 创建或更新技能组（预览版）。 在以前的预览版 API 中，它支持连接到 AML 工作区中部署的自定义模型。 从 2024-05-01-preview 开始，你可以在连接到 Azure AI Studio 模型目录中的嵌入模型的工作流中使用此技能。 如果在同一订阅中部署了 Azure AI 搜索和 Azure 机器学习服务，则门户的技能组设计中也会提供此技能。
增量扩充缓存 应用 AI（技能） 将缓存添加到扩充管道。如果有针对性的修改（例如更新技能集或另一对象）不会更改内容，则此功能可让你重复使用现有的输出。 缓存仅适用于技能集生成的扩充文档。 创建或更新索引器（预览版）。
OneLake 文件索引器 索引器数据源 新的数据源，用于从 OneLake 之上的湖屋中提取可搜索数据和元数据数据 创建或更新数据源（预览版）。
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.azure.com/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
  }
}

另请参阅