Azure AI Search中ChatCompletionSkill的response_format配置异常及EDM类型警告问题求助

兄弟，你这俩问题我之前配置ChatCompletionSkill的时候刚好踩过坑，给你唠唠怎么解决：

一、先搞定response_format的异常问题 #

你现在的核心坑是把OpenAI API的response_format要求和Azure AI Search技能集的配置逻辑搞混了。你直接把完整的JSON Schema塞到response_format里，但实际上：

• ChatCompletionSkill里的response_format只需要指定"type": "json_object"就行，不需要自己写字段级的schema
• 你要的结构化输出（steps数组+answer字符串），得靠prompt指令来约束模型返回格式，同时在技能的outputs里做字段映射

给你贴个我亲测能用的配置片段：

{
  "@odata.type": "#Microsoft.Skills.Text.ChatCompletionSkill",
  "name": "structured-answer-skill",
  "context": "/document",
  "apiKey": "<你的OpenAI密钥>",
  "deploymentName": "<你的GPT部署名称>",
  "messages": [
    {
      "role": "system",
      "content": "请严格按照以下JSON格式返回结果：{\"steps\": [\"推理步骤1\", \"推理步骤2\"], \"answer\": \"最终答案\"}"
    },
    {
      "role": "user",
      "content": "{document.content}"
    }
  ],
  "response_format": {
    "type": "json_object"
  },
  "outputs": [
    {
      "name": "steps",
      "targetName": "document.steps",
      "source": "steps"
    },
    {
      "name": "answer",
      "targetName": "document.answer",
      "source": "answer"
    }
  ]
}

之前的错误提示说你的schema不是object或boolean，就是因为你不该把完整schema塞到response_format里，这个参数只需要告诉模型“返回JSON对象”就行，具体结构靠prompt管。

二、再解决EDM类型找不到的警告 #

这个警告是因为你在定义输出字段的时候，没给Azure AI Search指定它能识别的EDM类型。你得先在索引里把对应的字段类型定义好，再和技能的输出映射上：

比如索引里的字段配置要写成这样：

{
  "fields": [
    // 存储推理步骤的数组字段
    {
      "name": "steps",
      "type": "Collection(Edm.String)",
      "searchable": true,
      "filterable": false
    },
    // 存储最终答案的字符串字段
    {
      "name": "answer",
      "type": "Edm.String",
      "searchable": true,
      "filterable": false
    }
  ]
}

然后确保技能outputs里的targetName和索引的字段名完全对应，这样系统就能识别到正确的EDM类型，警告就消失了。

最后给你补个小技巧：配置完先去Azure AI Search的技能集测试工具跑一遍，看看返回的JSON结构对不对，再同步到索引，能少走好多弯路～

内容来源于stack exchange