你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
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.core.credentials 中的 AzureKeyCredential。
使用 azure-identity 中的令牌凭据通过 Microsoft Entra ID 进行身份验证。
使用 API 密钥
以下是在 Azure 门户中查找文档智能 API 密钥的位置:
重要
我们建议使用 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 的方法:
-
dotnet add package Azure.IdentityInstall-Package Azure.Identity 通过将
Cognitive Services User角色分配给服务主体来授予文档智能访问权限。将 Microsoft Entra 应用程序中的客户端 ID、租户 ID 和客户端机密值分别设置为环境变量:
AZURE_CLIENT_ID、AZURE_TENANT_ID和AZURE_CLIENT_SECRET。创建
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。