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

升级到 Azure AI 搜索中的最新 REST API

使用本文迁移到较新版本的搜索服务 REST API 以及用于数据平面和控制平面操作的搜索管理 REST API。

下面是 REST API 的最新版本：

针对性操作	REST API	地位
数据平面	`2026-04-01`	稳定
数据平面	`2025-11-01-preview`	预览
控制平面	`2025-05-01`	稳定
控制平面	`2026-03-01-preview`	预览

升级说明侧重于代码更改，这些更改帮助您应对以前版本的重大变更，从而确保现有代码在较新的 API 版本上运行效果保持不变。代码按工作顺序运行后，可以决定是否采用较新的功能。若要了解有关新功能的详细信息，请参阅 Azure AI 搜索。

我们建议连续升级 API 版本，并处理每个版本，直到到达最新的版本。

2023-07-01-preview 是第一个用于矢量支持的 REST API。 请勿使用此 API 版本。它现已弃用，应立即迁移到稳定或更新的预览版 REST API。

注意

REST API 参考文档现已实现版本控制。对于特定于版本的内容，请打开参考页，然后使用位于目录上方的选择器选取版本。

何时升级

Azure AI 搜索打破向后兼容性只是作为最后手段。需要升级的情况包括：

代码引用已停用或不受支持的 API 版本，并受一个或多个重大更改的约束。
当 API 响应中返回无法识别的属性时，代码会失败。最佳做法是，应用程序应忽略它无法理解的属性。
代码会保留 API 请求，并尝试将它们重新发送到新的 API 版本。例如，如果应用程序保留从搜索 API 返回的延续令牌（有关详细信息，请在@search.nextPageParameters中查找），则可能会发生这种情况。

如何升级

如果要升级数据平面版本，请查看新 API 版本中已发布的内容。
将 api-version 请求标头中指定的参数更新为较新版本。

在直接调用 REST API 的应用程序代码中，搜索现有版本的所有实例，然后将其替换为新版本。有关构建 REST 调用的详细信息，请参阅快速入门：使用 REST 进行全文搜索。

如果使用Azure SDK，则每个包面向特定版本的 REST API。若要确定包支持的 REST API 版本，请查看其更改日志。更新到最新的包版本，以访问最新的功能和 API 改进。
如果要升级数据平面版本，请查看本文中记录的重大变更并采用解决方法。从代码使用的版本开始，并解决所有较新 API 版本的任何重大变更，直到达到最新稳定版或预览版。

重大更改

以下重大更改适用于数据操作。

智能体检索的重大更改

2026-04-01 是用于代理检索的第一个稳定的 REST API 版本。从 2025-11-01-preview 引入了以下重大变更：

将删除答案合成、查询规划和可配置推理工作。检索仅返回提取的、真实可靠的内容。
检索请求的形状发生变化：messages 被替换为 intents，并且多个参数被重命名或删除。
不支持 Blob 和 OneLake 知识源的文档级权限筛选。

有关属性级更改和迁移步骤的完整列表，请参阅迁移代理检索代码。

知识代理的重大更改

知识代理是在 2025-05-01-preview 中引入的。在 2025-08-01-preview 中，targetIndexes 已被替换为新的知识源对象，且 defaultMaxDocsForReranker 被替换为其他 API。 2025-11-01-preview 中引入了更多重大更改。

有关属性级更改和迁移步骤的完整列表，请参阅迁移代理检索代码。

读取连接信息的客户端代码的中断性变更

自 2024 年 3 月 29 日起生效，适用于所有支持的 REST API：

GET Skillset、 GET Index 和 GET Indexer 不再在响应中返回键或连接属性。如果下游代码从 GET 响应读取密钥或连接（敏感数据），则这是一项重大更改。
如果需要检索搜索服务的管理员或查询 API 密钥，请使用搜索管理 REST API。
如果需要检索另一个Azure资源的连接字符串（例如Azure 存储或Azure Cosmos DB），请使用该资源的 API 和发布的指南获取信息。

语义排名器的重大变动

语义排名器已正式发布。2023-11-01 以下是此前版本中的重大变更：

