你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

SDK 目标:REST API v2.1 (GA)

文档智能复选标记 REST API 版本 v2.1 (GA) 21-06-08

Foundry Tools 中的 Azure 文档智能是一项云服务,它使用机器学习分析文档中的文本和结构化数据。 文档智能软件开发工具包 (SDK) 是一组库和工具,可用于轻松地将文档智能模型和功能集成到应用程序中。 文档智能 SDK 可用于采用 C#/.NET、Java、JavaScript 和 Python 编程语言的平台。

支持的编程语言

文档智能 SDK 支持以下语言和平台:

语言 → 文档智能 SDK 版本 支持的 API 版本 平台支持
.NET/C# → 3.1.x (GA) NuGet v2.1 Windows、macOS、Linux、Docker
Java → 3.1.x (GA) Maven 存储库 v2.1 Windows、macOS、Linux
JavaScript → 3.1.0 (GA) npm v2.1 Browser、Windows、macOS、Linux
Python → 3.1.0 (GA) PyPI v2.1
Windows、macOS、Linux

有关其他 SDK 版本的详细信息,请参阅:

支持的客户端

语言 SDK 版本 API 版本 支持的客户端
.NET/C#
Java
JavaScript
3.1.x v2.1(默认)
v2.0
FormRecognizerClient
FormTrainingClient
.NET/C#
Java
JavaScript
3.0.x v2.0 FormRecognizerClient
FormTrainingClient
Python 3.1.x v2.1(默认)
v2.0
FormRecognizerClient
FormTrainingClient
Python 3.0.0 v2.0 FormRecognizerClient
FormTrainingClient

在应用程序中使用文档智能 SDK

借助文档智能 SDK,可以在应用程序中使用和管理文档智能服务。 SDK 基于底层文档智能 REST API,允许在编程语言范例中轻松使用这些 API。 以下介绍如何为首选语言使用文档智能 SDK:

1. 安装 SDK 客户端库

dotnet add package Azure.AI.FormRecognizer --version 3.1.0
Install-Package Azure.AI.FormRecognizer -Version 3.1.0

2. 将 SDK 客户端库导入应用程序

using Azure;
using Azure.AI.FormRecognizer.Models;

3. 设置身份验证

可以使用两种受支持的身份验证方法。

使用 API 密钥

以下是在 Azure 门户中查找文档智能 API 密钥的位置:

该屏幕截图显示了 Azure 门户中密钥和终结点的位置。

重要

我们建议使用 Azure 资源的托管标识进行 Microsoft Entra ID 身份验证,以避免将凭据随云中运行的应用程序一起存储。

请谨慎使用 API 密钥。 请不要直接在代码中包含 API 密钥,并且切勿公开发布该密钥。 如果使用 API 密钥,请将其安全地存储在 Azure Key Vault 中,定期轮换密钥,并使用基于角色的访问控制和网络访问限制来限制对 Azure Key Vault 的访问。 若要详细了解如何在应用中安全地使用 API 密钥,请参阅 API 密钥与 Azure 密钥保管库

有关 Azure AI 服务安全性的详细信息,请参阅对 Azure AI 服务的请求进行身份验证


//set `<your-endpoint>` and `<your-key>` variables with the values from the Azure portal to create your `AzureKeyCredential` and `FormRecognizerClient` instance
  string key = "<your-key>";
  string endpoint = "<your-endpoint>";
  FormRecognizerClient client = new FormRecognizerClient(new Uri(endpoint), new AzureKeyCredential(key));

使用 Microsoft Entra 令牌凭据

注意

区域终结点不支持 Microsoft Entra 身份验证。 为资源创建自定义子域,以使用此类身份验证。

使用 DefaultAzureCredential 是进行授权的最简单方式。 它根据运行环境提供默认令牌凭据,可处理大多数 Azure 身份验证方案。

以下是为 .NET 应用程序获取和使用 DefaultAzureCredential 的方法:

  1. 安装适用于 .NET 的 Azure 标识库

        dotnet add package Azure.Identity
    
        Install-Package Azure.Identity
    
  2. 注册 Microsoft Entra 应用程序并创建新的服务主体

  3. 通过将 Cognitive Services User 角色分配给服务主体来授予文档智能访问权限。

  4. 将 Microsoft Entra 应用程序中的客户端 ID、租户 ID 和客户端机密值分别设置为环境变量:AZURE_CLIENT_IDAZURE_TENANT_IDAZURE_CLIENT_SECRET

  5. 创建 FormRecognizerClient 实例,包括 DefaultAzureCredential

    string endpoint = "<your-endpoint>";
    var client = new FormRecognizerClient(new Uri(endpoint), new DefaultAzureCredential());
    

有关详细信息,请参阅对客户端进行身份验证

4. 生成应用程序

创建客户端对象以与文档智能 SDK 交互,然后调用该客户端对象上的方法来与服务交互。 SDK 提供同步和异步方法。 有关详细信息,请使用所选语言尝试快速入门

帮助选项

开发人员社区可以在Microsoft 问答Stack Overflow论坛上提出和回答有关 Azure 文档智能和其他服务的问题。 Microsoft 会监视论坛并回复社区尚未回答的问题。 为确保我们看到你的问题,请将其标记为 azure-form-recognizer

后续步骤