Azure SDK for JS 文档智能客户端库 v1.1.0 发布：新增特殊云环境支持

Azure SDK for JS 中的文档智能客户端库(@azure-rest/ai-document-intelligence)是一个强大的工具，它允许开发者轻松地将文档处理能力集成到应用程序中。该库提供了与Azure认知服务中的文档智能API交互的功能，能够从各种文档类型中提取文本、表格、键值对等结构化信息。

在最新发布的1.1.0版本中，该库增加了一个重要功能：对特殊云环境的支持。这一增强使得开发者能够在特定区域的云环境等特殊场景中使用文档智能服务，满足了数据主权和合规性方面的严格要求。

特殊云环境支持详解

在云计算领域，特殊云环境是指专门为满足特定地区的数据驻留、安全性和合规性要求而设计的云环境。Azure提供了多个特殊云实例，包括特定区域的政府云和特定地区的云服务。

新版本通过引入KnownDocumentIntelligenceAudience枚举类型，简化了在这些环境中配置客户端的过程。开发者现在可以明确指定目标云环境的认证范围：

• AzureRegion1：对应特定区域1的云环境，使用https://cognitiveservices.azure.cn作为认证端点
• AzureRegion2：对应特定区域2的政府云，使用https://cognitiveservices.azure.us作为认证端点
• AzurePublicCloud：对应全球公有云，使用https://cognitiveservices.azure.com作为默认端点

使用示例

要在特殊云环境中使用文档智能客户端，开发者只需在创建客户端实例时指定相应的认证范围：

const client = DocumentIntelligence(
  "<cognitive services endpoint>",
  credential,
  { 
    credentials: { 
      scopes: [ KnownDocumentIntelligenceAudience.AzureRegion2 ] 
    } 
  }
);

如果不显式设置scopes参数，库会默认使用公有云的认证端点，确保向后兼容性。

实际应用场景

这一增强功能特别适合以下场景：

1. 特定机构项目：需要遵守严格数据驻留要求的项目可以使用特定区域的政府云，确保所有数据处理都在特定区域内完成。

2. 特定地区业务：在特定地区运营的企业可以使用该地区的云服务，既满足监管要求，又能获得更低的网络延迟。

3. 跨国企业：全球运营的企业可以根据不同地区的合规要求，灵活选择最适合的云环境。

升级建议

对于已经在使用文档智能服务的开发者，如果项目需要迁移到特殊云环境，建议：

1. 更新到1.1.0或更高版本
2. 根据目标环境配置正确的认证范围
3. 测试所有文档处理功能，确保在特殊云环境中正常工作

这一更新体现了Azure SDK团队对开发者需求的快速响应，为在不同合规环境下使用认知服务的用户提供了更多灵活性。随着全球数据治理法规的日益严格，这种多环境支持能力将变得越来越重要。