在所有后续版本中，semanticConfiguration 替换 searchFields 作为用于指定 L2 排名字段的机制。
对于所有 API 版本，2023 年 7 月 14 日对 Microsoft 托管语义模型的更新使语义排名器与语言无关，从而有效地停止使用 queryLanguage 属性。代码中没有“中断性变更”，但该属性将被忽略。

请参阅 “从预览版迁移 ”以转换代码以使用 semanticConfiguration。

数据平面升级

升级指南假定从最新版本升级。如果代码基于旧 API 版本，我们建议通过每个后续版本进行升级，以获取最新版本。

升级至 2026年04月01日

2026-04-01 是最新的稳定 REST API 版本。它促进基于代理的检索、知识源的选择以及多种技术技能和功能的全面可用性。

在升级之前，请检查以下任何 2026-04-01 重大更改是否适用于您的代码：

从 GenAI 提示技能定义中删除六个属性：httpMethod、、timeout、batchSizedegreeOfParallelism、和httpHeadersauthResourceId。在升级之前删除这些属性。仍包含这些属性的定义将返回错误 400 Bad Request 。
智能体检索现在需要自己的计费同意。如果当前已设置 semanticSearch=standard，则必须在升级之前显式设置 knowledgeRetrieval=standard 。有关详细信息，请参阅启用或禁用代理检索计费。
如果你的代理检索代码针对 2025-11-01-preview，2026-04-01 将移除多个预览功能，并围绕意图输入、提取输出和最小推理标准化检索。有关详细信息，请参阅迁移您的代理检索代码。

对于所有其他现有 API，没有任何行为更改。可以在新的 API 版本中交换，代码运行方式与之前相同。

升级到 2025-11-01-preview

2025-11-01-preview 对 2025-08-01-preview 中实现的智能体检索引入了以下重大更改：

将 agents 替换为 knowledgebases。与知识库定义和检索操作相关的多个属性已移出知识库定义。
重构知识源属性，为生成索引器管道的知识源实现一个新 ingestionParameters 对象。

有关属性级更改和迁移步骤的完整列表，请参阅迁移代理检索代码。

对于所有其他现有 API，没有任何行为更改。可以在新的 API 版本中交换，代码运行方式与之前相同。

升级到 2025年09月01日

2025-09-01 是一个稳定的 REST API 版本，正式发布了 OneLake 索引器、文档布局技能以及其他 API 接口。

如果您从2024-07-01升级，并且不使用任何预览功能，则不会有任何重大变更。若要使用新的稳定版本，请更改 API 版本并测试代码。

升级到 2025-08-01 预览版

2025-08-01-preview 对使用 2025-05-01-preview 创建的知识代理引入了以下重大更改：

将 targetIndexes 替换为 knowledgeSources。
删除 defaultMaxDocsForReranker 而无需更换。

否则，现有 API 上没有行为更改。可以在新的 API 版本中交换，代码运行方式与之前相同。

升级到 2025-05-01 预览版

2025-05-01-preview 提供新功能，但现有 API 上没有行为更改。可以在新的 API 版本中交换，代码运行方式与之前相同。

升级到 2025-03-01-preview

2025-03-01-preview 提供新功能，但现有 API 上没有行为更改。可以在新的 API 版本中交换，代码运行方式与之前相同。

升级到 2024-11-01-预览版

2024-11-01-preview 查询重写、文档布局技能、技能处理无密钥计费、Markdown 分析模式以及压缩矢量的重新评分选项。

如果要从 2024-09-01-preview中升级，可以在新的 API 版本中交换，代码运行方式与之前相同。

但是，新版本引入了vectorSearch.compressions的语法更改。

将rerankWithOriginalVectors替换为enableRescoring
将 defaultOversampling 移动到新的 rescoringOptions 属性对象

由于内部 API 映射，保留向后兼容性，但如果采用新的预览版本，我们建议更改语法。有关语法的比较，请参阅使用标量或二进制量化的压缩向量。

升级到 2024-09-01 预览版

2024-09-01-preview 添加了适合 text-embedding-3 模型的俄罗斯套娃表征学习 (MRL) 压缩、用于混合查询的目标矢量筛选、应用于调试的矢量子分数细节，以及适用于文本拆分技能的标记分块。

如果要从 2024-05-01-preview中升级，可以在新的 API 版本中交换，代码运行方式与之前相同。

