Azure OpenAI关联AI Search时URL返回404资源未找到问题排查

核心原因：API端点路径与版本不匹配 #

• 无效的端点路径：你使用的/extensions/chat/completions并非2024-02-15-preview版本支持的聊天类RAG端点。该版本中，关联Azure AI Search的聊天补全功能已整合到标准聊天补全路径中，无需单独的extensions子路径。
• 版本迭代导致的路径废弃：早期预览版本（如2023-07-01-preview）曾提供/extensions/chat/completions路径，但2024-02-15-preview版本调整了RAG架构，废弃了该独立端点，将RAG配置移至请求体参数中。

正确的调用方式 #

使用标准聊天补全路径，通过请求体中的dataSources参数关联Azure AI Search：

1. 有效URL：

   api_base/openai/deployments/gpt-4o-eu2/chat/completions?api-version=2024-02-15-preview
   

2. 请求体示例（需包含聊天消息和搜索配置）：

   {
     "messages": [{"role": "user", "content": "请基于我的知识库回答问题"}],
     "dataSources": [
       {
         "type": "AzureCognitiveSearch",
         "parameters": {
           "endpoint": "你的Azure AI Search服务端点",
           "key": "搜索服务访问密钥",
           "indexName": "目标索引名称"
         }
       }
     ]
   }
   

补充说明 #

你能正常调用的/extensions/completions是针对非聊天场景的文本补全RAG端点，该路径在2024-02-15-preview版本中仍有效，但不适用于聊天类交互的RAG需求。

内容的提问来源于stack exchange，提问作者Shravan K Subrahmanya