Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
本文介绍公共预览版中的所有数据平面和控制平面功能。 参考此列表有助于检查功能状态。 它还解释如何调用预览版 REST API。
预览 API 版本是累积的,会汇总到下一预览版。 建议始终使用最新的预览 API,以便对所有预览功能进行完整访问。
如果预览版功能已停用或转变为正式发布版,它们会从此列表中移除。 有关一般可用性和退役的公告,请参阅 Service Updates 或 新增功能。
数据平面预览功能
| 功能 / 特点 | 说明 | 可用性 |
|---|---|---|
| 代理检索 | 创建由大型语言模型(LLM)提供支持的对话搜索体验。 代理检索将复杂的用户查询分解为子查询,子查询同时运行,结果按相关性重新排序,并提取基础数据或将答案整合为自然语言。 管道涉及一个或多个知识源,通过知识库,其响应有效内容提供对查询计划和引用数据的完全透明。 若要开始,请参阅 Quickstart: Agentic 检索(编程)或 Quickstart: Azure 门户中的 Agentic 检索。 |
Knowledge Sources(预览版)、知识库(预览版)、知识检索(预览版)和Azure portal |
| Purview 索引配置 | 根据源元数据将Microsoft Purview分类和敏感度标签应用于索引内容,以增强数据管理。 | 创建或更新索引 (预览版) |
| 评分函数聚合 | 合并和聚合多个评分函数,实现更复杂的相关性自定义和加权信号组合。 | 创建或更新索引 (预览版) |
| 面聚合 | 使用求和 (sum)、计数 (count)、最小值 (minimum)、最大值 (maximum) 和其他聚合函数,在分面搜索体验中提供增强的分析功能。 | 搜索文档(预览版) |
| 改进了索引器运行时跟踪信息 | 用于搜索服务和特定索引器的累积索引处理信息。 | 获取服务统计信息(预览版)和获取状态 - 索引器(预览版) |
| 矢量查询的严格后期筛选 | 将 strictPostFilter 模式添加到 vectorFilterMode 参数。 指定后,在标识全局前 k 个矢量结果后应用筛选器,确保返回的文档是未筛选结果的子集。 |
搜索文档(预览版) |
| 多维函数支持 | 为单个文档字段中的多个子向量编制索引。 现在可以在复杂集合的嵌套字段中使用矢量类型,从而有效地允许多个向量与单个文档相关联。 | 创建或更新索引 (预览版) |
| 文档级访问控制 | 将 Azure Data Lake Storage (ADLS) Gen2 中 blob 的文档级别权限传递到索引中的可搜索文档。 现在,查询可以根据所选数据源的用户标识筛选结果。 | 创建或更新索引 (预览版) |
| GenAI 提示技能 | 一种能通过你提供的提示连接到大型语言模型(LLM)以获取信息的技能。 使用此技能,可以使用 LLM 中的内容填充可搜索字段。 此技能的主要用例是 图像语言化,使用 LLM 描述图像并将说明发送到索引中的可搜索字段。 | 创建或更新技能集(预览版) |
| 语义配置中的 flightingOptIn 参数 | 如果在搜索服务区域中有可用的预发布语义排名模型,请选择加入使用。 | 创建或更新索引 (预览版) |
| 分面层次结构、聚合和分面筛选器 | 新的分面查询参数支持嵌套分面。 对于数值可分面字段,可以对每个字段的值求和。 还可以在维度指定筛选器以添加包含或排除条件。 | 搜索文档(预览版) |
| 语义重新排序器中的查询重写 | 设置语义查询的选项,以将查询输入重写为修订的或扩展的查询,以便从 L2 排名器生成更相关的结果。 | 搜索文档(预览版) |
| Azure AI 技能处理的免密计费。 | 使用托管标识和角色来实现与 Foundry 工具的无密钥连接,以处理内置技能。 此功能消除了在同一区域中同时具有搜索和 Foundry 工具的限制。 | 创建或更新技能集(预览版) |
| Markdown 分析模式 | 使用此分析模式,索引器可以从 Azure Storage 中的 Markdown 文件生成一对一或一对多搜索文档。 | 创建或更新索引器(预览版) |
| 将混合搜索中的目标筛选器限定为矢量查询 | 混合查询的筛选器涉及请求的所有子查询,无论类型如何。 可以替代全局筛选器,以将筛选器范围限定为特定的子查询。 新的 filterOverride 参数提供行为。 |
搜索文档(预览版) |
| 文本拆分技能(标记分块) | 此技能具有新的参数,可改善嵌入模型的数据分块。 新的 unit 参数可让你指定标记分块。 现在可以按标记长度分块,将长度设置为对嵌入模型有意义的值。 还可以指定 tokenizer 以及在数据分块期间不应拆分的任何标记。 |
创建或更新技能集(预览版) |
| Azure 视觉多模式嵌入能力 | 调用 Azure 视觉多模态 API,在索引过程中为文本或图像生成嵌入向量的技能。 | 创建或更新技能集(预览版) |
| 增量扩充缓存 | 将缓存添加到扩充管道。如果有针对性的修改(例如更新技能组或另一对象)不会更改内容,则此功能可让你重复使用现有的输出。 缓存仅适用于技能组生成的增强文档。 | 创建或更新索引器(预览版) |
| Azure Files索引器 | 使用索引器进行的索引,数据源来自 Azure Files。 | 创建或更新数据源(预览版) |
| MySQL 索引器 | 用于基于索引器索引 Azure MySQL 数据源的数据来源。 | 注册以启用该功能。 创建或更新数据源(预览版)、.NET SDK 11.2.1和Azure portal |
| Azure Cosmos DB for MongoDB 索引器 | 通过 Azure Cosmos DB 中的 MongoDB API 基于索引器的索引的数据源。 | 注册以启用该功能。 创建或更新数据源(预览版)或Azure portal。 |
| Azure Cosmos DB for Apache Gremlin 索引服务 | 在 Azure Cosmos DB 中通过 Apache Gremlin API 使用索引器进行索引的数据源。 | 注册以启用该功能。 创建或更新数据源(预览版)。 |
| 本地 Blob 软删除 | 适用于Azure Blob Storage索引器。 识别处于软删除状态的 blob,并在编制索引过程中删除相应的搜索文档。 | 创建或更新数据源(预览版)。 |
| 重置文档 | 重新处理了索引器工作负荷中单独选择的搜索文档。 | 重置文档(预览)。 |
| 拼写检查器 | 对简单、完整和语义查询中的查询字词输入提供可选的拼写更正。 | 搜索文档(预览版)。 |
| featuresMode 参数 | 扩展 BM25 相关性分数以包括详细信息:每个字段的相似度分数、每个字段的术语频率,以及每个字段匹配的唯一词元数量。 可以在定制的评分解决方案中使用这些数据点。 | 搜索文档(预览版) |
| vectorQueries.threshold 参数 | 根据最低分数排除低分搜索结果。 | 搜索文档(预览版) |
| hybridSearch.maxTextRecallSize 和 countAndFacetMode 参数 | 通过控制流入混合排名模型的由 BM25 排名的结果数量来调整混合查询的输入。 | 搜索文档(预览版) |
| moreLikeThis | 查找与特定文档相关的文档。 早期预览版中已有此功能。 | 搜索文档(预览版) |
控制平面功能预览
目前,预览版中没有控制平面功能。
Azure SDK 中的预览功能
Azure SDK 中的预览功能可通过预览包获得。 若要确定特定包版本中可用的预览功能,请参阅 SDK 的更改日志:
- Azure SDK for .NET 的更改日志
- Azure SDK for Java 的更新日志
- 适用于 JavaScript 的 Azure SDK 变更日志
- Python 版 Azure SDK 的变更日志。
使用预览功能
可以通过预览版 REST API 版本或预览版 SDK 包access实验性功能。 某些功能也可能在Azure portal中提供。 有关可用性的详细信息,请参阅数据平面预览功能和控制平面预览功能。
以下声明适用于预览功能:
- 预览功能根据补充使用条款提供,不附带服务级别协议。
- 如果需要重新设计,预览功能可能发生重大更改。
- 有时,预览功能并不纳入正式发布版本。
如果针对预览 API 编写代码,则应准备在推出代码时将代码升级到较新的 API 版本。我们会维护升级 REST API文档,以便可更轻松地执行此步骤。
如何调用预览版 REST API
预览 REST API 可以通过 URI 上的 api-version 参数访问。 早期预览版仍然可用,但随着时间的推移会过时,不会随新功能或 bug 补丁一起更新。
对于内容上的数据平面操作,2025-11-01-preview 是最新的预览版本。 以下示例显示了索引 GET(预览版)的语法:
GET {endpoint}/indexes('{indexName}')?api-version=2025-11-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
}
}