升级到 2024-07-01

2024-07-01 是常规版本。以前的预览功能现已正式发布：集成的分块和矢量化功能（文本拆分技能、AzureOpenAIEmbedding技能），基于AzureOpenAIEmbedding的查询向量化器，以及矢量压缩功能（标量量化、二进制量化、存储属性、窄数据类型）。

如果从 2024-05-01-preview 升级到稳定版本，則不会发生中断性变更。若要使用新的稳定版本，请更改 API 版本并测试代码。

如果直接从 2023-11-01中升级，则会出现重大变更。请按照每个较新预览中概述的步骤，从2023-11-01迁移到2024-07-01。

升级到 "2024-05-01-preview"

2024-05-01-preview为 Microsoft OneLake、二进制向量和其他嵌入模型添加索引器。

如果要从 2024-03-01-preview中升级，AzureOpenAIEmbedding 技能现在需要模型名称和维度属性。

在代码库中搜索 AzureOpenAIEmbedding 引用。
将 modelName 设置为“text-embedding-ada-002”，将 dimensions 设置为“1536”。

升级到 2024-03-01-预览版

2024-03-01-preview 添加窄数据类型、标量量化和矢量存储选项。

如果是从 2023-10-01-preview 升级，则没有中断性变更。但存在一个行为差异：对于 2023-11-01 及更新的预览版，筛选器表达式的 vectorFilterMode 默认值从后筛选更改为预筛选。

在代码库中搜索对vectorFilterMode的引用。
如果显式设置该属性，则无需执行任何操作。如果依赖于默认值，则新的默认行为是在查询执行之前进行筛选。如果您想进行查询后筛选，请将 vectorFilterMode 显式设置为 postfilter，以保留以前的行为。

升级到 2023-11-01

2023-11-01 是常规版本。以前的预览功能现已正式发布：语义排名器和矢量支持。

从2023-10-01-preview升级没有中断性变更，但从2023-07-01-preview到2023-11-01有多个中断性变更。有关详细信息，请参阅从 2023-07-01-preview 升级。

若要使用新的稳定版本，请更改 API 版本并测试代码。

升级到 2023-10-01-preview

2023-10-01-preview是第一个在索引时添加内置数据分块和矢量化以及内置查询向量化的预览版本。它还支持上一版本中的向量索引和查询。

如果您正在从先前版本升级，下一部分包含步骤。

从 2023-07-01-preview 升级

请勿使用此 API 版本。它实现与任何较新的 API 版本不兼容的矢量查询语法。

2023-07-01-preview 现已弃用，因此不应在此版本上基于新代码，也不应在任何情况下 升级到 此版本。本部分介绍从 2023-07-01-preview 任何较新的 API 版本的迁移路径。

矢量索引的门户升级

Azure门户支持2023-07-01-preview索引的一键式升级路径。它检测矢量字段并提供 “迁移 ”按钮。

迁移路径是从 2023-07-01-preview 到 2024-05-01-preview.
更新仅限于矢量字段定义和矢量搜索算法配置。
更新是单向更新。无法扭转升级。升级索引后，必须使用 2024-05-01-preview 或更高版本来查询索引。

没有用于升级矢量查询语法的门户迁移工具。请参阅代码升级以了解查询语法更改。

在选择 “迁移”之前，请选择 “编辑 JSON ”，首先查看更新的架构。应找到符合代码升级部分中所述更改的架构。门户迁移仅处理具有一个矢量搜索算法配置的索引。它创建了一个默认配置文件，该配置文件映射到2023-07-01-preview 矢量搜索算法。具有多个矢量搜索配置的索引需要手动迁移。

矢量索引和查询的代码升级

创建或更新索引（2023-07-01-preview）中引入了矢量搜索支持。

从 2023-07-01-preview 升级到任意更新的稳定或预览版本需要：

重命名和重组索引中的向量配置
重写矢量查询

请使用本节中的说明从 2023-07-01-preview 迁移矢量字段、配置和查询。

调用 Get Index 以检索现有定义。

修改矢量搜索配置。 2023-11-01 和更高版本引入了 矢量配置文件 的概念，这些配置文件将矢量相关配置捆绑在一个名称下。较新版本也重命名 algorithmConfigurations 为 algorithms。

