AzureOpenAIEmbeddingSkill区域API端点配置异常求助

核心结论 #

Azure OpenAI Embedding Skill要求的resourceUri必须是你的Azure OpenAI资源专属端点：https://<your-openai-resource-name>.openai.azure.com，区域通用认知服务端点（如https://francecentral.api.cognitive.microsoft.com）不被技能集的验证逻辑支持，这是设计要求而非Bug。

专属端点执行报错的排查方向 #

你遇到的"Access denied"错误并非端点格式问题，而是以下细节配置错误导致：

• 确认密钥正确性：必须使用Azure OpenAI资源的密钥（在OpenAI资源的「密钥和端点」页面获取），不要混淆AI搜索、认知服务的密钥。
• 检查网络访问限制：如果OpenAI资源设置了防火墙/VNet限制，需确保AI搜索资源能访问它：
  • 在OpenAI资源的「网络」设置中，添加AI搜索的服务标签Microsoft.Search/searchServices到允许列表；
  • 或把AI搜索的公网IP加入OpenAI的防火墙允许范围。
• 核对部署名称：技能集配置里的deploymentName必须和OpenAI中部署的ada-embedding模型名称完全一致（区分大小写），比如部署的是text-embedding-ada-002就不能填ada-embedding。
• 指定正确API版本：如果手动编写REST配置，需在技能的parameters中添加apiVersion字段，比如"apiVersion": "2023-05-15"（ada-002模型要求此版本及以上）。

手动调用专属端点的正确方式 #

之前手动curl报错大概率是请求路径或参数错误，正确的请求格式如下：

curl https://<your-resource-name>.openai.azure.com/openai/deployments/<your-deployment-name>/embeddings?api-version=2023-05-15 \
  -H "Content-Type: application/json" \
  -H "api-key: <your-openai-resource-key>" \
  -d '{"input": "测试文本"}'

门户配置报错的解决 #

如果从门户下拉选择资源仍报错，尝试：

• 刷新门户页面，清除浏览器缓存；
• 使用拥有Azure OpenAI资源「Contributor」或「Reader」权限的账号登录配置。

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