使用Azure AI Search中AzureOpenAIEmbeddingSkill遇API版本不支持错误求助

出现contains a skill of type 'Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill' which is not supported in this API version.错误的核心原因是你使用的Azure AI Search API版本不兼容该嵌入技能，以下是具体解决步骤：

• 使用兼容的API版本
  Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill是2023年11月推出的新技能，仅支持2023-11-01及更高版本的Azure AI Search REST API。创建或更新技能集时，必须在请求URL中指定该版本，示例：

  POST https://<你的搜索服务名称>.search.windows.net/skillsets/<技能集名称>?api-version=2023-11-01
  

  如果使用SDK开发（如Python的azure-search-documents、.NET的Azure.Search.Documents），需升级到11.5.0及以上版本的SDK包。

• 检查技能类型拼写
  确认技能集定义中的类型字段完全匹配Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill，注意大小写和完整命名空间，避免拼写错误导致的识别失败。

• 验证搜索服务层级
  该嵌入技能仅支持Azure AI Search的标准层（S1/S2/S3）和专用层，免费层（F）不支持此自定义技能，若使用免费层需升级服务层级。

内容的提问来源于stack exchange，提问作者Wyn