重命名 algorithmConfigurations 为 algorithms. 这只是数组的重命名。内容向后兼容。这意味着可以使用现有的 HNSW 配置参数。
添加 profiles，为每个项目提供一个名称，并指定一个算法配置。

迁移前（2023-07-01-preview）：

  "vectorSearch": {
    "algorithmConfigurations": [
        {
            "name": "myHnswConfig",
            "kind": "hnsw",
            "hnswParameters": {
                "m": 4,
                "efConstruction": 400,
                "efSearch": 500,
                "metric": "cosine"
            }
        }
    ]}

迁移后（2023-11-01） ：

  "vectorSearch": {
    "algorithms": [
      {
        "name": "myHnswConfig",
        "kind": "hnsw",
        "hnswParameters": {
          "m": 4,
          "efConstruction": 400,
          "efSearch": 500,
          "metric": "cosine"
        }
      }
    ],
    "profiles": [
      {
        "name": "myHnswProfile",
        "algorithm": "myHnswConfig"
      }
    ]
  }

修改矢量字段定义，替换为 vectorSearchConfigurationvectorSearchProfile。请确保配置文件名称解析为新的矢量配置文件定义，而不是算法配置名称。其他矢量字段属性保持不变。例如，它们应该不可筛选、不可排序或不可分面，也不能使用分析器、规范化器或同义词映射。

之前（2023-07-01-preview）：

  {
      "name": "contentVector",
      "type": "Collection(Edm.Single)",
      "key": false,
      "searchable": true,
      "retrievable": true,
      "filterable": false,  
      "sortable": false,  
      "facetable": false,
      "analyzer": "",
      "searchAnalyzer": "",
      "indexAnalyzer": "",
      "normalizer": "",
      "synonymMaps": "", 
      "dimensions": 1536,
      "vectorSearchConfiguration": "myHnswConfig"
  }

之后（2023-11-01） ：

  {
    "name": "contentVector",
    "type": "Collection(Edm.Single)",
    "searchable": true,
    "retrievable": true,
    "filterable": false,  
    "sortable": false,  
    "facetable": false,
    "analyzer": "",
    "searchAnalyzer": "",
    "indexAnalyzer": "",
    "normalizer": "",
    "synonymMaps": "", 
    "dimensions": 1536,
    "vectorSearchProfile": "myHnswProfile"
  }

调用 “创建”或“更新索引 ”发布更改。

修改搜索 POST 以更改查询语法。此 API 更改支持多态矢量查询类型。

重命名 vectors 为 vectorQueries.
对于每个向量查询，请添加 kind，将其设置为 vector。
对于每个向量查询，请重命名 value 为 vector.
（可选）如果使用的是vectorFilterMode，请添加。默认值是2023-10-01之后创建的索引的预筛选。在该日期之前创建的索引仅支持后置筛选，无论如何设置筛选模式。

之前（2023-07-01-preview）：

{
    "search": (this parameter is ignored in vector search),
    "vectors": [
      {
        "value": [
            0.103,
            0.0712,
            0.0852,
            0.1547,
            0.1183
        ],
        "fields": "contentVector",
        "k": 5
      }
    ],
    "select": "title, content, category"
}

之后（2023-11-01） ：

{
  "search": "(this parameter is ignored in vector search)",
  "vectorQueries": [
    {
      "kind": "vector",
      "vector": [
        0.103,
        0.0712,
        0.0852,
        0.1547,
        0.1183
      ],
      "fields": "contentVector",
      "k": 5
    }
  ],
  "vectorFilterMode": "preFilter",
  "select": "title, content, category"
}

这些步骤完成到 2023-11-01 稳定 API 版本或更新预览版 API 版本的迁移。

升级到 2020-06-30

在此版本中，有一个中断性变更和几个行为差异。正式版功能包括：

知识存储是通过技能集创建的扩充内容的持久存储，用于下游应用程序分析和处理。知识存储是通过AZURE AI SEARCH REST API 创建的，但它驻留在Azure 存储中。

破坏性变更

针对早期 API 版本编写的代码，如果包含以下功能，在 2020-06-30 及更高版本上将会中断：

