AKS部署自定义Document Intelligence容器无法访问云端训练模型问题

核心问题 #

日志报错SubscriptionId could not be found以及无法列出云端自定义模型，根源在于你的自定义模板容器缺少访问云端Document Intelligence资源的关键配置，导致容器无法连接云端模型管理接口，也无法解析订阅ID。

修复步骤 #

需要在自定义模板容器的环境变量配置中添加以下两项：

1. 配置云端资源端点 #

添加AzureCognitiveServiceResourceEndpoint环境变量，值为团队使用的云端Document Intelligence资源完整端点，让容器明确要连接的云端资源地址。

2. 开启外部模型访问权限 #

添加AllowExternalModelAccess环境变量并设置为true，允许容器访问云端训练的外部模型。

修改后的YAML配置片段 #

在容器的env节点下新增这两个变量：

env:
  # 保留原有环境变量
  - name: AzureCognitiveServiceLayoutHost
    value: http://layout:5000
  - name: Logging__Console__LogLevel__Default
    value: Debug
  # ... 其他原有配置 ...
  # 新增以下配置项
  - name: AzureCognitiveServiceResourceEndpoint
    valueFrom:
      secretKeyRef:
        name: docintelsecrets
        key: resourceendpoint # 对应云端Document Intelligence资源端点的密钥
  - name: AllowExternalModelAccess
    value: "true"

额外检查点 #

• 确认BILLING环境变量的端点格式正确，应为云端资源的计费端点（通常与AzureCognitiveServiceResourceEndpoint值一致，无需额外路径）。
• 确认APIKEY是对应云端资源的有效密钥，且该密钥拥有访问自定义模型的权限。

更新配置并重启容器后，调用/formrecognizer/documentModels接口即可列出云端训练的自定义模型。

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