Form Recognizer 2.1-preview.3/2.1能否配合Power Skills代码使用

适配性结论 #

Power Skills 完全兼容 Form Recognizer 2.1-preview.3 以及 2.1 正式版，无需重写核心业务逻辑，仅需修改相关配置项即可完成接入。

配置修改步骤 #

1. 核心接口参数调整 #

找到 Power Skill 中存储 Form Recognizer 配置的位置（通常是环境变量、配置文件或技能集的参数配置区），修改以下3个核心参数：

• 将 api-version 参数值从原 2.1-preview.1 替换为目标版本号：若使用预览版填 2.1-preview.3，若使用正式版填 2.1
• 若你单独创建了对应版本的 Form Recognizer 资源，同步替换 endpoint 为新资源的服务端点地址，替换 key 为新资源的访问密钥

2. 字段逻辑适配 #

提示：2.1-preview.3 相较 preview.1 调整了部分返回字段的层级结构和命名，若你的 Power Skill 有自定义的返回字段提取逻辑，需对照对应版本的接口返回结构调整字段映射规则
如果你使用的是官方预构建的 Form Recognizer Power Skill 模板，只需替换版本参数即可，模板已完成版本兼容适配。

3. 认知搜索侧配置更新 #

若该 Power Skill 绑定在 Azure 认知搜索的技能集中使用，需同步更新技能集配置里的对应参数：如果版本参数放在 Power Skill 的调用路径中，修改技能定义的 uri 字段；如果版本参数是通过技能的环境变量传递，更新对应环境变量值即可，配置修改完成后重启索引器生效。

适配验证 #

配置修改完成后，传入测试文档调用 Power Skill 接口，确认返回结果无报错、字段提取正常即代表适配成功。

内容的提问来源于stack exchange，提问作者Mr. code