筛选器表达式中的任何Edm.Date字面量（如由年-月-日组成的日期2020-12-12）都必须遵循Edm.DateTimeOffset格式：2020-12-12T00:00:00Z。由于时区差异，需要进行此更改来处理错误或意外的查询结果。

行为更改

BM25 排名算法将以前的排名算法替换为较新的技术。 2019 年之后创建的服务会自动使用此算法。对于较旧的服务，必须设置参数才能使用新算法。
在此版本中，null 值的排序结果发生了更改：如果排序方式是 asc，则 null 值会出现在最前面；如果排序方式是 desc，则 null 值会出现在最后面。如果编写代码来处理 null 值的排序方式，请注意此更改。

升级到 2019-05-06

此 API 版本中正式发布的功能包括：

自动完成是一项自动提示功能，可以完成部分指定的字词输入。
复杂类型在搜索索引中提供对结构化对象数据的原生支持。
JsonLines 分析模式Azure Blob 索引的一部分，为每个 JSON 实体创建一个搜索文档，该文档由换行符分隔。
AI 扩充提供使用 Foundry Tools 的 AI 扩充引擎的索引。

重大更改

当早期 API 版本中编写的代码在 2019-05-06 及更高版本中出现以下功能时，该代码将会中断：

Azure Cosmos DB的 Type 属性。对于以 NoSQL API 为目标的 Azure Cosmos DB 数据源的索引器，请将 "type": "documentdb" 更改为 "type": "cosmosdb"。
如果索引器错误处理包括对属性的 status 引用，则应将其删除。我们从错误响应中删除了状态，因为它不提供有用的信息。
数据源连接字符串不再在响应中返回。从 API 版本 2019-05-06 和 2019-05-06-Preview 开始，数据源 API 在任何 REST 操作的响应中不再返回连接字符串。在以前的 API 版本中，对于通过 POST 创建的数据源，Azure AI 搜索会返回201状态码，接着是 OData 响应，其中包含以纯文本形式显示的连接字符串。
命名实体识别认知技能已停用。如果在代码中调用了名称实体识别技能，调用将失败。替换功能是实体识别技能（V3）。按照弃用技能中的建议迁移到受支持的技能。

升级复杂类型

API 版本 2019-05-06 添加了对复杂类型的正式支持。如果您的代码在 2017-11-11-Preview 或 2016-09-01-Preview 中实现了以前针对复杂类型等效性的建议，需要注意，从版本2019-05-06开始，有一些新的限制和已更改的限制：

已降低每个索引的子字段深度和复杂集合数的限制。如果使用预览版 API 版本创建了超过这些限制的索引，则尝试使用 API 版本 2019-05-06 更新或重新创建索引会失败。如果发现自己处于这种情况，则需要重新设计架构以适应新限制，然后重新生成索引。
从 api 版本 2019-05-06 开始，每个文档的复杂集合的元素数有一个新的限制。如果使用预览 API 版本创建文档超过这些限制的索引，则任何使用 api 版本 2019-05-06 重新编制数据索引的尝试都失败。如果发现自己在这种情况下，需要在重新编制数据索引之前减少每个文档的复杂集合元素数。

有关详细信息，请参阅 Azure AI 搜索。

如何升级旧的复杂类型结构

如果代码将复杂类型用于较旧的预览 API 版本之一，则可能使用的是如下所示的索引定义格式：

