如何将Azure Blob Storage自定义元数据映射到AzureOpenAI对话数据索引

一、将Azure Blob元数据映射到AI Search索引字段的方法 #

要解决data_quality字段显示为null的问题，需按以下步骤配置索引器的字段映射：

1. 确认索引字段定义
   在Azure AI Search索引中，确保data_quality字段的类型为Edm.String（与Blob元数据的字符串值匹配），且字段开启检索、过滤权限（后续排序/过滤逻辑需要）。

2. 配置索引器的字段映射规则
   找到关联Blob存储的Azure AI Search索引器，添加字段映射规则：

   • 源字段：使用表达式 $metadata['data_quality']（注意Blob存储会自动将元数据键转为小写，需与实际存储的键完全一致）
   • 目标字段：索引中的data_quality字段
     示例配置（JSON片段）：

   {
     "fieldMappings": [
       {
         "sourceFieldName": "$metadata['data_quality']",
         "targetFieldName": "data_quality"
       }
     ]
   }
   

3. 重新运行索引器
   保存索引器配置后，手动触发一次索引器运行，让它重新抓取Blob文档的元数据并更新索引。运行完成后，再通过Search Explorer查看data_quality字段，即可看到对应的值。

4. 排查常见问题

   • 核对Blob存储的元数据键拼写，避免大小写或字符错误
   • 确认索引器使用的身份（托管身份/连接字符串）拥有读取Blob元数据的权限
   • 查看索引器运行日志，排查是否存在元数据读取失败的报错信息

二、索引更新后与Azure OpenAI对话实例的关联处理 #

不需要重新创建Blob连接或对话实例，只需完成以下操作：

1. 等待索引器运行完成，确认data_quality字段已正确填充数据
2. 在Azure OpenAI Studio的「对话数据」配置中，确认当前绑定的是更新后的AI Search索引（若索引名称未变更，无需重新连接）
3. 在对话的检索配置中添加优先级逻辑：
   • 设置排序规则：将data_quality设为排序字段，自定义排序顺序（Gold优先，其次是Silver，最后是Under approval）
   • 或配置多级检索策略：先查询data_quality eq 'Gold'的文档，若无结果再 fallback 到其他质量等级的文档

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