入门：文档智能工作室

Azure AI Document Intelligence Studio 是一种联机工具，用于直观地浏览、了解和训练文档智能服务的功能，并将其能集成到应用程序中。 若要开始使用，你可以使用示例或你自己的文档来探索预先训练过的模型。 还可以创建项目来生成自定义模板模型并引用应用程序中的模型。

先决条件

• 一份 Azure 订阅。 免费创建一个。
• Azure AI 服务或文档智能资源。 获得 Azure 订阅后，在 Azure 门户中创建单服务或 Azure AI 多服务资源以获取密钥和终结点。
• 如要试用该服务，可以使用免费定价层 (F0)。 然后可以升级到付费层进行生产。

为在文档智能工作室中使用自定义模型增加了先决条件。 有关分步指南，请参阅 Document Intelligence Studio 自定义项目。

授权策略

组织可以选择禁用本地身份验证，并对文档智能资源和 Azure Blob 存储强制实施 Microsoft Entra（以前称为 Azure Active Directory）身份验证。

• Microsoft Entra 身份验证需要禁用基于密钥的授权。 禁用密钥访问后，Microsoft Entra ID 是唯一可用的授权方法。
• Microsoft Entra 允许授予对 Azure 资源的最低特权和精细控制。

有关详细信息，请参阅以下指南：

• 为 Azure AI 服务禁用本地身份验证
• 阻止对 Azure 存储帐户进行共享密钥授权

如果对文档智能服务资源禁用本地（基于密钥的）身份验证，请确保获取“认知服务用户”角色和 Azure Active Directory 令牌，对文档智能工作室上的请求进行身份验证。 “参与者”角色仅允许列出密钥，但不会向你授予在禁用密钥访问时使用资源的权限。

指定角色分配

Document Intelligence Studio 基本访问权限需要认知服务用户角色。 有关详细信息，请参阅“文档智能角色分配”。

• 设置 Microsoft Entra ID 身份验证时，请确保具有认知服务用户角色，而不是认知服务参与者角色：

  • 认知服务用户：需要此角色才能访问文档智能或 Azure AI Foundry 资源并进入分析页面。
  • 参与者：需要此角色来创建资源组、文档智能服务或 Azure AI Foundry 资源。

• 在 Azure 背景下，参与者角色只能执行操作来控制和管理资源本身，包括列出访问密钥。

• 拥有“参与者”角色的用户帐户只能通过访问密钥进行调用，从而访问文档智能服务。 使用 Microsoft Entra ID 设置访问权限时，密钥访问被禁用，帐户需要认知服务用户角色才能使用资源。

Document Intelligence Studio 中的身份验证

前往 Document Intelligence Studio。 如果是首次登录，系统会提示你配置服务资源。 根据组织的策略，可以使用以下选项：

• Microsoft Entra 身份验证：按资源访问（推荐）

  1. 选择现有订阅。

  2. 选择订阅中的现有资源组或创建新资源组。

  3. 选择现有的文档智能或 Azure AI Foundry 资源。

     

• 本地身份验证：按 API 终结点和密钥授予访问权限

  1. 从 Azure 门户检索终结点和密钥。

  2. 转到资源的概述页，然后在左侧窗格中选择“密钥和终结点”。

  3. 在对应字段中输入值。

     

• 在 Document Intelligence Studio 中验证场景后，使用 C#、Java、JavaScript 或 Python 客户端库或 REST API 将 Document Intelligence 模型合并到你自己的应用程序中。

试用文档智能模型

若要详细了解可用的文档智能模型，请参阅文档智能模型支持。

• 配置资源后，尝试 Document Intelligence Studio 提供的不同模型。 选择任意文档智能模型以使用无代码方法。
• 测试任何文档分析或预生成的模型。 选择模型，并使用其中一个示例文档或上传自己的文档进行分析。 分析结果会出现在右侧显示内容结果代码的窗格中。
• 使用文档训练自定义模型。 有关自定义模型的概述，请参阅自定义模型概述。
• 在 Document Intelligence Studio 中验证方案。 然后使用 C#、Java、JavaScript 或 Python 客户端库或 REST API 将文档智能模型合并到自己的应用程序中。

查看资源详细信息

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

使用文档智能，可以快速自动处理应用程序和工作流中的数据，轻松增强数据驱动的策略，并娴熟地扩充文档搜索功能。

管理 Document Intelligence Studio 访问的非 Microsoft 设置

Microsoft Edge

1. 转到 Microsoft Edge 的“设置”。
2. 搜索“第三方”。
3. 转到“管理和删除 Cookie 和网站数据”。
4. 关闭“阻止第三方 Cookie”设置。

Chrome

1. 前往 Chrome 的“设置”页。
2. 搜索“第三方”。
3. 在“默认行为”下，选择“允许第三方 Cookie”。

Firefox

1. 转到 Firefox 的“设置”页。
2. 搜索“Cookie”。
3. 在“增强跟踪保护”下，选择“管理例外”。
4. 为 https://documentintelligence.ai.azure.com 或你环境的 Document Intelligence Studio URL 添加例外。

Safari

1. 选择“Safari”“首选项”>。
2. 选择“隐私”。
3. 取消选中“阻止所有 Cookie”。

故障排除

相关内容

• 了解如何在 Document Intelligence Studio 中创建自定义项目
• 文档智能客户端库入门