入门：文档智能工作室

此内容适用于：v3.1 (GA) | 以前的版本： v3.0 (GA)

文档智能工作室是一种联机工具，用于在应用程序中通过文档智能服务直观地浏览、了解和集成功能。若要开始使用，你可以使用示例或你自己的文档来探索预先训练过的模型。你还可以通过 Python SDK 和其他快速入门，创建项目来生成自定义模板模型，并在应用程序中引用这些模型。

适用于新用户的先决条件

若要使用文档智能工作室，需要以下资产和设置：

提示

如果计划通过一个终结点/密钥访问多个 Azure AI 服务，请创建 Azure AI 服务资源。请创建仅供文档智能访问的文档智能资源。请注意，如果你打算使用 Microsoft Entra 身份验证，则需要单一服务资源。

文档智能现在支持在访问文档智能资源和存储帐户时进行本地（基于密钥）身份验证的 AAD 令牌身份验证。请务必按照以下说明设置正确的访问角色，尤其是在使用 DisableLocalAuth 策略应用资源时。

导航到“文档智能工作室”。如果是首次登录，将显示一个弹出窗口，提示你配置服务资源。根据组织的策略，可以使用一个或两个选项：

Microsoft Entra 身份验证：按资源授予访问权限（建议）。
- 选择现有订阅。
- 选择订阅中的现有资源组或创建新资源组。
- 选择现有的文档智能或 Azure AI 服务资源。
本地身份验证：按 API 终结点和密钥授予访问权限。
- 从 Azure 门户检索终结点和密钥。
- 转到资源的概述页，从左侧导航栏中选择“密钥和终结点”。
- 在适当的字段中输入值。
在文档智能工作室中验证方案之后，请使用 C#、Java、JavaScript 或 Python 客户端库或 REST API 开始将文档智能模型合并到自己的应用程序中。

若要详细了解每种模型，请参阅概念页面。

要查看资源详细信息（如名称和定价层），请选择文档智能工作室主页右上角的“设置”图标，然后选择“资源”选项卡。如果有权访问其他资源，也可以切换资源。

除了 Azure 帐户和文档智能或 Azure AI 服务资源外，还需要：

标准性能 Azure Blob 存储帐户。你将创建容器用于存储和组织存储帐户中的训练文档。如果不知道如何使用容器创建 Azure 存储帐户，请按照以下快速入门中的说明操作：

对于自定义项目，不同方案需要以下角色分配。

基本
- 认知服务用户：需要在文档智能或 Azure AI 服务资源中具有此角色，来训练自定义模型或使用训练的模型进行分析。
- 存储 Blob 数据参与者：需要在存储帐户中具有此角色，来创建项目和标记数据。
高级
- 存储帐户参与者：存储帐户需要此角色才能设置 CORS 设置（如果重复使用同一存储帐户，此操作是一次性的工作量）。
- 参与者：需要此角色来创建资源组和资源。
注意

如果为文档智能服务资源和存储帐户禁用了本地（基于密钥）身份验证，请务必分别获取“认知服务用户”和“存储 Blob 数据参与者”角色，以便拥有足够的权限来使用文档智能工作室。 “存储帐户参与者”和“参与者”角色仅允许列出密钥，但在禁用密钥访问的情况下，不会向你授予使用资源的权限。

需要在 Azure 存储帐户上配置 CORS（跨源资源共享），以便可以从文档智能工作室进行访问。若要在 Azure 门户中配置 CORS，需要访问存储帐户的 CORS 选项卡。

选择存储帐户的 CORS 选项卡。
首先，在 Blob 服务中创建一个新的 CORS 条目。
将“允许的源”设置为“https://formrecognizer.appliedai.azure.cn”。

提示

可以使用通配符“*”（而不是指定域）允许所有源域通过 CORS 发出请求。
为“允许的方法”选择所有可用的 8 个选项。
通过在每个字段中输入 * 来批准所有“允许的标头”和“公开的标头” 。
将“最长时间”设置为 120 秒或任何可接受的值。
若要保存更改，选择页面顶部的“保存”按钮。