{
  "name": "hotels",  
  "fields": [
    { "name": "HotelId", "type": "Edm.String", "key": true, "filterable": true },
    { "name": "HotelName", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": true, "facetable": false },
    { "name": "Description", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "en.microsoft" },
    { "name": "Description_fr", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "fr.microsoft" },
    { "name": "Category", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Tags", "type": "Collection(Edm.String)", "searchable": true, "filterable": true, "sortable": false, "facetable": true, "analyzer": "tagsAnalyzer" },
    { "name": "ParkingIncluded", "type": "Edm.Boolean", "filterable": true, "sortable": true, "facetable": true },
    { "name": "LastRenovationDate", "type": "Edm.DateTimeOffset", "filterable": true, "sortable": true, "facetable": true },
    { "name": "Rating", "type": "Edm.Double", "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address", "type": "Edm.ComplexType" },
    { "name": "Address/StreetAddress", "type": "Edm.String", "filterable": false, "sortable": false, "facetable": false, "searchable": true },
    { "name": "Address/City", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/StateProvince", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/PostalCode", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Address/Country", "type": "Edm.String", "searchable": true, "filterable": true, "sortable": true, "facetable": true },
    { "name": "Location", "type": "Edm.GeographyPoint", "filterable": true, "sortable": true },
    { "name": "Rooms", "type": "Collection(Edm.ComplexType)" }, 
    { "name": "Rooms/Description", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "en.lucene" },
    { "name": "Rooms/Description_fr", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false, "analyzer": "fr.lucene" },
    { "name": "Rooms/Type", "type": "Edm.String", "searchable": true },
    { "name": "Rooms/BaseRate", "type": "Edm.Double", "filterable": true, "facetable": true },
    { "name": "Rooms/BedOptions", "type": "Edm.String", "searchable": true },
    { "name": "Rooms/SleepsCount", "type": "Edm.Int32", "filterable": true, "facetable": true },
    { "name": "Rooms/SmokingAllowed", "type": "Edm.Boolean", "filterable": true, "facetable": true },
    { "name": "Rooms/Tags", "type": "Collection(Edm.String)", "searchable": true, "filterable": true, "facetable": true, "analyzer": "tagsAnalyzer" }
  ]
}

API 版本中 2017-11-11-Preview引入了用于定义索引字段的较新的树状格式。在新格式中，每个复杂字段都有一个字段集合，其中定义了其子字段。在 API 版本 2019-05-06 中，此新格式是独占使用的，并且尝试使用旧格式创建或更新索引将失败。如果索引是使用旧格式创建的，则需要使用 API 版本 2017-11-11-Preview 将其更新为新格式，然后才能使用 API 版本 2019-05-06 对其进行管理。

可以使用 API 版本 2017-11-11-Preview通过以下步骤将平面索引更新为新格式：

执行 GET 请求以检索索引。如果它已采用新格式，那就可以了。
将索引从平面格式转换为新格式。必须为此任务编写代码，因为撰写本文时没有可用的示例代码。
执行 PUT 请求以将索引更新为新格式。避免更改索引的任何其他详细信息，例如字段的可搜索性/可筛选性，因为更新索引 API 不允许更改影响现有索引的物理表达式。

注意

无法从 Azure 门户管理使用旧“平面”格式创建的索引。尽早将索引从“平面”表示形式升级到“树”表示形式。

控制平面升级

适用于：2014-07-31-Preview、 2015-02-28和 2015-08-19

listQueryKeys旧版搜索管理 API 版本的 GET 请求现已弃用。建议迁移到最新的稳定控制平面 API 版本，以使用 listQueryKeys POST 请求。

在现有代码中，将 api-version 参数更改为最新版本（2025-05-01）。

将请求从GET重新配置为POST:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/listQueryKeys?api-version=2025-05-01
Authorization: Bearer {{token}}

如果使用Azure SDK，建议升级到最新版本。

后续步骤

查看搜索 REST API 参考文档。如果遇到问题，请在 Stack Overflow 上寻求帮助或联系支持人员。

搜索服务 REST API 参考

反馈

此页面是否有帮助？

Last updated on 2026-05-12

升级到 Azure AI 搜索 中的最新 REST API

何时升级

如何升级

重大更改

智能体检索的重大更改

知识代理的重大更改

读取连接信息的客户端代码的中断性变更

语义排名器的重大变动

数据平面升级

升级至 2026年04月01日

升级到 2025-11-01-preview

升级到 2025年09月01日

升级到 2025-08-01 预览版

升级到 2025-05-01 预览版

升级到 2025-03-01-preview

升级到 2024-11-01-预览版

升级到 2024-09-01 预览版

升级到 2024-07-01

升级到 "2024-05-01-preview"

升级到 2024-03-01-预览版

升级到 2023-11-01

升级到 2023-10-01-preview

从 2023-07-01-preview 升级

矢量索引的门户升级

矢量索引和查询的代码升级

升级到 2020-06-30

破坏性变更

行为更改

升级到 2019-05-06

重大更改

升级复杂类型

如何升级旧的复杂类型结构

控制平面升级

后续步骤

反馈

其他资源

升级到 Azure AI 搜索中的最新 REST API