连接您自己的 Microsoft Azure AI Document Intelligence 模型
- Updated: 2025/07/07
如果您的组织的安全协议或数据隐私政策要求使用您自己的 Microsoft Azure AI Document Intelligence 模型订阅,则需要将您的 Microsoft Azure AI Document Intelligence 账户与 Document Automation 连接。
先决条件
- 确保您拥有您的Control Room授权令牌。 请参阅 Authentication API (V2)。
- 确保您具备以下信息:
- Azure AI Document Intelligence 端点。 请参阅 Use Document Intelligence models。
- Azure AI Document Intelligence API 密钥。 请参阅 Use Document Intelligence models。
- Microsoft Azure Blob Storage URI。 请参阅 Blob Snapshots。注: 对于使用自带许可证 (BYOL) 的客户,确保为 Blob 存储 URI 提供读取、创建、写入、删除和列表权限,以便对模型进行训练。
- 如果您使用的是本地部署 Control Room,请确保将以下 API URL 添加到您的信任列表中:
- 将 Azure AI Document Intelligence Services API URL 添加到 Bot Runner 端的信任列表中。
- 在 Control Room 端将 SAS (blob) URI 添加到信任列表中。
- 将 Azure AI Document Intelligence Services API URL 添加到 Control Room 端的信任列表中。
- 将 https://fotts.azureedge.net/ URL(特定文档类型渲染所需)添加到 Control Room 端的信任列表中。
要使用您自己的订阅连接到 Azure AI Document Intelligence,您必须发送一个 API 请求(如本页面所述)。 请求成功后,您将在为标准表单文档类型创建学习实例时查看您的 Azure AI Document Intelligence 模型,并单击浏览以选择模型。 请参阅 Create a learning instance for standard forms。
过程
运行以下 API,连接标准表单的 Azure AI Document Intelligence 模型:
端点:
- Cloud : PUT <Cloud Host Url>/cognitive/v3/formrecognizer/config
- On-Premises : PUT <On-Premises Machine ip_address or localhost:port>/cognitive/v3/formrecognizer/config
身份验证: 标题: X-Authorization - <Document Automation admin user authentication token>
请求正文模式:application/json
{
"formRecognizerApi": "https://<Form Recognizer Endpoint (for example: https://test.api.cognitive.microsoft.com/)>",
"formRecognizerKey": "<Form Recognizer API key1 or key2 (for example: 7d3614e94...)>",
"blobStorageSas": "https://<storage account sas_url (for example: https://aa.blob.core.windows.net/.....)>"
}
参数 | 形式 | 描述 |
---|---|---|
formRecognizerApi(必填)
|
字符串 | Azure AI Document Intelligence 认知服务端点 URL。 |
formRecognizerKey(必填)
|
字符串 | Azure AI Document Intelligence 认知服务 API 密钥。 |
blobStorageSas(必填)
|
字符串 | Azure Blob Storage URI。 |
在您的请求成功提交后,您将看到状态代码为 200 OK。 然后,在使用标准表单提供程序创建学习实例时您可以选择您的 Azure AI Document Intelligence 模型。 请参阅 为标准表单创建学习实例。